2025-08-11

Linux系统编程

setsockopt系统调用及示例

1. 函数介绍

setsockopt (Set Socket Options) 是一个 Linux 系统调用，用于在已创建的套接字上设置各种选项（options）或参数（parameters）。这些选项控制着套接字的行为和底层协议的特定方面。

data-ad-format="fluid" data-ad-layout-key="-7k+ex-4a-9w+4a">

你可以把 setsockopt 想象成调整收音机或电视机的设置：

你有一个设备（套接字）。
这个设备有很多可以调整的旋钮和开关（选项），比如音量（SO_RCVBUF）、音质（SO_REUSEADDR）、电源（SO_KEEPALIVE）等。
setsockopt 就是让你转动这些旋钮、切换这些开关，来改变设备的工作方式。

这些选项可以影响套接字的方方面面，例如：

地址重用: 允许绑定到一个处于 TIME_WAIT 状态的地址（SO_REUSEADDR）。
缓冲区大小: 调整发送和接收缓冲区的大小（SO_SNDBUF, SO_RCVBUF）。
连接保活: 启用 TCP 的 keep-alive 机制来检测死连接（SO_KEEPALIVE）。
** linger**: 控制 close 调用在有未发送数据时的行为（SO_LINGER）。
广播: 允许在 UDP 套接字上发送广播数据报（SO_BROADCAST）。
错误: 控制是否接收带外数据的错误指示（SO_OOBINLINE）。
超时: 设置发送和接收的超时时间（SO_SNDTIMEO, SO_RCVTIMEO）。
以及其他许多高级选项。

2. 函数原型

#include <sys/socket.h> // 必需

int setsockopt(int sockfd, int level, int optname, const void *optval, socklen_t optlen);

3. 功能

设置选项: 为套接字 sockfd 设置由 level 和 optname 共同指定的选项。
传递参数: 通过 optval 指针将选项的具体值传递给内核。这个值的类型和含义取决于具体的选项。
指定长度: 通过 optlen 指定 optval 指向的数据的大小（以字节为单位）。

4. 参数

int sockfd: 这是一个已创建（通过 socket()）的有效套接字文件描述符。

int level: 指定选项定义的协议层（level）。

SOL_SOCKET: 套接字层本身。这是最常用的级别，用于设置与具体网络协议（如 TCP/IP）无关的通用套接字选项。
IPPROTO_IP: IP 层。用于设置 IP 协议特有的选项（如 IP_TTL）。
IPPROTO_TCP: TCP 层。用于设置 TCP 协议特有的选项（如 TCP_NODELAY）。
IPPROTO_IPV6: IPv6 层。用于设置 IPv6 协议特有的选项。

int optname: 指定在 level 层要设置的具体选项名称。
例如，在 SOL_SOCKET 级别，常见的 optname 有：

SO_REUSEADDR: 允许重用本地地址。
SO_KEEPALIVE: 启用 keep-alive 机制。
SO_LINGER: 设置 linger 选项。
SO_BROADCAST: 允许发送广播数据报。
SO_SNDBUF: 设置发送缓冲区大小。
SO_RCVBUF: 设置接收缓冲区大小。
SO_SNDTIMEO: 设置发送超时。
SO_RCVTIMEO: 设置接收超时。

在 IPPROTO_TCP 级别，常见的 optname 有：

TCP_NODELAY: 禁用 Nagle 算法（发送小包时立即发送，不等待）。

const void *optval: 这是一个指向选项值的指针。

选项值的类型取决于 optname。
对于布尔型选项（如 SO_REUSEADDR），通常是一个指向 int 的指针，非 0 表示启用，0 表示禁用。
对于整型选项（如 SO_SNDBUF），通常是一个指向 int 的指针，值为所需的大小。
对于结构体选项（如 SO_LINGER），则是一个指向相应结构体的指针。

socklen_t optlen: 指定 optval 指向的数据的大小（以字节为单位）。

例如，如果 optval 指向一个 int，则 optlen 应为 sizeof(int)。
如果 optval 指向一个 struct linger，则 optlen 应为 sizeof(struct linger)。

5. 返回值

成功时: 返回 0。套接字选项已成功设置。
失败时: 返回 -1，并设置全局变量 errno 来指示具体的错误原因（例如 EBADF sockfd 无效，EINVAL level 或 optname 无效或 optval/optlen 不匹配，ENOPROTOOPT 协议不支持该选项等）。

6. 相似函数，或关联函数

getsockopt: 用于获取套接字的当前选项值。与 setsockopt 相对应。
socket: 创建套接字，是 setsockopt 操作的对象。
bind / listen / connect: 其他套接字操作函数，通常与 setsockopt 结合使用来配置套接字。

7. 示例代码

示例 1：设置 SO_REUSEADDR 选项

这个例子演示了如何在服务器套接字上设置 SO_REUSEADDR 选项，这是服务器编程中的一个常见且重要的实践。

// setsockopt_reuseaddr.c
#include <sys/socket.h>
#include <netinet/in.h>
#include <unistd.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#define PORT 8095
#define BACKLOG 10

int main() {
    int server_fd;
    struct sockaddr_in address;
    int opt = 1; // 用于 SO_REUSEADDR 的值

    // 1. 创建套接字
    if ((server_fd = socket(AF_INET, SOCK_STREAM, 0)) == 0) {
        perror("socket failed");
        exit(EXIT_FAILURE);
    }
    printf("Socket created successfully (fd: %d)\n", server_fd);

    // --- 关键: 设置 SO_REUSEADDR 选项 ---
    // 这允许服务器在重启时立即绑定到同一个地址，
    // 即使旧的连接可能处于 TIME_WAIT 状态。
    printf("Setting SO_REUSEADDR option...\n");
    if (setsockopt(server_fd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt))) {
        perror("setsockopt SO_REUSEADDR failed");
        // 注意：即使失败，程序也可以继续，但这不是好习惯
        // 最佳实践是处理错误并决定是否继续
        close(server_fd);
        exit(EXIT_FAILURE);
    }
    printf("SO_REUSEADDR option set successfully.\n");

    // 2. 配置服务器地址结构
    memset(&address, 0, sizeof(address));
    address.sin_family = AF_INET;
    address.sin_addr.s_addr = INADDR_ANY;
    address.sin_port = htons(PORT);

    // 3. 绑定套接字
    printf("Binding socket to port %d...\n", PORT);
    if (bind(server_fd, (struct sockaddr *)&address, sizeof(address)) < 0) {
        perror("bind failed");
        close(server_fd);
        exit(EXIT_FAILURE);
    }
    printf("Socket bound successfully.\n");

    // 4. 监听
    if (listen(server_fd, BACKLOG) < 0) {
        perror("listen failed");
        close(server_fd);
        exit(EXIT_FAILURE);
    }
    printf("Server is listening.\n");

    printf("Server setup complete. Press Ctrl+C to exit.\n");
    pause(); // 挂起等待信号

    close(server_fd);
    return 0;
}

代码解释:

创建 TCP 套接字。

关键步骤: 调用 setsockopt(server_fd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt))。

server_fd: 要设置选项的套接字。
SOL_SOCKET: 选项所在的协议层（套接字层）。
SO_REUSEADDR: 要设置的选项名称。
&opt: 指向选项值的指针。这里 opt 是一个 int 变量，值为 1，表示启用该选项。
sizeof(opt): 选项值的大小。

如果调用成功，SO_REUSEADDR 选项就被设置为启用了。

继续进行 bind 和 listen。

设置 SO_REUSEADDR 的好处是，当服务器进程因某种原因（如崩溃或重启）终止后，它之前绑定的地址和端口可能会在内核中处于 TIME_WAIT 状态一段时间。如果没有设置 SO_REUSEADDR，立即重启服务器并尝试绑定同一个地址端口会失败（EADDRINUSE）。设置了这个选项后，就可以立即重用该地址。

示例 2：设置 SO_RCVBUF 和 SO_SNDBUF 选项

这个例子演示了如何调整套接字的接收和发送缓冲区大小。

// setsockopt_buffer.c
#include <sys/socket.h>
#include <netinet/in.h>
#include <unistd.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#define PORT 8096
#define CUSTOM_BUFFER_SIZE 64 * 1024 // 64 KB

void print_buffer_sizes(int sock, const char* role) {
    int rcv_buf_size, snd_buf_size;
    socklen_t len = sizeof(rcv_buf_size);

    if (getsockopt(sock, SOL_SOCKET, SO_RCVBUF, &rcv_buf_size, &len) == 0) {
        printf("%s SO_RCVBUF: %d bytes\n", role, rcv_buf_size);
    } else {
        perror("getsockopt SO_RCVBUF failed");
    }

    len = sizeof(snd_buf_size); // Reset len
    if (getsockopt(sock, SOL_SOCKET, SO_SNDBUF, &snd_buf_size, &len) == 0) {
        printf("%s SO_SNDBUF: %d bytes\n", role, snd_buf_size);
    } else {
        perror("getsockopt SO_SNDBUF failed");
    }
}

int main() {
    int server_fd, client_sock;
    struct sockaddr_in address, client_addr;
    socklen_t client_addr_len = sizeof(client_addr);
    int opt = 1;

    server_fd = socket(AF_INET, SOCK_STREAM, 0);
    if (server_fd == 0) {
        perror("socket failed");
        exit(EXIT_FAILURE);
    }

    // 设置 SO_REUSEADDR
    if (setsockopt(server_fd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt))) {
        perror("setsockopt SO_REUSEADDR failed");
        close(server_fd);
        exit(EXIT_FAILURE);
    }

    // --- 设置服务器套接字的缓冲区大小 ---
    printf("--- Before setting buffer sizes ---\n");
    print_buffer_sizes(server_fd, "Server (before)");

    int rcv_buf_size = CUSTOM_BUFFER_SIZE;
    int snd_buf_size = CUSTOM_BUFFER_SIZE;

    printf("\nSetting custom buffer sizes to %d bytes...\n", CUSTOM_BUFFER_SIZE);
    if (setsockopt(server_fd, SOL_SOCKET, SO_RCVBUF, &rcv_buf_size, sizeof(rcv_buf_size))) {
        perror("setsockopt SO_RCVBUF failed");
        // 注意：内核可能会调整这个值到一个合理的范围
    }
    if (setsockopt(server_fd, SOL_SOCKET, SO_SNDBUF, &snd_buf_size, sizeof(snd_buf_size))) {
        perror("setsockopt SO_SNDBUF failed");
    }

    printf("--- After setting buffer sizes ---\n");
    print_buffer_sizes(server_fd, "Server (after)");

    // 绑定和监听
    memset(&address, 0, sizeof(address));
    address.sin_family = AF_INET;
    address.sin_addr.s_addr = INADDR_ANY;
    address.sin_port = htons(PORT);

    if (bind(server_fd, (struct sockaddr *)&address, sizeof(address)) < 0) {
        perror("bind failed");
        close(server_fd);
        exit(EXIT_FAILURE);
    }

    if (listen(server_fd, 5) < 0) {
        perror("listen failed");
        close(server_fd);
        exit(EXIT_FAILURE);
    }

    printf("\nServer listening on port %d\n", PORT);

    // --- 客户端连接 ---
    client_sock = socket(AF_INET, SOCK_STREAM, 0);
    if (client_sock < 0) {
        perror("client socket failed");
        close(server_fd);
        exit(EXIT_FAILURE);
    }

    struct sockaddr_in serv_addr;
    memset(&serv_addr, 0, sizeof(serv_addr));
    serv_addr.sin_family = AF_INET;
    serv_addr.sin_port = htons(PORT);
    serv_addr.sin_addr.s_addr = inet_addr("127.0.0.1");

    if (connect(client_sock, (struct sockaddr *)&serv_addr, sizeof(serv_addr)) < 0) {
        perror("client connect failed");
        close(server_fd);
        close(client_sock);
        exit(EXIT_FAILURE);
    }

    // --- 检查客户端套接字的缓冲区大小 ---
    printf("\n--- Client socket buffer sizes ---\n");
    print_buffer_sizes(client_sock, "Client");

    // --- 服务器 accept 连接并检查其套接字 ---
    int accepted_sock = accept(server_fd, (struct sockaddr *)&client_addr, &client_addr_len);
    if (accepted_sock < 0) {
        perror("accept failed");
        close(server_fd);
        close(client_sock);
        exit(EXIT_FAILURE);
    }

    printf("\n--- Server accepted socket buffer sizes ---\n");
    print_buffer_sizes(accepted_sock, "Server-Accepted");

    // 简单通信后关闭
    close(client_sock);
    close(accepted_sock);
    close(server_fd);

    return 0;
}

代码解释:

定义了一个 print_buffer_sizes 函数，它使用 getsockopt 来获取并打印套接字的当前接收和发送缓冲区大小。

创建服务器套接字。

设置 SO_REUSEADDR。

关键: 在 bind 之前，调用 setsockopt 来设置服务器套接字的 SO_RCVBUF 和 SO_SNDBUF。

传递一个 int 变量的指针和其大小。

打印设置前后的缓冲区大小。注意，内核可能会将请求的大小调整为一个内部支持的值。

继续设置服务器监听。

创建客户端套接字并连接。

打印客户端套接字的缓冲区大小。

服务器 accept 连接，得到一个新的已连接套接字。

打印这个新套接字的缓冲区大小。通常，accept 返回的套接字会继承监听套接字的一些属性，包括缓冲区大小。

示例 3：设置 TCP_NODELAY 选项

这个例子演示了如何在 TCP 套接字上设置 TCP_NODELAY 选项，以禁用 Nagle 算法。

// setsockopt_tcp_nodelay.c
#include <sys/socket.h>
#include <netinet/in.h>
#include <netinet/tcp.h> // For TCP_NODELAY
#include <unistd.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#define PORT 8097

int main() {
    int server_fd, client_sock;
    struct sockaddr_in address, client_addr;
    socklen_t client_addr_len = sizeof(client_addr);
    int opt = 1;

    server_fd = socket(AF_INET, SOCK_STREAM, 0);
    if (server_fd == 0) {
        perror("socket failed");
        exit(EXIT_FAILURE);
    }

    if (setsockopt(server_fd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt))) {
        perror("setsockopt SO_REUSEADDR failed");
        close(server_fd);
        exit(EXIT_FAILURE);
    }

    memset(&address, 0, sizeof(address));
    address.sin_family = AF_INET;
    address.sin_addr.s_addr = INADDR_ANY;
    address.sin_port = htons(PORT);

    if (bind(server_fd, (struct sockaddr *)&address, sizeof(address)) < 0) {
        perror("bind failed");
        close(server_fd);
        exit(EXIT_FAILURE);
    }

    if (listen(server_fd, 5) < 0) {
        perror("listen failed");
        close(server_fd);
        exit(EXIT_FAILURE);
    }

    printf("Server listening on port %d. Waiting for connection...\n", PORT);

    // --- 客户端连接 ---
    client_sock = socket(AF_INET, SOCK_STREAM, 0);
    if (client_sock < 0) {
        perror("client socket failed");
        close(server_fd);
        exit(EXIT_FAILURE);
    }

    struct sockaddr_in serv_addr;
    memset(&serv_addr, 0, sizeof(serv_addr));
    serv_addr.sin_family = AF_INET;
    serv_addr.sin_port = htons(PORT);
    serv_addr.sin_addr.s_addr = inet_addr("127.0.0.1");

    if (connect(client_sock, (struct sockaddr *)&serv_addr, sizeof(serv_addr)) < 0) {
        perror("client connect failed");
        close(server_fd);
        close(client_sock);
        exit(EXIT_FAILURE);
    }
    printf("Client connected.\n");

    // --- 服务器 accept 连接 ---
    int accepted_sock = accept(server_fd, (struct sockaddr *)&client_addr, &client_addr_len);
    if (accepted_sock < 0) {
        perror("accept failed");
        close(server_fd);
        close(client_sock);
        exit(EXIT_FAILURE);
    }
    printf("Server accepted connection.\n");

    // --- 关键: 在已连接的套接字上设置 TCP_NODELAY ---
    // 这会禁用 Nagle 算法，使得小的数据包能够立即发送，而不必等待 ACK 或积累更多数据。
    // 这对于实时性要求高的应用（如游戏、交互式应用）很有用。
    printf("\nSetting TCP_NODELAY on server's accepted socket...\n");
    int flag = 1; // Enable TCP_NODELAY
    if (setsockopt(accepted_sock, IPPROTO_TCP, TCP_NODELAY, (char *) &flag, sizeof(int)) < 0) {
        perror("setsockopt TCP_NODELAY on server socket failed");
        // 不是致命错误，可以继续
    } else {
        printf("TCP_NODELAY enabled on server's accepted socket (fd: %d).\n", accepted_sock);
    }

    printf("\nSetting TCP_NODELAY on client socket...\n");
    if (setsockopt(client_sock, IPPROTO_TCP, TCP_NODELAY, (char *) &flag, sizeof(int)) < 0) {
        perror("setsockopt TCP_NODELAY on client socket failed");
    } else {
        printf("TCP_NODELAY enabled on client socket (fd: %d).\n", client_sock);
    }

    // ... 这里可以进行数据传输 ...

    close(client_sock);
    close(accepted_sock);
    close(server_fd);

    printf("Sockets closed.\n");
    return 0;
}

代码解释:

设置标准的服务器和客户端连接。

服务器 accept 连接后，得到 accepted_sock。

关键: 在 accepted_sock 上调用 setsockopt(accepted_sock, IPPROTO_TCP, TCP_NODELAY, …)。

IPPROTO_TCP: 选项所在的协议层（TCP 层）。
TCP_NODELAY: 要设置的选项名称。
&flag (flag=1): 选项值，1 表示启用（禁用 Nagle 算法）。
sizeof(int): 选项值大小。

同样地，在客户端套接字 client_sock 上也设置 TCP_NODELAY。

启用 TCP_NODELAY 后，TCP 连接将立即发送小的数据包，而不会等待将多个小包合并成一个更大的包（Nagle 算法的默认行为）或等待前一个包的 ACK。这可以减少延迟，但可能会增加网络上的小包数量。

重要提示与注意事项:

调用时机: setsockopt 可以在 socket() 之后、bind()/connect()/listen() 之前或之后调用，具体取决于选项。有些选项（如 SO_REUSEADDR）必须在 bind 之前设置才有效。

level 和 optname 的匹配: 确保 level 和 optname 正确匹配。例如，TCP_NODELAY 必须在 IPPROTO_TCP 级别设置。

optval 和 optlen: 确保传递给 optval 的数据类型和大小与 optname 要求的完全一致。

内核调整: 对于某些选项（如缓冲区大小），内核可能会将你请求的值调整为一个它认为更合适的值。

错误处理: 始终检查返回值。虽然某些选项设置失败可能不会导致程序无法运行，但最好处理错误并了解原因。

常见用途: SO_REUSEADDR、TCP_NODELAY、SO_KEEPALIVE、SO_LINGER 是网络编程中非常常见的选项。

总结:

setsockopt 是一个功能强大的函数，允许程序员精细地调整套接字的行为。理解其参数（特别是 level 和 optname 的组合）以及各种常用选项的作用，对于编写高效、健壮的网络应用程序至关重要。它是网络编程中不可或缺的工具之一。

https://www.calcguide.tech/2025/08/26/linux开源软件路线图/

data-ad-format="auto" data-full-width-responsive="true">

CalcGuide 技术博客

AI Coding · 技术分享 · 工具实践

setsockopt系统调用及示例

1. 函数介绍

2. 函数原型

3. 功能

4. 参数

5. 返回值

6. 相似函数，或关联函数

7. 示例代码

示例 1：设置 SO_REUSEADDR 选项

示例 2：设置 SO_RCVBUF 和 SO_SNDBUF 选项

示例 3：设置 TCP_NODELAY 选项

重要提示与注意事项:

1. 函数介绍

2. 函数原型

3. 功能

4. 参数

5. 返回值

6. 相似函数，或关联函数

7. 示例代码

示例 1：设置 SO_REUSEADDR 选项

示例 2：设置 SO_RCVBUF 和 SO_SNDBUF 选项

示例 3：设置 TCP_NODELAY 选项

重要提示与注意事项:

📚 相关文章