UNIX网络编程读书笔记：辅助数据

辅助数据（ancillary data）可通过调用sendmsg和recvmsg这两个函数，使用msghdr结构中的msg_control和msg_controllen这两个成员发送和接收。

辅助数据的另一个称谓是控制信息（control information）。

辅助数据由一个或多个辅助数据对象（ancillary data object）构成，每个对象以一个定义在头文件中的cmsghdr结构开头。

struct cmsghdr {

socketlen_t cmsg_len; /* length in bytes, including this structure */

int cmsg_level; /* originating protocol */

int cmsg_type; /* protocol-specific type */

/* followed by unsigned char msg_data[] */

};

由msg_control指向的辅助数据必须为各个cmsghdr结构适当地对齐，如下所示为一种对齐方法：

union {

struct cmsghdr cm;

char control[CMSG_SPACE(sizeof(int))];

}control_un;

如下图所示，展示了在一个控制缓冲区中出现2个辅助数据对象的一个例子：

msg_control指向第一个辅助数据对象，辅助数据的总长度则由msg_controllen指定。每个对象开头都是一个描述该对象的cmsghdr结构。在cmsg_type成员和实际数据之间可以有填充字节，从数据结尾处到下一个辅助数据对象之前也可以有填充字节。

注意，不是所有实现都支持在单个控制缓冲区中存放多个辅助数据对象。

如下图所示，展示了通过一个UNIX域套接口传递描述字或传递凭证时所用的cmsghdr结构的格式。

既然由recvmsg返回的辅助数据可含有任意数目的辅助数据对象，为了对应用程序屏蔽可能出现的填充字节，头文件中定义了以下5个宏，以简化对辅助数据的处理。

#include

#include /* for ALIGN macro on many implementations */

struct cmsghdr *CMSG_FIRSTHDR(struct msghdr *mhdrptr);

返回：指向第一个cmsghdr结构的指针，无辅助数据时为NULL

struct cmsghdr *CMSG_NXTHDR(struct msghdr *mhdrptr, struct cmsghdr *cmsgptr);

返回：指向下一个cmsghdr结构的指针，不再有辅助数据对象时为NULL

unsigned char *CMSG_DATA(struct cmsghdr *cmsgptr);

返回：指向与cmsghdr结构关联的数据的第一个字节的指针

unsigned int CMSG_LEN(unsigned int length);

返回：给定数据量下存放到cmsg_len中的值

unsigned int CMSG_SPACE(unsigned int length);

返回：给定数据量下一个辅助数据对象总的大小

这些宏可以按照如下伪代码形式使用：

struct msghdr msg;

struct cmsghdr *cmsgptr;

/* fill in msg structure */

/* call recvmsg() */

for(cmsgptr = CMSG_FIRSTHDR(&msg); cmsgptr != NULL; cmsgptr = CMSG_NXTHDR(&msg, cmsgptr))

{

if(cmsgptr->cmsg_level == ... && cmsgptr->cmsg_type == ...)

{

u_char *ptr;

ptr = CMSG_DATA(cmsgptr);

/* process data pointed to by ptr */

}

}

CMSG_FIRSTHDR返回指向第一个辅助数据对象的指针，然而如果在msghdr结构中没有辅助数据（或者msg_control为一个空指针，或者cmsg_len小于一个cmsghdr结构的大小），那就返回一个空指针。当控制缓冲区中不再有下一个辅助数据对象时，CMSG_NXTHDR也返回一个空指针。

CMSG_LEN和CMSG_SPACE的区别在于，前者不计辅助数据对象中数据部分之后可能的填充字节，因而返回的是用于存放在cmsg_len成员中的值，后者计上结尾处可能的填充字节，因而返回的是用于为辅助对象动态分配空间的大小值。