struct msghdr和struct cmsghdr【转载】

理解struct msghdr
当我第一次看到他时，他看上去彷佛是一个须要建立的巨大的结构。可是不要怕。其结构定义以下：
struct msghdr {
    void         *msg_name;
    socklen_t    msg_namelen;
    struct iovec *msg_iov;
    size_t       msg_iovlen;
    void         *msg_control;
    size_t       msg_controllen;
    int          msg_flags;
};
结构成员能够分为四组。他们是：
套接口地址成员msg_name与msg_namelen。
I/O向量引用msg_iov与msg_iovlen。
附属数据缓冲区成员msg_control与msg_controllen。
接收信息标记位msg_flags。
在咱们将这个结构分为上面的几类之后，结构看起来就不那样巨大了。
成员msg_name与msg_namelen
这些成员只有当咱们的套接口是一个数据报套接口时才须要。msg_name成员指向咱们要发送或是接收信息的套接口地址。成员msg_namelen指明了这个套接口地址的长度。
当调用recvmsg时，msg_name会指向一个将要接收的地址的接收区域。当调用sendmsg时，这会指向一个数据报将要发送到的目的地址。
注意，msg_name定义为一个(void *)数据类型。咱们并不须要将咱们的套接口地址转换为(struct sockaddr *)。
成员msg_iov与msg_iovlen
这些成员指定了咱们的I/O向量数组的位置以及他包含多少项。msg_iov成员指向一个struct iovec数组。咱们将会回忆起I/O向量指向咱们的缓冲区。成员msg_iov指明了在咱们的I/O向量数组中有多少元素。
成员msg_control与msg_controllen
这些成员指向了咱们附属数据缓冲区而且代表了缓冲区大小。msg_control指向附属数据缓冲区，而msg_controllen指明了缓冲区大小。
成员msg_flags
当使用recvmsg时，这个成员用于接收特定的标记位(他并不用于sendmsg)。在这个位置能够接收的标记位以下表所示：
标记位        描述
MSG_EOR        当接收到记录结尾时会设置这一位。这一般对于SOCK_SEQPACKET套接口类型十分有用。
MSG_TRUNC    这个标记位代表数据的结尾被截短，由于接收缓冲区过小不足以接收所有的数据。
MSG_CTRUNC    这个标记位代表某些控制数据(附属数据)被截短，由于缓冲区过小。
MSG_OOB        这个标记位代表接收了带外数据。
MSG_ERRQUEUE    这个标记位代表没有接收到数据，可是返回一个扩展错误。
咱们能够在recvmsg(2)与sendmsg(2)的man手册页中查看更多的信息。
附属数据结构与宏
recvmsg与sendmsg函数容许程序发送或是接收附属数据。然而，这些额外的信息受限于必定的格式规则。这一节将会介绍控制信息头与程序将会用来管理这些信息的宏。
简介struct cmsghdr结构
附
属信息能够包括0，1，或是更多的单独附属数据对象。在每个对象以前都有一个struct
cmsghdr结构。头部以后是填充字节，而后是对象自己。最后，附属数据对象以后，下一个cmsghdr以前也许要有更多的填充字节。在这一章，咱们将
要关注的附属数据对象是文件描述符与证书结构。
下图显示了一个包含附属数据的缓冲区是如何组织的。
咱们须要注意如下几点：
cmsg_len与CMSG_LEN()宏值所显示的长度相同。
CMSG_SPACE()宏能够计算一个附属数据对象的所必需的空白。
msg_controllen是CMSG_SPACE()长度以后，而且为每个附属数据对象进行计算。
控制信息头部自己由下面的C结构定义：
struct cmsghdr {
    socklen_t cmsg_len;
    int       cmsg_level;
    int       cmsg_type;
/* u_char     cmsg_data[]; */
};
其成员描述以下：
成员        描述
cmsg_len    附属数据的字节计数，这包含结构头的尺寸。这个值是由CMSG_LEN()宏计算的。
cmsg_level    这个值代表了原始的协议级别(例如，SOL_SOCKET)。
cmsg_type    这个值代表了控制信息类型(例如，SCM_RIGHTS)。
cmsg_data    这个成员并不实际存在。他用来指明实际的额外附属数据所在的位置。
这一章所用的例子程序只使用SOL_SOCKET的cmsg_level值。这一章咱们感兴趣的控制信息类型以下(cmsg_level=SOL_SOCKET)：
cmsg_level        描述
SCM_RIGHTS        附属数据对象是一个文件描述符
SCM_CREDENTIALS        附属数据对象是一个包含证书信息的结构
简介cmsg(3)宏
因为附属数据结构的复杂性，Linux系统提供了一系列的C宏来简化咱们的工做。另外，这些宏能够在不一样的UNIX平台之间进行移植，而且采起了一些措施来防止未来的改变。这些宏是由cmsg(3)的man手册页来进行描述的，其概要以下：
#include 
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);
CMSG_LEN()宏
这个宏接受咱们但愿放置在附属数据缓冲区中的对象尺寸做为输入参数。若是咱们回顾一个咱们前面的介绍，咱们就会发现这个宏会计算cmsghdr头结构加上所须要的填充字符的字节长度。这个值用来设置cmsghdr对象的cmsg_len成员。
下面的例子演示了若是附属数据是一个文件描述符，咱们应如何来计算cmsg_len成员的值：
int fd;   /* File descriptor */
printf("cmsg_len = %d/n",CMSG_LEN(sizeof fd));
CMSG_SPACE()宏
这个宏用来计算附属数据以及其头部所需的总空白。尽管CMSG_LEN()宏计算了一个类似的长度，CMSG_LEN()值并不包括可能的结尾的填充字符。CMSG_SPACE()宏对于肯定所需的缓冲区尺寸是十分有用的，以下面的示例代码所示：
int fd; /* File Descriptor */
char abuf[CMSG_SPACE(sizeof fd)];
这个例子在abuf[]中声明了足够的缓冲区空间来存放头部，填充字节以及附属数据自己，和最后的填充字节。若是在缓冲区中有多个附属数据对象，必定要同时添加多个CMSG_SPACE()宏调用来获得所需的总空间。
CMSG_DATA()宏
这个宏接受一个指向cmsghdr结构的指针。返回的指针值指向跟随在头部以及填充字节以后的附属数据的第一个字节(若是存在)。若是指针mptr指向一个描述文件描述符的可用的附属数据信息头部，这个文件描述符能够用下面的代码来获得：
struct cmsgptr *mptr;
int fd; /* File Descriptor */
. . .
fd = *(int *)CMSG_DATA(mptr);
CMSG_ALIGN()宏
这是一个Linux扩展宏，而不是Posix.1g标准的一部分。指定一个字节长度做为输入，这个宏会计算一个新的长度，这个新长度包括为了维护对齐所须要的额外的填充字节。
CMSG_FIRSTHDR()宏
这
个宏用于返回一个指向附属数据缓冲区内的第一个附属对象的struct cmsghdr指针。输入值为是指向struct
msghdr结构的指针(不要与struct
cmsghdr相混淆)。这个宏会估计msghdr的成员msg_control与msg_controllen来肯定在缓冲区中是否存在附属对象。然
后，他会计算返回的指针。
若是不存在附属数据对象则返回的指针值为NULL。不然，这个指针会指向存在的第一个struct cmsghdr。这个宏用在一个for循环的开始处，来开始在附属数据对象中遍历。
CMSG_NXTHDR()宏
这个用于返回下一个附属数据对象的struct cmsghdr指针。这个宏会接受两个输入参数：
指向struct msghdr结构的指针
指向当前struct cmsghdr的指针
若是没有下一个附属数据对象，这个宏就会返回NULL。
遍历附属数据
当接收到一个附属数据时，咱们可使用CMSG_FIRSTHDR()与CMSG_NXTHDR()宏来在附属数据对象中进行遍历。下面的示例代码显示了for循环的一般格式以及宏的相应用法：
struct msghdr msgh;     /* Message Hdr */
struct cmsghdr *cmsg;0   /*Ptr to ancillary hdr */
int *fd_ptr;            /* Ptr to file descript.*/
int received_fd;        /* The file descriptor */
for ( cmsg=CMSG_FIRSTHDR(&msgh); cmsg!=NULL; cmsg=CMSG_NXTHDR(&msgh,cmsg) ) {
    if ( cmsg->cmsg_level == SOL_SOCKET && cmsg->cmsg_type == SCM_RIGHTS ) {
        fd_ptr = (int *) CMSG_DATA(cmsg);
        received_fd = *fd_ptr;
        break;
    }
}
if ( cmsg == NULL ) {
    /* Error: No file descriptor recv'd */
}
建立附属数据
要发送一个文件描述符的进程必须使用正确的格式化数据来建立一个附属数据缓冲区。下面的代码展现的一般的建立过程：
struct msghdr msg;            /* Message header */
struct cmsghdr *cmsg; /* Ptr to ancillary hdr */
int fd;              /* File descriptor to send */
char buf[CMSG_SPACE(sizeof fd)]; /* Anc. buf */
int *fd_ptr;           /* Ptr to file descriptor */
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 fd);
/* Initialize the payload: */
fd_ptr = (int *)CMSG_DATA(cmsg);
*fd_ptr = fd;
/*
* Sum of the length of all control
* messages in the buffer:
*/
msg.msg_controllen = cmsg->cmsg_len;