Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] netlink, PF_NETLINK - Communication entre noyau et utilisateur. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <asm/types.h>[/b] [b][/b] [b]#include <sys/socket.h>[/b] [b][/b] [b]#include <linux/netlink.h> [/b] [b][/b] [b][i]netlink_socket = socket(PF_NETLINK, socket_type , netlink_family ); [/i][/b] [size=18] [b]Description[/b] [/size] Netlink sert à transférer des informations entre les modules du noyau et les processus de l'espace utilisateur. Il consiste en une interface basée sur les sockets standards pour les processus utilisateur et d'une API interne pour les modules du noyau. Cette interface n'est pas documentée dans cette page de manuel. Il existe aussi une interface obsolète via un périphérique caractère netlink, réservée pour compatibilité et non documentée ici. Netlink est un service orienté datagramme. Les deux types [b]SOCK_RAW [/b] et [b]SOCK_DGRAM[/b] sont des valeurs possibles pour [b]socket_type ;[/b] toutefois, le protocole netlink ne distingue pas les sockets raw et datagrammes. [i]netlink_family[/i] sélectionne le module du noyau ou le groupe netlink avec qui communiquer. Les familles netlink actuellement affectée sont : [b]NETLINK_ROUTE[/b] [table][row][col]    [/col][col]Reçoit les modifications de routage et peut être utilisé pour mettre à jour les tables de routage IPv4 (voir [b]rtnetlink (7)).[/b][/col][/row][/table] [b]NETLINK_FIREWALL [/b] [table][row][col]    [/col][col]Reçoit les paquets envoyés par le code du firewall IPv4.[/col][/row][/table] [b]NETLINK_ARPD[/b] [table][row][col]    [/col][col]Pour gérer la table Arp dans l'espace utilisateur.[/col][/row][/table] [b]NETLINK_ROUTE6[/b] [table][row][col]    [/col][col]Reçoit et envoie les mise à jour de la table de routage IPv6.[/col][/row][/table] [b]NETLINK_IP6_FW[/b] [table][row][col]    [/col][col]Pour recevoir les paquets rejetés par le firewall IPv6 (pas encore implémenté).[/col][/row][/table] [b]NETLINK_TAPBASE ... NETLINK_TAPBASE+15[/b] [table][row][col]    [/col][col]sont les instances du périphérique [b]ethertap .[/b] Ce périphérique est un tunnel pour pseudo-réseau qui permet de simuler un pilote Ethernet depuis l'espace utilisateur.[/col][/row][/table] [b]NETLINK_SKIP[/b] [table][row][col]    [/col][col]Réservé pour ENskip.[/col][/row][/table] [b]NETLINK_USERSOCK[/b] [table][row][col]    [/col][col]Réservé pour les futurs protocoles dans l'espace utilisateur.[/col][/row][/table] Les messages netlink consistent en un flux d'octets avec un ou plusieurs en-têtes [b]nlmsghdr[/b] et les contenus associés. Pour les messages multi-parties, tous les en-têtes ont l'attribut [b]NLM_F_MULTI[/b] actif, sauf le dernier en-tête qui a le type [b]NLMSG_DONE .[/b] Le flux d'octets ne doit être accédé qu'à travers les macros standards [b]NLMSG_[/b] voir [b]netlink (3). [/b] Netlink n'est pas un protocole fiable. Il fait de son mieux pour conduire les messages à destination, mais peut abandonner des messages s'il n'a pas assez de mémoire ou si une erreur se produit. Pour un transfert fiable, l'émetteur peut demander un acquittement du récepteur en activant l'attribut [b]NLM_F_ACK .[/b] Un acquittement est un paquet [b]NLMSG_ERROR [/b] avec le champ erreur à zéro. L'application doit envoyer des acquittements pour les messages eux-même. Le noyau essaye d'envoyer un message [b]NLMSG_ERROR[/b] pour chaque paquet échoué. Le processus utilisateur devrait suivre aussi cette convention. Chaque famille netlink a un ensemble de 32 groupes multicast. Quand on appelle [b]bind (2)[/b] sur la socket, le champ [b]nl_groups[/b] de la structure [b]sockaddr_nl[/b] doit contenir un masque de bits des groupes que l'on désire écouter. La valeur par défaut pour ce champ est zéro, ce qui signifie qu'aucun groupe multicast ne sera reçu. Une socket peut envoyer un message sur n'importe quel groupe multicast en remplissant le champ [b]nl_groups[/b] avec un masque de bit des groupes visés, lors de l'appel [b]sendmsg (2) [/b] ou lors du [b]connect (2).[/b] Seul les processus avec un UID effectif nul ou la capacité [b]CAP_NET_ADMIN[/b] peuvent envoyer ou recevoir sur un groupe multicast netlink. Toute réponse pour un message reçu sur un groupe multicast doit être renvoyée au PID émetteur et au groupe multicast. [table][row][col]    [/col][col] .nf .ta 4 13 25 struct nlmsghdr { __u32 nlmsg_len; / Longueur y compris en-tête / __u16 nlmsg_type; / Contenu message / __u16 nlmsg_flags; / Attributs supplémentaires / __u32 nlmsg_seq; / Numéro de séquence / __u32 nlmsg_pid; / PID du créateur socket / }; struct nlmsgerr { int error; / errno négatif ou 0 pour acquit. / struct nlmsghdr msg; / en-tête message causant l'erreur / }; .ta .fi[/col][/row][/table] Après chaque [b]nlmsghdr[/b] le contenu du message suit. [b]nlmsg_type[/b] peut être l'un des types standards de message : [b]NLMSG_NOOP[/b] message à ignorer, [b]NLMSG_ERROR[/b] message indiquant une erreur, son contenu est une structure [b]nlmsgerr ,[/b] [b]NLMSG_DONE[/b] message final d'un ensemble multiparties. Une famille netlink contient des types supplémentaires de message, voir la page de manuel apprpriée, par exemple [b]rtnetlink (7)[/b] pour [b]NETLINK_ROUTE .[/b] .TS tab(:); l s l l. Attribut standards dans nlmsg_flags NLM_F_REQUEST:pour toutes les requêtes NLM_F_MULTI:T{ le message est multi-parties, temrinée par [b][/b] NLMSG_DONE T} NLM_F_ACK:envoyer un acquittement de réussite NLM_F_ECHO:renvoyer cette requête .TE .TS tab(:); l s l l. Attributs supplémentaires pour requêtes GET NLM_F_ROOT:Renvoyer toute la table plutôt qu'une seule entrée. NLM_F_MATCH:Pas encore implémenté. NLM_F_ATOMIC:Renvoyer une image instantanée de la table. NLM_F_DUMP:Pas encore documenté. .TE .TS tab(:); l s l l. Attributs supplémentaires pour requêtes NEW NLM_F_REPLACE:Ecraser l'objet existant. NLM_F_EXCL:Ne pas remplacer l'objet s'il existe déjà. NLM_F_CREATE:Créer un objet s'il n'existe pas. NLM_F_APPEND:Ajouter à la fin de la liste d'objets. .TE Notez que NLM_F_ATOMIC nécessite la capacité CAP_NET_ADMIN ou les droits root. [size=18] [b]Format dadresse[/b] [/size] La structure [b]sockaddr_nl[/b] décrit un client netlink dans l'espace utilisateur ou dans le noyau. une sockaddr_nl peut être soit unicast (un seul destinataire) ou décrire un groupe netlink (nl_groups différent de 0). [table][row][col]    [/col][col] .nf struct sockaddr_nl { sa_family_t nl_family; / AF_NETLINK / unsigned short nl_pad; / zéro / pid_t nl_pid; / PID / __u32 nl_groups; / masque groupes multicast / }; .fi[/col][/row][/table] [b]nl_pid[/b] est le PID du processus propriétaire de la socket de destination ou zéro si la destination est dans le noyau. [b]nl_groups [/b] est un masque de bits représentant les groupes netlink. [size=18] [b]Bugs[/b] [/size] Cette page de manuel n'est pas complète. [size=18] [b]Notes[/b] [/size] Il est souvent plus facile d'utiliser netlink à travers la bibliothèque [b]libnetlink[/b] que vial l'interface bas-niveau du noyau. [size=18] [b]Versions[/b] [/size] L'interface par socket de netlink est une nouveauté dans Linux 2.2. Linux 2.0 supporte une interface plus primitive, basée sur un périphérique caractère (toujours valable pour compatibilité). Cette interface obsolète n'est pas décrite ici. [size=18] [b]Voir aussi[/b] [/size] [b]cmsg (3),[/b] [b]rtnetlink (7),[/b] [b]netlink (3)[/b] ftp://ftp.inr.ac.ru/ip-routing/iproute2 pour libnetlink [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 2003.
Fichier