Scroll to navigation

if_nametoindex(3) Library Functions Manual if_nametoindex(3)

NOM

if_nametoindex, if_indextoname - Correspondance entre noms d'interfaces réseau et indices

BIBLIOTHÈQUE

Bibliothèque C standard (libc, -lc)

SYNOPSIS

#include <net/if.h>
unsigned int if_nametoindex(const char *ifname);
char *if_indextoname(unsigned int ifindex, char *ifname);

DESCRIPTION

La fonction if_nametoindex() renvoie l'indice de l'interface réseau correspondant au nom nom_if.

La fonction if_indextoname() renvoie le nom de l'interface réseau correspondant à l'indice d'interface indice_if. Le nom est placé dans le tampon sur lequel pointe nom_if. Le tampon doit autoriser le stockage d'au moins IF_NAMESIZE octets.

VALEUR RENVOYÉE

En cas de réussite, if_nametoindex() renvoie l'indice de l'interface réseau. En cas d'erreur, elle renvoie 0 et errno est défini pour indiquer l'erreur.

En cas de réussite, if_indextoname() renvoie nom_if. En cas d'erreur, elle renvoie un pointeur NULL et errno est défini pour indiquer l'erreur.

ERREURS

if_nametoindex() peut échouer et remplir errno si :

aucune interface n'est trouvée pour le donné.

if_indextoname() peut échouer et remplir errno si :

aucune interface n'est trouvée pour l'indice.

if_nametoindex() et if_indextoname() peuvent aussi échouer pour une des erreurs précisées pour socket(2) ou ioctl(2).

ATTRIBUTS

Pour une explication des termes utilisés dans cette section, consulter attributes(7).

Interface Attribut Valeur
if_nametoindex(), if_indextoname() Sécurité des threads MT-Safe

STANDARDS

POSIX.1-2008, RFC 3493.

HISTORIQUE

POSIX.1-2001, BSDi.

VOIR AUSSI

getifaddrs(3), if_nameindex(3), ifconfig(8)

TRADUCTION

La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org>, Cédric Boutillier <cedric.boutillier@gmail.com> et Frédéric Hantrais <fhantrais@gmail.com>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.

2 mai 2024 Pages du manuel de Linux 6.8