CMSG

NOMBRE

SINOPSIS

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);
void *CMSG_DATA(struct cmsghdr *cmsg);

struct cmsghdr {        socklen_t   cmsg_len;   /* cantidad de bytes de datos,                                incluyendo la cabecera */        int         cmsg_level; /* protocolo originario */        int         cmsg_type;  /* tipo específico del protocolo */                                /* seguido de        unsigned char           cmsg_data[]; */};

DESCRIPCIÓN

Los datos auxiliares son una secuencia de estructurasstruct cmsghdrcon datos añadidos. Sólo se debería acceder a esta secuencia usando lasmacros descritas en esta página de manual y nunca directamente.Vea las páginas de manual específicas del protocolo para conocer los tiposde mensajes de control disponibles.El tamaño máximo permitido del buffer auxiliar por conector se puedeconfigura con la sysctlnet.core.optmem_max.Veasocket(7).

CMSG_FIRSTHDR devuelve un puntero a la primeracmsghdr en el buffer de datos auxiliares asociado con lamsghdrpasada.

CMSG_NXTHDR devuelve la siguientecmsghdr válida después de lacmsghdrpasada. DevuelveNULL cuando no queda suficiente espacio en el buffer.when there isn't enough space left in the buffer.

CMSG_ALIGN,dada una longitud, la devuelve incluyendo la alineación necesaria. Ésta esuna expresión constante.

CMSG_SPACEdevuelve la cantidad de bytes que ocupa un elemento auxiliar cuyo contenido útil es de la longitud de datos pasada. Ésta es una expresiónconstante.

CMSG_DATAdevuelve un puntero a la porción de datos de unacmsghdr.

CMSG_LENdevuelve el valor a almacenar en el miembrocmsg_lende la estructuracmsghdr teniendo en cuenta cualquier alineación necesaria. Toma como argumento lalongitud de los datos. Ésta es una expresión constante.

Para crear datos auxiliares, inicialice primero el miembromsg_controllende la estructuramsghdr con el tamaño del buffer de mensajes de control. UseCMSG_FIRSTHDR sobremsghdr para obtener el primer mensaje de control yCMSG_NEXTHDRpara obtener los siguientes.En cada mensaje de control, inicialicecmsg_len(con CMSG_LEN),los otros campos cabecera decmsghdr y la parte de datos usandoCMSG_DATA.Finalmente, debería asignar al campomsg_controllen de msghdr la suma de losCMSG_SPACE de las longitudes de todos los mensajes de control del buffer.Para más información sobremsghdr,vearecvmsg(2).

Cuando el buffer de mensajes de control es demasiado pequeño para almacenartodos los mensajes, se activa la banderaMSG_CTRUNC en el miembromsg_flags demsghdr. 

EJEMPLO

struct msghdr msgh; struct cmsghdr *cmsg;int *ttlptr;int received_ttl;/* Recibir los datos auxiliares en 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 no habilitada o buffer pequeño o         * error de E/S.         */ } 

El siguiente código pasa un vector de descriptores de ficheros mediante unconector Unix usandoSCM_RIGHTS:

struct msghdr msg = {0};struct cmsghdr *cmsg;int myfds[NUM_FD]; /* Los descriptores de fichero a pasar. */ char buf[CMSG_SPACE(sizeof myfds)];  /* buffer de datos auxiliares */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); /* Inicializar el contenido útil: */ fdptr = (int *)CMSG_DATA(cmsg); memcpy(fdptr, myfds, NUM_FD * sizeof(int)); /* Sumar la longitud de todos los mensajes de control en el buffer: */ msg.msg_controllen = cmsg->cmsg_len;

NOTAS

En Linux,CMSG_LEN,CMSG_DATAyCMSG_ALIGNson expresiones constantes (suponiendo que su argumento sea contante). Estose podría usar para declarar el tamaño de variables globales pero, sin embargo,podría no ser transportable. 

CONFORME A

VÉASE TAMBIÉN

RFC 2292

Index

NONMBRE

SINOPSIS

DESCRIPCIÓN

EJEMPLO

NOTAS

CONFORME A

VÉASE TAMBIÉN