计算机网络 / 知识点

Socket API 常用调用速查

数据收发

CODE
int sendmmsg(int sockfd, struct mmsghdr *msgvec, unsigned int vlen, int flags);

Linux 扩展接口,可一次提交多个消息以减少系统调用次数;主要用于高吞吐 UDP 或报文批处理场景,不属于基础 POSIX API。

sendmmsg 批量发送消息

需要在 Linux 上一次提交多个独立报文、减少高吞吐 UDP 场景中的系统调用次数时查这个接口。它把多组 msghdr 放进 mmsghdr 数组,一次调用后可直接读取每个已发送消息的长度。

签名

c
int sendmmsg(int sockfd, struct mmsghdr *msgvec, unsigned int vlen, int flags);

在 glibc 环境通常应在包含 <sys/socket.h> 前定义 _GNU_SOURCE,以暴露该 Linux 扩展接口。

参数 类型 含义 约束
sockfd int 已创建的套接字描述符 UDP 常用;也可用于支持 sendmsg 语义的套接字
msgvec struct mmsghdr * 待发送消息数组 每项的 msg_hdr 描述地址、缓冲区和控制消息;msg_len 由内核写回
vlen unsigned int 数组中的消息数 必须与可访问的数组元素数量一致
flags int 发送标志 语义与 sendmsg 的 flags 一致,可为 0

返回与错误

成功时返回本次实际发送的消息个数,范围为 1..vlen;返回值小于 vlen 表示只提交了前一部分消息。每个已发送元素的 msg_len 会记录该消息发送的字节数。

如果一个消息都没有发送成功,返回 -1 并设置 errno。若已经发送部分消息后才遇到错误,调用可能直接返回已发送数量,因此此时不要把 errno 当作该批次剩余消息的可靠错误结果;应从返回下标继续重试或按业务策略处理。

完整示例

下面使用两个 UDP 套接字在回环地址上验证一次发送两条消息。

c
#define _GNU_SOURCE
#include <arpa/inet.h>
#include <stdio.h>
#include <string.h>
#include <sys/socket.h>
#include <unistd.h>

int main(void) {
    int rx = socket(AF_INET, SOCK_DGRAM, 0);
    int tx = socket(AF_INET, SOCK_DGRAM, 0);
    if (rx < 0 || tx < 0) return 1;

    struct sockaddr_in addr = {
        .sin_family = AF_INET,
        .sin_addr.s_addr = htonl(INADDR_LOOPBACK),
        .sin_port = 0
    };
    if (bind(rx, (struct sockaddr *)&addr, sizeof(addr)) < 0) return 1;

    socklen_t addrlen = sizeof(addr);
    if (getsockname(rx, (struct sockaddr *)&addr, &addrlen) < 0) return 1;

    char a[] = "alpha";
    char b[] = "beta";
    struct iovec iov[2] = {
        { .iov_base = a, .iov_len = strlen(a) },
        { .iov_base = b, .iov_len = strlen(b) }
    };
    struct mmsghdr msgs[2] = {0};

    for (int i = 0; i < 2; i++) {
        msgs[i].msg_hdr.msg_name = &addr;
        msgs[i].msg_hdr.msg_namelen = sizeof(addr);
        msgs[i].msg_hdr.msg_iov = &iov[i];
        msgs[i].msg_hdr.msg_iovlen = 1;
    }

    int n = sendmmsg(tx, msgs, 2, 0);
    if (n < 0) return 1;

    char buf[16];
    for (int i = 0; i < n; i++) {
        ssize_t r = recv(rx, buf, sizeof(buf) - 1, 0);
        if (r < 0) return 1;
        buf[r] = '\0';
        printf("%d:%s:%u\n", i, buf, msgs[i].msg_len);
    }

    close(tx);
    close(rx);
    return 0;
}

预期输出:

text
0:alpha:5
1:beta:4

边界与兼容性

sendmmsg 是 Linux 扩展,不属于基础 POSIX Socket API;跨平台代码应准备循环调用 sendmsg 的替代路径。它减少的是系统调用次数,不会把多条 UDP 消息合并成一个数据报;每个 mmsghdr 仍表示一条独立消息。

I/O 多路复用

地址与名称解析

字节序与地址值

目录与阅读设置

记录一个想法

Socket API 常用调用速查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通