【计算机网络】网络编程接口 Socket API 解读(9)

         Socket 是网络协议栈暴露给编程人员的 API,相比复杂的计算机网络协议,API 对关键操作和配置数据进行了抽象,简化了程序编程。

        本文讲述的 socket 内容源自 Linux man。本文主要对各 API 进行详细介绍,从而更好的理解 socket 编程。


socket(7)

send()           遵循 POSIX.1 - 2008

MSG_CONFIRM 是 Linux 扩展

1.库

标准 c 库,libc, -lc

2.头文件

3.接口定义

       sockfd = socket(int socket_family, int socket_type, int protocol);

4.接口描述

 【计算机网络】网络编程接口 Socket API 解读(8)        

SO_PEEK_OFF(Linux 3.4 后)

        这个选项目前只有 unix(7) 套接字支持,在 recv(2) 系统调用使用了 MSG_PEEK 标记时,可以用它来设置 “peek offset”,即窥探偏移。

        当这个选项值设置为负值时(对于所有新套接字,这个值都被设置为了 -1),窥探行为会采用传统行为,即携带 MSG_PEEK 标记的 recv(2) 会从队列头窥探数据。

        当这个选项值大于等于 0 时,那么下一次窥探位置就是这个选项指定的偏移地址。同时,窥探偏移会加上之前已经偏移过的值,这样下一次窥探才会返回队列中下一个数据。

        如果 recv(2) 或者其他接口没有使用 MSG_PEEK 标记导致数据从队列头移出,那么窥探偏移就会减去这个移出值。 换句话说,不使用 MSG_PEEK 标记会导致窥探偏移调整以保持正确的相对位置,保证后面窥探到的数据和没有移除数据时窥探到的数据相同。

        对于数据报套接字,如果窥探偏移指向了一个数据包的中间,那么返回的数据会被标记为 MSG_TRUNC。

        下面的例子解释 SO_PEEK_OFF 如何使用,假如流套接字里排队的输入数据如下:

                 aabbccddeeff

        下面的 recv() 调用效果如注释所述:

                  int ov = 4;                  // Set peek offset to 4
                  setsockopt(fd, SOL_SOCKET, SO_PEEK_OFF, &ov, sizeof(ov));

                  recv(fd, buf, 2, MSG_PEEK);  // Peeks "cc"; offset set to 6
                  recv(fd, buf, 2, MSG_PEEK);  // Peeks "dd"; offset set to 8
                  recv(fd, buf, 2, 0);         // Reads "aa"; offset set to 6
                  recv(fd, buf, 2, MSG_PEEK);  // Peeks "ee"; offset set to 8

SO_PEERCRED

        返回连接到套接字的对端进程的凭证。更多详细信息,参考 unix(7)。

SO_PEERSEC(Linux 2.6.2 后)

        返回连接到套接字的对端进程的安全上下文。更多信息,参考 unix(7)。

SO_PRIORITY

        设置套接字上所有要发送数据包协议定义的优先级。Linux 使用这个值来给网络队列排序:具有高优先级的数据包可以被优先处理,依赖于选定设备的排队规则。设置超出 0~6 的优先级需要 CAP_NET_ADMIN 能力。

SO_PROTOCOL(Linux 2.6.32 后)

        获得套接字协议值,返回值类似 IPPROTO_SCTP 这样的整型值。参考 socket(2) 获取更多信息。这个套接字选项是只读的。

SO_RCVBUF

        设置/获取最大套接字接收缓冲区大小(字节数)。当使用 setsockopt(2) 设置这个值时,内核会使用这个值的两倍(考虑到其他记录结构开销),使用 getsockopt(2) 返回两倍的值。默认值在 /proc/sys/net/core/rmem_default 文件设置,最大值由 /proc/sys/net/core/rmem_max 文件设置。最小值(双倍的)是 256。

SO_RCVBUFFORCE(Linux 2.6.14 后)

        具备 CAP_NET_ADMIN 能力的特权进程可以通过这个选项进行和 SO_RCVBUF 类似的设置,但是这个可以设置 rmem_max 最大限制值。

SO_RCVLOWATSO_SNDLOWAT

        设置套接字层将数据交由底层协议的最小缓冲量(SO_SNDLOWAT)以及用户接收到数据的最小值(SO_RCVLOWAT)。这两个值初始化为 1,SO_SNDLOWAT 在 Linux 上不可改(setsockopt(2) 会返回 ENOPROTOOPT 错误),SO_RCVLOWAT 在 Linux 2.4 后可以修改。

        Linux 2.6.28 之前,Linux 上 select(2)/poll(2)/epoll(7) 不看 SO_RCVLOWAT 设置,即使有一个字节也认为套接字是读就绪的,接下来从套接字读取会阻塞直到 SO_RCVLOWAT 字节可用。Linux 2.6.28 后,这几个接口只有在字节达到 SO_RCVLOWAT 值时才会套接字标记为读就绪。

SO_RCVTIMEOSO_SNDTIMEO

        指定接收和发送超时值,参数是 struct timeval 类型。如果一个输入/输出函数阻塞这么长时间,并且发送或者接收了一部分数据,那么会返回已传输数据量,如果没有传输任何数据,那么会返回 -1 并设置 errno 为 EAGAIN 或者 EWOULDBLOCK,或者套接字设置为非阻塞时返回 EINPROGRESS(只对 connect(2) 有效)。如果超时值设置为 0(默认值),那么对应操作永不超时。超时只对进行 I/O 操作的系统调用生效(比如 accept(2)、connect(2)、read(2)、recvmsg(2)、send(2)、sendmsg(2)),对于 select(2)、poll(2)、epoll_wait(2) 等无效。

SO_REUSEADDR

        表示 bind(2) 中用于验证地址有效性的规则允许本地地址重用。对于 AF_INET 套接字,套接字可以绑定到正在被监听的本地地址外的任何地址。当监听套接字绑定了到 INADDR_ANY 并指定了端口,那么任何地址上都不能再绑定该端口。参数是一个整型布尔标记。

SO_REUSEPORT(Linux 3.9 后)

        允许多个 AF_INET 或者 AF_INET6 套接字绑定到相同的套接字地址上。这个选项必须在 bind(2) 前设置到每个套接字上(包括第一个套接字)。为了防止端口劫持,绑定到相同地址的所有进程必须具有相同的有效 UID。这个选项可以用于 TCP 和 UDP 套接字上。

        对于 TCP 套接字,这个选项允许 accept(2) 在多线程服务器上进行负载分配,每个线程使用一个不同的监听套接字。这种方式比传统方式高效很多,比如使用一个单线程进行 accept(2) 分配连接,或者有多个线程在同一个套接字上进行 accept(2) 竞争。

        对于 UDP 套接字,比起传统的多个进程在同一个套接字上竞争接收数据报,这种方式能够允许多进程(线程)对过来的数据报进行更好的负载分配。

SO_RXQ_OVFL(Linux 2.6.33 后)

        表示需要携带一个 32 位的辅助消息来接收 skbs,skbs 是自从套接字创建以来丢包总数。

SO_SELECT_ERR_QUEQUE(Linux 3.10 后)

        设置这个选项的套接字,套接字上的错误不仅仅会通过 select(2) 的 exceptfds 通知,同样 poll(2) 也会在返回 POLLERR 事件时,返回一个 POLLPRI 错误。

        背景:这个选项就是为了不同在 select(2) 的 readfdf、writefds 上监听错误,而是使用 exceptfds 参数来监听,这样实现很好的解耦。Linux 4.16 后,这个选项就没有什么意义了,尽管如此,为了向后兼容,该选项还是保留了。

SO_SNDBUF

        设置/获取最大套接字发送缓冲器大小。当使用 setsockopt(2) 设置这个缓冲区大小时,内核会将这个值翻倍,并且后续通过 getsockopt(2) 返回的就是这个翻倍的值。默认值通过文件 /proc/sys/net/core/wmem_default 设置,最大值通过 /proc/sys/net/core/wmem_max 文件设置,最小值是 2048。

SO_SNDBUFFORCE(Linux 2.6.14 后)

        特权进程(具有 CAT_NET_ADMIN 权限)可以使用这个选项设置发送缓冲区大小,但是可以覆盖 wmem_max 的值。

SO_TIMESTAMP

        使能/禁能接收 SO_TIMESTAMP 控制消息。时间戳控制信息是通过 SOL_SOCKET 级别和 cmsg_type 类型的 SCM_TIMESTAMP 发送的,cmsg_data 字段是一个 struct timeval 数值表示传递给用户调用最后一个数据包的时间。参考 cmsg(3) 获得更多控制消息的详细信息。

SO_TIMESTAMPNS

        使能/禁能接收 SO_TIMESTAMPNS 控制消息。时间戳控制信息是通过 SOL_SOCKET 级别和 cmsg_type 类型的 SCM_TIMESTAMPNS 发送的,cmsg_data 字段是一个 struct timespec 数值表示传递给用户调用最后一个数据包的时间。时间戳采用的是 CLOCK_REALTIME 时钟。参考 cmsg(3) 获得更多控制消息的详细信息。

        套接字不能混用 SO_TIMESTAMP 和 SO_TIMESTAMPNS:这两种模式互斥。

SO_TYPE

        获取套接字类型,套接字类型是一个类似 SOCK_STREAM 这样的整型值,这是一个只读选项。

SO_BUSY_POLL(Linux 3.11 后)

        在阻塞读取而没有数据时,设置一个大概的微秒级的忙轮询时间。增加这个值需要 CAP_NET_ADMIN 权限,默认值由 /proc/sys/net/core/busy_read 文件控制。

        这个文件中的值决定了 select(2) 和 poll(2) 在设置了 SO_BUSY_POLL 的套接字上的忙轮询时间。

        在这两种情况下,忙轮询只有在接收到数据的套接字支持这个选项才会生效。

        虽然忙轮询会提升一些应用的延迟,但是使用时需要注意,因为这个会增加 CPU 利用率和功耗。

信号

        向一个已经关闭(本地关闭或者对端关闭)的套接字里写数据会收到 SIGPIPE 信号,并会返回 EPIPE 错误码。如果写调用指明了 MSG_NOSIGNAL 标记的话,那么就不会发送这个信号。

        当使用 fcntl(2) FIOSETOWN 或者 ioctl(2) SIOCSPGRP 请求时,一旦发生 I/O 事件,就会发送 SIGIO 信号。可以在信号处理函数中使用 poll(2) 或者 select(2) 来查看是哪个套接字上发生的事件。另一个可选(Linux 2.2)是通过 F_SETSIG fcntl(2) 设置实时信号,实时信号的处理函数会在 siginfo_t 的 si_fd 字段携带套接字的文件描述符。更多信息,参考 fcntl(2)。

        在特定情况下(多进程访问同一个套接字),当进程响应信号时,触发 SIGIO 的条件可能早就消失了。如果发生这种情况,进程需要继续等待,因为 Linux 会重新发送这个信号。

/proc 接口

        核心套接字网络参数可以通过 /proc/sys/net/core 访问。

        rmem_default

        包含套接字接收缓冲区默认大小设置

        rmem_max

        包含用户通过 SO_RCVBUF 选项设置的最大接收缓冲区字节数

        wmem_default

        包含套接字发送缓冲区默认设置大小

        wmem_max

        包含用户通过 SO_SNDBUF 选项设置的最大发送缓冲区字节数

        message_costmessage_burst

        配置令牌桶过滤器,用来加载外部网络事件导致的限制警告信息

        netdev_max_backlog

        全局输入队列的最大数据包数量

        optmem_max

        辅助数据和用户控制数据(比如每个套接字的 iovecs)的最大长度

Ioctls

        上述有些操作可以通过 ioctl(2) 来访问:

           error = ioctl(ip_socket, ioctl_type, &value_result);

        SIOCGSTAMP

        给用户返回最近接收数据包的接收时间戳(struct timeval)。这个对于精确测量往返传输时间 RTT 非常有用。参考 setitimer(2) 查看关于 struct timval 的描述。这个 ioctl 只能在没有设置 SO_TIMSTAMP 和 SO_TIMESTAMPNS 的套接字上使用。否则就会返回没有设置 SO_TIMESTAMP 和 SO_TIMESTAMPNS 时的最后一个数据包的时间戳或者没有收到这样数据包时报错(即, ioctl(2) 返回 -1 并设置 errno 为 ENOENT)。

        SIOCSPGRP

        设置 I/O 可用或者紧急数据可用时处理 SIGIO/SIGURG 信号的进程或者进程组号。这个参数是一个指向 pid_t 类型的指针。更多信息,参考 fcntl(2) 中关于 F_SETOWN 的描述。

        FIOASYNC

        修改 O_ASYNC 标记来开启/禁止套接字的异步 I/O 模式。异步 I/O 模式当有新的 I/O 事件发生时会触发 SIGIO 或者 F_SETSIG 设置的信号。

        参数是一个布尔标记值。(这个操作在 fcntl(2) 设置了 O_ASYNC 标记时是同步的。)

        SIOCGPGRP

        获取当前接收 SIGIO/SIGURG 信号的进程/进程组,没有设置时返回 0。

        可用的 fcntl(2) 操作:

        FIOGETOWN

        和 ioctl(2) SIOCGPGRP 相同。

        FIOSETOWN

        和 ioctl(2) SIOCSPGRP 相同。 

5.注意

        Linux 假定收发缓冲区的一半用于内部内核结构,也就是说 /proc 文件中的值是实际值的两倍。

        Linux 只有在执行 bind(2) 程序和重用端口程序都设置了 SO_REUSEADDR 选项时才允许端口重用。这个和其他实现不同(比如 FreeBSD),其他实现只要求后面的程序设置 SO_REUSEADDR 即可。这点差别通常情况下是不可见的,因为服务器程序通常会设计为设置这个选项。 

6.示例代码

        下面是一个 getsockopt 函数的使用代码:

int rc;
int s;
int option_value;
int option_len;
struct linger l;
int getsockopt(int s, int level, int option_name,
char *option_value,
     int *option_len);

⋮
/* Is out-of-band data in the normal input queue? */
option_len = sizeof(int);
rc = getsockopt(
        s, SOL_SOCKET, SO_OOBINLINE, (
char *) &option_value, &option_len);
if (rc == 0)
{
    if (option_len == sizeof(int))
    {
         if (option_value)
            /* yes it is in the normal queue */
         else
            /* no it is not
                  */
    }
}

⋮
/* Do I linger on close? */
option_len = sizeof(l);
rc = getsockopt(
        s, SOL_SOCKET, SO_LINGER, (char *) &l, &option_len);
if (rc == 0)
{
    if (option_len == sizeof(l))
    {
         if (l.l_onoff)
            /* yes I linger */
         else
            /* no I do not  */
    }
}

     

你可能感兴趣的:(Linux,系统,API,讲解【连载】,计算机网络,套接字,socket,setsockopt)