Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] CMSG_ALIGN, CMSG_SPACE, CMSG_NXTHDR, CMSG_FIRSTHDR - Accès aux informations de service. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/socket.h>[/b] [b][/b] 2 [b][i]struct cmsghdr CMSG_FIRSTHDR(struct msghdr msgh );[/i][/b] [b][/b] [b][i]struct cmsghdr CMSG_NXTHDR(struct msghdr msgh , struct cmsghdr * cmsg );[/i][/b] [b][/b] [b][i]size_t CMSG_ALIGN(size_t length );[/i][/b] [b][/b] [b][i]size_t CMSG_SPACE(size_t length );[/i][/b] [b][/b] [b][i]size_t CMSG_LEN(size_t length );[/i][/b] [b][/b] [b][i]unsigned char CMSG_DATA(struct cmsghdr cmsg );[/i][/b] .nf .ta 8n 20n 32n struct cmsghdr { socklen_t cmsg_len; /* Nombre d'octets, y compris l'entête / int cmsg_level; / Protocole d'origine / int cmsg_type; / Type spécifique au protocole / / suivi de : unsigned char cmsg_data[]; / }; .ta .fi [size=18] [b]Description[/b] [/size] Ces macros servent à créer et à accéder aux messages de contrôle (informations de service - [b]ancillary data )[/b] qui ne font pas partie du trafic normal des sockets. Ces informations de contrôle peuvent inclure l'interface sur laquelle le paquet a été reçu, des champs d'entête rarement employés, des descriptions d'erreur approfondies, un ensemble de descripteurs de fichiers ou des identificateurs Unix. Par exemple, les messages de services peuvent servir à envoyer des champs d'entête supplémentaires tels que les options IP. Les données de services sont émises avec [b]sendmsg (2)[/b] et reçues avec [b]recvmsg (2).[/b] Se reporter à leurs pages de manuel respectives pour avoir plus d'informations. Une information de service est une séquence de structures [b]struct cmsghdr [/b] avec des données ajoutées. Cette séquence ne doit être manipulée qu'au moyen des macros décrites dans cette page de manuel, et jamais directement. Voir les pages spécifiques des protocoles pour les types de messages de commande disponibles. La taille maximale de buffer de service par socket est paramétré avec l'option [b]net.core.optmem_max[/b] de sysctl(). Voir [b]socket (7). [/b] [b]CMSG_FIRSTHDR [/b] renvoie un pointeur sur la première [b]cmsghdr [/b] du buffer de données de service associé avec [b] msghdr .[/b] [b]CMSG_NXTHDR [/b] renvoie la [b]cmsghdr [/b] suivante après la [b]cmsghdr[/b] transmise. Elle renvoie [b]NULL [/b] s'il n'y a plus assez de place dans le buffer. [b]CMSG_ALIGN ,[/b] renvoie la longueur transmise en argument additionnée de la taille nécessaire pour les alignements. Il s'agit d'une expression constante. [b]CMSG_SPACE[/b] renvoie le nombre d'octets occupés par un élément de service contenant la taille indiquée de données transmises. Il s'agit d'une expression constante. [b]CMSG_DATA[/b] renvoie un pointeur sur les données d'une [b]cmsghdr . [/b] [b]CMSG_LEN[/b] renvoie la valeur à stocker dans le membre [i]cmsg_len[/i] d'une structure [b]cmsghdr [/b] en tenant compte des alignements. Elle prend en argument la longueur des données. Il s'agit d'une expression constante. Pour créer des données de service, il faut tout d'abord initialiser le membre [i]msg_controllen[/i] de la structure [b]msghdr [/b] avec la longueur du buffer de message de contrôle. Utilisez [b]CMSG_FIRSTHDR [/b] sur la [b]msghdr [/b] pour obtenir le premier message de contrôle, puis [b]CMSG_NEXTHDR[/b] pour accéder aux suivants. Dans chaque meesage de contrôle, initialisez [i]cmsg_len[/i] (avec [b]CMSG_LEN ), [/b] les champs d'entête de l'autre [b]cmsghdr ,[/b] et la partie données avec [b]CMSG_DATA .[/b] Finallement, il faut remplir le membre [i]msg_controllen [/i] de la structure [b]msghdr [/b] avec la somme de [b]CMSG_SPACE [/b] appliqué à tous les messages de contrôle dans le buffer. Pour plus d'informations sur [b]msghdr ,[/b] voir [b]recvmsg (2). [/b] Lorsque le buffer de message de contrôle est trop court pour stocker tous les messages, l'attribut [b]MSG_CTRUNC [/b] est activé dans le membre [i]msg_flags [/i] de [b]msghdr .[/b] [size=18] [b]Exemple[/b] [/size] Ce code recherche l'option [b]IP_TTL [/b] dans un buffer de messages de service reçus : [table][row][col]    [/col][col] .nf .ta 8n 16n 32n struct msghdr msgh; struct cmsghdr cmsg; int ttlptr; int received_ttl; / Receive auxiliary data in msgh / for (cmsg = CMSG_FIRSTHDR(&msgh); cmsg != NULL; cmsg = CMSG_NXTHDR(&msgh,cmsg) { if (cmsg->cmsg_level == SOL_IP && cmsg->cmsg_type == IP_TTL) { ttlptr = (int ) CMSG_DATA(cmsg); received_ttl = ttlptr; break; } } if (cmsg == NULL) { / Error: IP_TTL not enabled or small buffer * or I/O error. / } .ta .fi[/col][/row][/table] Ce code passe une table de descripteurs de fichiers au travers d'une socket Unix en utilisant [b]SCM_RIGHTS :[/b] [table][row][col]    [/col][col] .nf .ta 8n 16n 32n struct msghdr msg = {0}; struct cmsghdr cmsg; int myfds[NUM_FD]; /* Contains the file descriptors to pass. / char buf[CMSG_SPACE(sizeof myfds)]; / ancillary data buffer / int fdptr; msg.msg_control = buf; msg.msg_controllen = sizeof buf; cmsg = CMSG_FIRSTHDR(&msg); cmsg->cmsg_level = SOL_SOCKET; cmsg->cmsg_type = SCM_RIGHTS; cmsg->cmsg_len = CMSG_LEN(sizeof(int) * NUM_FD); /* Initialize the payload: / fdptr = (int )CMSG_DATA(cmsg); memcpy(fdptr, myfds, NUM_FD * sizeof(int)); /* Sum of the length of all control messages in the buffer: */ msg.msg_controllen = cmsg->cmsg_len; .ta .fi[/col][/row][/table] [size=18] [b]Notes[/b] [/size] Pour des questions de portabilité, les données de services ne doivent être manipulées qu'avec les macros décrites ici. [b]CMSG_ALIGN[/b] est une extension Linux et ne doit pas être utilisé dans un programme portable. Sous Linux, [b]CMSG_LEN , [/b] [b]CMSG_DATA ,[/b] et [b]CMSG_ALIGN[/b] sont des expressions constantes (si leur argument est une constante) - on peut donc les utiliser pour déclarer la taille de variables globales. Cela peut néanmoins ne pas être portable. [size=18] [b]Conformité[/b] [/size] Le modèle des données de service est conforme à POSIX.1003.1g draft, 4.4BSD-Lite, l'API IPv6 avancée décrite dans la RFC2292 et les spécifications Single Unix v2. .B CMSG_ALIGN est une extension Linux. [size=18] [b]Voir aussi[/b] [/size] [b]sendmsg (2), [/b] [b]recvmsg (2).[/b] RFC 2292 [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 2000-2003
Fichier