linux手册翻译——socket(7)

socket - Linux 套接字接口

本手册页描述了 Linux 网络套接字层用户接口。 套接字是用户进程和内核中网络协议栈之间的统一接口。 协议模块分为协议族(protocol families)（如 AF_INET、AF_IPX 和 AF_PACKET）和套接字类型(socket types)（如 SOCK_STREAM 或 SOCK_DGRAM）。 有关families和types的更多信息，请参阅 socket(2) 。

用户进程使用这些函数来发送或接收数据包以及执行其他套接字 *** 作。 有关更多信息，请参阅它们各自的手册页。

socket(2) 创建套接字，connect(2) 将套接字连接到远程套接字地址，bind(2) 函数将套接字绑定到本地套接字地址，listen(2) 告诉套接字应接受新连接， accept(2) 用于获取具有新传入连接的新套接字。 socketpair(2) 返回两个连接的匿名套接字（仅为少数本地families如 AF_UNIX 实现）

send(2)、sendto(2) 和sendmsg(2) 通过套接字发送数据，而recv(2)、recvfrom(2)、recvmsg(2) 从套接字接收数据。 poll(2) 和 select(2) 等待数据到达或准备好发送数据。 此外，还可以使用 write(2)、writev(2)、sendfile(2)、read(2) 和 readv(2) 等标准 I/O *** 作来读取和写入数据。

getsockname(2) 返回本地套接字地址， getpeername(2) 返回远程套接字地址。 getsockopt(2) 和 setsockopt(2) 用于设置或获取套接字层或协议选项。 ioctl(2) 可用于设置或读取一些其他选项。

close(2) 用于关闭套接字。 shutdown(2) 关闭全双工套接字连接的一部分。

套接字不支持使用非零位置查找或调用 pread(2) 或 pwrite(2)。

通过使用 fcntl(2) 在套接字文件描述符上设置 O_NONBLOCK 标志，可以在套接字上执行非阻塞 I/O。 然后所有会阻塞的 *** 作（通常）将返回 EAGAIN（ *** 作应稍后重试）； connect(2) 将返回 EINPROGRESS 错误。 然后用户可以通过 poll(2) 或 select(2) 等待各种事件。

如果不使用poll(2) 和 select(2) ，还让内核通过 SIGIO 信号通知应用程序有关事件的信息。 为此，必须通过 fcntl(2) 在套接字文件描述符上设置 O_ASYNC 标志，并且必须通过 sigaction(2) 安装有效的 SIGIO 信号处理程序。 请参阅下面的信号讨论。

每个套接字域(families)都有自己的套接字地址格式，具有特定于域的地址结构。 这些结构的首字段都是整数类型的“家族”字段（类型为 sa_family_t），即指出自己的套接字域或者说是protocol families。 这允许对所有套接字域可以使用统一的系统调用(例如，connect(2)、bind(2)、accept(2)、getsockname(2)、getpeername(2))，并通过套接字地址来确定特定的域。

为了允许将任何类型的套接字地址传递给套接字 API 中的接口，定义了类型 struct sockaddr。 这种类型的目的纯粹是为了允许将特定于域的套接字地址类型转换为“通用”类型，以避免编译器在调用套接字 API 时发出有关类型不匹配的警告。

struct sockaddr 以及在AF_INET常用的地址结构struct sockaddr_in如下所示，sockaddr_in.sin_zero是占位符：

此外，套接字 API 提供了数据类型 struct sockaddr_storage。 这种类型适合容纳所有支持的特定于域的套接字地址结构； 它足够大并且正确对齐。 （特别是它足够大，可以容纳 IPv6 套接字地址。）同struct sockaddr一样，该结构体包括以下字段，可用于标识实际存储在结构体中的套接字地址的类型： sa_family_t ss_family

sockaddr_storage 结构在必须以通用方式处理套接字地址的程序中很有用（例如，必须同时处理 IPv4 和 IPv6 套接字地址的程序）。

下面列出的套接字选项可以使用setsockopt(2) 设置并使用getsockopt(2) 读取。

当写入已关闭（由本地或远程端）的面向连接的套接字时，SIGPIPE 被发送到写入进程并返回 EPIPE。 当写调用指定 MSG_NOSIGNAL 标志时，不发送信号。

当使用 FIOSETOWN fcntl(2) 或 SIOCSPGRP ioctl(2) 请求时，会在 I/O 事件发生时发送 SIGIO。 可以在信号处理程序中使用 poll(2) 或 select(2) 来找出事件发生在哪个套接字上。 另一种方法（在 Linux 2.2 中）是使用 F_SETSIG fcntl(2) 设置实时信号； 实时信号的处理程序将使用其 siginfo_t 的 si_fd 字段中的文件描述符调用。 有关更多信息，请参阅 fcntl(2)。

在某些情况下（例如，多个进程访问单个套接字），当进程对信号做出反应时，导致 SIGIO 的条件可能已经消失。 如果发生这种情况，进程应该再次等待，因为 Linux 稍后会重新发送信号。

核心套接字网络参数可以通过目录 /proc/sys/net/core/ 中的文件访问。

These operations can be accessed using ioctl(2):

error = ioctl(ip_socket, ioctl_type, &value_result)

Valid fcntl(2) operations:

Linux assumes that half of the send/receive buffer is used for internal kernel structuresthus the values in the corresponding /proc files are twice what can be observed on the wire. Linux will allow port reuse only with the SO_REUSEADDR option when this option was set both in the previous program that performed a bind(2) to the port and in the program that wants to reuse the port. This differs from some implementations (e.g., FreeBSD) where only the later program needs to set the SO_REUSEADDR option. Typically this difference is invisible, since, for example, a server program is designed to always set this option.

socket - 创建一个用于通信的端点

socket() 创建用于通信的端点并返回引用该端点的文件描述符。 成功调用时返回的文件描述符，将是当前没有被进程打开的所有文件描述符中编号最低的。

domain 参数指定一个通信域； 以决定用于通信的协议族。 这些系列在 <sys/socket.h>中定义。 目前 Linux 内核理解的格式包括：

当然最常用的当然是 AF_INET ，即IPV4。

上述地址族的更多详细信息以及其他几个地址族的信息可以在 address_families(7) 中找到。

套接字具有指定的 type ，它指定了通信语义。 当前定义的类型有：

某些套接字类型可能不会被所有协议族实现。

从 Linux 2.6.27 开始，type 参数有第二个用途：除了指定套接字类型之外，它还可以包含以下任何值的按位或，以修改 socket() 的行为：

老朋友了，上述两个，第一个是非阻塞，第二个是执行exec时自动关闭。

protocol 指定要与套接字一起使用的特定协议。 通常只存在一个协议来支持给定协议族中的特定套接字类型 ，在这种情况下，protocol 可以指定为 0。但是，可能存在许多协议，在这种情况下，必须在此指定特定协议方式。 特定协议对应的编号可以查看文件: /etc/protocols

SOCK_STREAM 类型的套接字是全双工字节流。 它们不保留记录边界。 流套接字必须处于连接状态，然后才能在其上发送或接收任何数据。 到另一个套接字的连接是通过 connect(2) 调用创建的。 连接后，可以使用 read(2) 和 write(2) 调用或 其变体send(2) 和 recv(2) 的来传输数据。 当会话完成时，可以执行 close(2)。 带外数据也可以按照 send(2) 中的描述进行传输，并按照 recv(2) 中的描述进行接收。

实现 SOCK_STREAM 的通信协议确保数据不会丢失或重复。 如果协议的缓冲空间中存在一条数据在合理的时间内不能成功传输，则认为该连接已失效。 当 SO_KEEPALIVE 在套接字上启用时，将会以特定于协议的方式检查另一端是否仍然存在。 如果进程在损坏的流上发送或接收，则会引发 SIGPIPE 信号； 这会导致不处理信号的进程退出。 SOCK_SEQPACKET 套接字使用与 SOCK_STREAM 套接字相同的系统调用。 唯一的区别是 read(2) 调用将只返回请求的数据量，到达数据包中剩余的其他数据都将被丢弃。 传入数据报中的所有消息边界也被保留。

SOCK_DGRAM 和 SOCK_RAW 套接字允许将数据报发送到在 sendto(2) 调用中指定的通信者。 数据报通常用 recvfrom(2) 接收，它返回下一个数据报及其发送者的地址。

SOCK_PACKET 是一种过时的套接字类型，用于直接从设备驱动程序接收原始数据包。 改用 packet(7)。

An fcntl(2) F_SETOWN operation can be used to specify a process or process group to receive a SIGURG signal when the out-of-band data arrives or SIGPIPE signal when a SOCK_STREAM connection breaks unexpectedly. This operation may also be used to set the process or process group that receives the I/O and asynchronous notification of I/O events via SIGIO. Using F_SETOWN is equivalent to an ioctl(2) call with the FIOSETOWN or SIOCSPGRP argument.

When the network signals an error condition to the protocol module (e.g., using an ICMP message for IP) the pending error flag is set for the socket. The next operation on this socket will return the error code of the pending error. For some protocols it is possible to enable a per-socket error queue to retrieve detailed information about the errorsee IP_RECVERR in ip(7).

套接字的 *** 作由套接字选项控制。 这些选项在 <sys/socket.h>中定义。 函数setsockopt(2) 和getsockopt(2) 用于设置和获取选项。对于选项的描述，详见socket(7).

成功时，将返回新套接字的文件描述符。 出错时，返回 -1，并设置 errno 以指示错误。

POSIX.1-2001, POSIX.1-2008, 4.4BSD.

The SOCK_NONBLOCK and SOCK_CLOEXEC flags are Linux-specific.

socket() appeared in 4.2BSD. It is generally portable to/from non-BSD systems supporting clones of the BSD socket layer (including System V variants).

在 4.x BSD 下用于协议族的清单常量是 PF_UNIX、PF_INET 等，而 AF_UNIX、AF_INET 等用于地址族。 但是，BSD 手册页已经承诺：“协议族通常与地址族相同”，随后的标准到处都使用 AF_*。

套接字1调用listen()之后会由主动模式变为被动模式来接受客户端的请求，如果等待队列中有请求进来，accept()会返回一个新的套接字2来处理请求，套接字1则继续在端口上监听，套接字1和套接字2具有相同的属性。

建立两个套接字的设计是为了使用起来更加直观，这就和线程池中，主线程用来接受请求，子线程处理请求差不多。

个人理解，纯手打，如有错误，欢迎指出。

---