Provided by: manpages-fr-dev_3.65d1p1-1_all bug

NOM

       CMSG_ALIGN, CMSG_SPACE, CMSG_NXTHDR, CMSG_FIRSTHDR - Accéder aux informations de service

SYNOPSIS

       #include <sys/socket.h>

       struct cmsghdr *CMSG_FIRSTHDR(struct msghdr *msgh);
       struct cmsghdr *CMSG_NXTHDR(struct msghdr *msgh, struct cmsghdr *cmsg);
       size_t CMSG_ALIGN(size_t length);
       size_t CMSG_SPACE(size_t length);
       size_t CMSG_LEN(size_t length);
       unsigned char *CMSG_DATA(struct cmsghdr *cmsg);

       struct cmsghdr {
           socklen_t cmsg_len;    /* Nombre d'octets de données, incluant l'en-tête */
           int       cmsg_level;  /* Protocole d'origine */
           int       cmsg_type;   /* Type spécifique au protocole */
           /* suivi par unsigned char cmsg_data[]; */
       };

DESCRIPTION

       Ces  macros  sont  utilisées  pour créer et accéder aux messages de contrôle (aussi appelé
       informations de service) 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'en-tête  rarement  employés,  des  descriptions  d'erreur  approfondies,  un
       ensemble  de  descripteurs  de  fichiers  ou  des  identificateurs  UNIX. Par exemple, les
       messages  de  contrôle  peuvent  être  utilisés  pour   envoyer   des   champs   d'en-tête
       supplémentaires  tels  que  des  options  IP.  Les  données  de  service  sont émises avec
       sendmsg(2) et reçues avec recvmsg(2). Reportez-vous à leur page de manuel respective  pour
       plus d'informations.

       Une  information  de  service  est  une  séquence  de  structures cmsghdr 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. Consultez les pages relatives aux protocoles des
       types de message de commande disponibles. La taille maximale d'un tampon  de  service  par
       socket peut être définie à l'aide de /proc/sys/net/core/optmem_max. Consultez socket(7).

       CMSG_FIRSTHDR()  renvoie  un  pointeur  sur  la  première  cmsghdr du tampon de données de
       service associé au msghdr passé.

       CMSG_NXTHDR() renvoie le prochain cmsghdr valable suivant après le cmsghdr transmis.  Elle
       renvoie NULL s'il n'y a plus assez de place dans le tampon.

       CMSG_ALIGN(), avec comme argument une longueur, renvoie l'alignement nécessaire. C'est une
       expression constante.

       CMSG_SPACE() renvoie le nombre d'octets d'un élément de service avec la charge utile de la
       longueur passée en paramètre. C'est une expression constante.

       CMSG_DATA() renvoie un pointeur sur une partie des données d'un cmsghdr.

       CMSG_LEN() renvoie la valeur à stocker dans le membre cmsg_len de la structure cmsghdr, en
       tenant compte des alignements. Elle prend en paramètre la longueur des données. C'est  une
       expression constante.

       Pour   créer  des  données  de  service,  il  faut  tout  d'abord  initialiser  le  membre
       msg_controllen de la structure msghdr avec la longueur du message  de  contrôle.  Utilisez
       CMSG_FIRSTHDR()  sur la structure msghdr pour obtenir le premier message de contrôle, puis
       CMSG_NXTHDR() pour obtenir les suivants. Dans  chaque  message  de  contrôle,  initialisez
       cmsg_len  (avec  CMSG_LEN()),  les  autres  champs  d'en-tête  de cmsghdr, et la partie de
       données avec CMSG_DATA(). Enfin, il faut définir le membre msg_controllen de la  structure
       msghdr  avec  la  somme  de  tous  les  messages  de  contrôle  dans le tampon renvoyé par
       CMSG_SPACE().Pour plus d'informations sur msghdr, consultez recvmsg(2).

       Lorsque le tampon de message de contrôle est trop petit pour stocker tous les messages, le
       drapeau MSG_CTRUNC du membre msg_flags de msghdr est activé.

CONFORMITÉ

       Le  modèle  des  données  de  service  est conforme à POSIX.1g draft, BSD 4.4-Lite, « IPv6
       advanced API » décrite dans la RFC 2292 et SUSv2. CMSG_ALIGN() est une extension Linux.

NOTES

       Pour des questions de portabilité, les données  de  service  ne  doivent  être  manipulées
       qu'avec  les macros décrites ici. CMSG_ALIGN() est une extension Linux et ne doit pas être
       utilisée dans un programme portable.

       Sous Linux, CMSG_LEN(), CMSG_DATA(), et CMSG_ALIGN() sont des expressions  constantes  (si
       leur  argument  est  une  constante) ;  elles peuvent donc être utilisées pour déclarer la
       taille de variables globales. Cela peut néanmoins ne pas être portable.

EXEMPLE

       Ce code recherche l'option IP_TTL dans un tampon de service reçu :

           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 == IPPROTO_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.
                */
           }

       Ce code, ci-dessous, passe une table de descripteurs de fichier au travers d'une socket de
       domaine UNIX avec SCM_RIGHTS :

           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;

VOIR AUSSI

       recvmsg(2), sendmsg(2)

       RFC 2292

COLOPHON

       Cette  page  fait partie de la publication 3.65 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe    Blaess    <http://www.blaess.fr/christophe/>   (1996-2003),   Alain   Portal
       <http://manpagesfr.free.fr/> (2003-2006). Florentin  Duneau  et  l'équipe  francophone  de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».