Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] netdevice - Accès bas-niveau aux périphériques réseau sous Linux. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/ioctl.h>[/b] [b]#include <net/if.h>[/b] [size=18] [b]Description[/b] [/size] Cette page de manuel décrit l'interface des socket permettant de configurer les périphériques réseau. Linux support des ioctls standard pour configurer les périphériques réseau. Il servent sur n'importe quel descripteur de socket, quelqu'en soit la famille ou le type. Ils utilisent une structure [b]ifreq :[/b] .nf .ta 4 12 20 struct ifreq { char ifr_name[IFNAMSIZ]; /* nom interface / union { struct sockaddr ifr_addr; struct sockaddr ifr_dstaddr; struct sockaddr ifr_broadaddr; struct sockaddr ifr_netmask; struct sockaddr ifr_hwaddr; short ifr_flags; int ifr_ifindex; int ifr_metric; int ifr_mtu; struct ifmap ifr_map; char ifr_slave[IFNAMSIZ]; char ifr_newname[IFNAMSIZ]; char ifr_data; }; }; struct ifconf { int ifc_len; /* taille buffer / union { char ifc_buf; /* adresse buffer / struct ifreq ifc_req; /* table de structures / }; }; .ta .fi Normalement, l'utilisateur indique le périphérique concerné en remplissant [b]ifr_name[/b] avec le nom de l'interface. Tous les autres membres de la structure peuvent partager la mémoire. [size=18] [b]Ioctls[/b] [/size] Si un ioctl est indiqué comme privilégié, alors il nécessite un UID effectif nul ou la capacité. [b]CAP_NET_ADMIN[/b] Sinon, il renverra l'erreur [b]EPERM .[/b] [b]SIOCGIFNAME[/b] [table][row][col]    [/col][col]En utilisant [b]ifr_ifindex ,[/b] renvoie le nom de l'interface dans [b]ifr_name .[/b] C'est le seul ioctl qui renvoie un résultant dans [b]ifr_name .[/b] [/col][/row][/table] [b]SIOCGIFINDEX[/b] [table][row][col]    [/col][col]Retrouve le numéro d'interface et le place dans [b]ifr_ifindex .[/b] [/col][/row][/table] [b]SIOCGIFFLAGS , SIOCSIFFLAGS[/b] [table][row][col]    [/col][col]Lire ou écrire les attributs actifs du périphérique. [b]ifr_flags[/b] est un mot contenant un masque de bits combinant les valeurs suivantes : .TS tab(:); c s l l. Device flags IFF_UP:Interface fonctionne. IFF_BROADCAST:Adresse de broadcast valide. IFF_DEBUG:Attribut interne de débogage. IFF_LOOPBACK:Interface de type loopback. IFF_POINTOPOINT:Interface de type point-à-point. IFF_RUNNING:Resources allouées. IFF_NOARP:Pas de protocole Arp, adresse de destination L2 absente. IFF_PROMISC:Interface en mode promiscuous. IFF_NOTRAILERS:N'utilise pas les postambules. IFF_ALLMULTI:Accepte tous les paquets multicast. IFF_MASTER:Maître d'un système de répartition de charge. IFF_SLAVE:Esclave d'un système de répartition de charge. IFF_MULTICAST:Support multicast. IFF_PORTSEL:Capable de sélectionner le média via ifmap. IFF_AUTOMEDIA:Sélection automatique du média. IFF_DYNAMIC:T{ Adresse perdue quand l'interfac est arrêtée. T} .TE Écrire les attributs est une opération privilégiée, mais tout processus peut les lire.[/col][/row][/table] [b]SIOCGIFMETRIC , SIOCSIFMETRIC[/b] [table][row][col]    [/col][col]Lire ou écrire la métrique du périphérique en utilisant [b]ifr_metric .[/b] Ceci n'est pas encore implémenté, il renvoie dans [b]ifr_metric[/b] la valeur 0 si on essaye de lire, et renvoie l'erreur [b]EOPNOTSUPP[/b] si on essaye d'écrire.[/col][/row][/table] [b]SIOCGIFMTU , SIOCSIFMTU[/b] [table][row][col]    [/col][col]Lire ou écrire le MTU (Maximum Transfer Unit) du périphérique avec [b]ifr_mtu .[/b] Fixer le MTU est une opération privilégiée. Fixer un MTU trop petit peut faire planter le noyau.[/col][/row][/table] [b]SIOCGIFHWADDR , SIOCSIFHWADDR[/b] [table][row][col]    [/col][col]Lire ou écrire l'adresse matérielle du périphérique en utilisant [b]ifr_hwaddr .[/b] Cette adresse matérielle est indiquée dans une structure [b]sockaddr .[/b] [i]sa_family [/i] contien le type de périphérique ARPHRD_, [i]sa_data[/i] est l'adresse matérielle L2 commençant par l'octet 0. Écrire l'adresse matérielle est une opération privilégiée.[/col][/row][/table] [b]SIOCSIFHWBROADCAST[/b] [table][row][col]    [/col][col]Fixer l'adresse de broadcast du périphérique à partir de [b]ifr_hwaddr .[/b] C'est une opération privilégiée.[/col][/row][/table] [b]SIOCGIFMAP , SIOCSIFMAP[/b] [table][row][col]    [/col][col]Lire ou écrire les paramètres matériels de l'interface en utilisant [b]ifr_map .[/b] L'écriture des paramètres est une opération privilégiée. .nf .ta 4 20 42 struct ifmap { unsigned long mem_start; unsigned long mem_end; unsigned short base_addr; unsigned char irq; unsigned char dma; unsigned char port; }; .ta .fi L'interprétation de la structure ifmap dépend du pilote de périphérique et de l'architecture.[/col][/row][/table] [b]SIOCADDMULTI , SIOCDELMULTI[/b] [table][row][col]    [/col][col]Ajouter ou supprimer une adresse des filtres multicast du niveau liaison du périphérique en utilisant [b]ifr_hwaddr .[/b] Ce sont des opérations privilégiées. Voir aussi [b]packet (7)[/b] pour une autre possibilité.[/col][/row][/table] [b]SIOCGIFTXQLEN , SIOCSIFTXQLEN[/b] [table][row][col]    [/col][col]Lire ou écrire la taille de la file d'émission du périphérique avec [b]ifr_qlen .[/b] L'Écriture de la taille de la file est une opértation privilégiée.[/col][/row][/table] [b]SIOCSIFNAME[/b] [table][row][col]    [/col][col]Changer le nom de l'interface indiquée dans [b]ifr_name[/b] pour [b]ifr_newname .[/b] C'est une opération privilégiée. Elle n'est possible que si l'interface n'est pas en fonctionnement.[/col][/row][/table] [b]SIOCGIFCONF[/b] [table][row][col]    [/col][col]Renvoie une liste des adresses (couche de transport) des interfaces. Ceci ne marche actuellement qu'avec les adresses AF_INET (IPv4) pour des raisons de compatibilité. L'utilisateur passe une structure [b]ifconf[/b] en argument à l'ioctl. Elle contient un pointeur sur une table de structures [i]ifreq[/i] dans son membre [b]ifc_req[/b] et la longueur en octets dans [b]ifc_len.[/b] Le noyau remplit les ifreqs avec toutes les adresses L3 des interfaces en fonctionnement : [i]ifr_name [/i] contient le nom de l'interfacez (eth0:1 etc.), et [i]ifr_addr[/i] l'adresse. Le noyau renvoie la longueur réelle dans [b]ifc_len .[/b] Si [i]ifc_len[/i] est égal à la longueur originale du buffer, on a probablement atteint la limite, et il est conseillé de recommencer avec un buffer plus grand. S'il réussit, l'ioctl renvoie 0, sinon il renvoie -1. Atteindre la limite du buffer n'est pas considéré comme une erreur. " XXX Slaving isn't supported in 2.2[/col][/row][/table] La plupart des protocoles supportent leurs propres ioctls pour configurer les options d'interface spécifiques aux protocoles. Voir les pages de manuel correspondante. Pour configurer les adresses IP, voir [b]ip (7).[/b] De plus, certains périphériques supportent des ioctls privés, non décrits ici. [size=18] [b]Notes[/b] [/size] Strictement parlant, [b]SIOCGIFCONF [/b] est spécifique à IP et devrait se trouver dans [b]ip (7).[/b]     Les noms des interfaces sans adresses, ou celles qui n'ont pas l'attribut [b]IFF_RUNNING [/b] peuvent être trouvés dans [b]/proc/net/dev .[/b]     Les adresses IPv6 locales se trouvent dans /proc/net ou grâce à [b]rtnetlink (7).[/b] [size=18] [b]Bugs[/b] [/size] Dans la GlibC 2.1 il manque la maco [i]ifr_newname [/i] dans net/if.h. Ajoutez les lignes suivantes dans votre programme : [table][row][col]    [/col][col] .nf .ta 4 20 42 #ifndef ifr_newname #define ifr_newname ifr_ifru.ifru_slave #endif .ta .fi[/col][/row][/table] [size=18] [b]Voir aussi[/b] [/size] [b]ip (7),[/b] [b]proc (7),[/b] [b]rtnetlink (7)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 2003.
Fichier