Linux说明书手册 man page

man page 其实就是Manual Page的意思，使用方法是 man 命令 ，然后就会显示某个命令的所有官方说明和用法。这个是基础中的基础。

但是苦于Man Page和历史上所有的说明书一样，实在是太官方太枯燥了，所以我们可以看到一些衍生品：

TLDR 的意思是Too longDont' read. 这个词在写文章时代表接下来要出现一个很长的内容了，但是在Linux中其实代表着相反的意思：把大长篇的说明简化为两三句话，直入重点展示命令的用法。

tldr 是Linux命令行工具， 官网在此 。安装方式如下：

注意：各种设备、平台上的安装方法都不同，请到官网看详情。

相当与 tldr 的社区版，即社区可以贡献每种命令的使用事例，然后通过投票方式排名。所以bropage每次执行都是需要联网查询的。

用法是： bro 命令

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.

sendfile - transfer data between file descriptors

sendfile() 在一个文件描述符和另一个文件描述符之间复制数据。 因为这种复制是在 内核中完成 的，所以 sendfile() 比 read(2) 和 write(2) 的组合更有效，后者需要将数据传入和传出用户空间。

in_fd 是一个为读取而打开的文件描述符， out_fd 是一个为写入而打开的描述符。

如果 offset 不为NULL，则sendfile()将以其为偏移量从 in_fd 中读取数据。当 sendfile() 返回时，此变量将设置为读取的最后一个字节之后的偏移量。 如果 offset 为 NULL，则将从 in_fd 中的文件偏移量开始读取数据。

需要注意！如果指定了 offset ，那么读取 in_fd 中的数据是不会修改其打开文件自身的偏移量的。

count 是要在文件描述符之间复制的字节数。

in_fd 参数必须是支持类似 mmap(2) 等 *** 作的文件（即它不能是套接字）。

在 2.6.33 之前的 Linux 内核中， out_fd 必须引用套接字。 从 Linux 2.6.33 开始，它可以是任何文件。 如果它是一个常规文件，则 sendfile() 适当地更改 out_fd 的文件偏移量。

如果传输成功，则返回写入 out_fd 的字节数。 请注意，成功调用 sendfile() 可能会写入比请求更少的字节； 如果有未发送的字节，调用者应该准备重试调用。 另见NOTES。

出错时，返回 -1，并设置 errno 以指示错误。

sendfile() 首次出现在 Linux 2.2 中。 从 glibc 2.1 开始就存在包含文件 <sys/sendfile.h>。

Not specified in POSIX.1-2001, nor in other standards.

Other UNIX systems implement sendfile() with different semantics and prototypes. It should not be used in portable programs.

sendfile() 最多传输 0x7ffff000 (2,147,479,552) 个字节，返回的是实际传输的字节数。 （在 32 位和 64 位系统上都是如此。）

如果您计划使用 sendfile() 将文件发送到 TCP 套接字，但需要在文件内容之前发送一些标头数据，您会发现使用 TCP_CORK 选项很有用，在 tcp(7) 中描述，以最小化 数据包的数量并调整性能。

根据tcp(7)，TCP_CORK的作用是：如果设置，则不发送部分帧。 当再次清除该选项时，将发送所有排队的部分帧。更方便的，可以在执行时send()时设置MSG_MORE标志，见 send(2)

在 Linux 2.4 及更早版本中，out_fd 也可以指普通文件； 这种可能性在 Linux 2.6.x 内核系列中消失了，但在 Linux 2.6.33 中恢复了。

最初的 Linux sendfile() 系统调用不是为了处理大文件偏移量而设计的。 因此，Linux 2.4 添加了 sendfile64()，偏移参数的类型更宽。 glibc sendfile() 包装函数透明地处理内核差异。

在 sendfile() 因 EINVAL 或 ENOSYS 失败的情况下，应用程序可以回退到 read(2)/write(2)。

如果 out_fd 引用了具有零拷贝支持的套接字或管道，则调用者必须确保 in_fd 引用的文件的传输部分保持不变，直到 out_fd 另一端的读取器消耗了传输的数据。

Linux 特定的 splice(2) 调用支持在任意文件描述符之间传输数据，前提是其中一个（或两个）是管道。

---