我发现 Linux 文档写错了

作者：小林coding

图解计算机基础网站：https://xiaolincoding.com

大家好，我是小林。

周末的时候，有位读者疑惑为什么 Linux man 手册中关于 netstat 命令中的 tcp listen 状态下的 Recv-Q 和 Send-Q 这两个信息的描述跟我的图解网络写的不一样？

我看了源码后，确认了这个 man 手册写的不对。没想到 Linux 的 man 手册也会出错。

首先，先给大家介绍下 netstat 命令。netstat 命令是查看网络状态很常见的 Linux 命令。

比如，如果我们想查看系统中的进程监听了哪些 TCP 端口，则可以使用下面这个命令：

接下来，小林带大家分析，为什么我说 man 手册写错了 netstat 命令中 Recv-Q 和 Send-Q 的描述？

疑惑提出

读者提出的疑惑：我先给大家翻译一下，man 手册（https://man7.org/linux/man-pages/man8/netstat.8.html）是怎么说的：

Recv-Q：如果 TCP 连接状态处于 Established，Recv-Q 的数值表示接收缓冲区中还没拷贝到应用层的数据大小；如果 TCP 连接状态处于 Listen 状态，Recv-Q 的数值表示当前 syn 半连接队列的大小（自内核版本 2.6.18 起）
Send-Q：如果 TCP 连接状态处于 Established，Send-Q的数值表示发送缓冲区中已发送但未被确认的数据大小；如果 TCP 连接状态处于 Listen 状态，Send-Q 的数值表示 syn 半连接队列的容量（自内核版本 2.6.18 起）。

而我通过查阅内核 2.6.18 版本的源码，得到的结论如下：

Recv-Q：如果 TCP 连接状态处于 Established，Recv-Q 的数值表示接收缓冲区中还没拷贝到应用层的数据大小；如果 TCP 连接状态处于 Listen 状态，Recv-Q 的数值表示当前 syn 半连接队列的大小当前全连接队列的大小；
Send-Q：如果 TCP 连接状态处于 Established，Send-Q的数值表示发送缓冲区中已发送但未被确认的数据大小；如果 TCP 连接状态处于 Listen 状态，Send-Q 的数值表示 syn 半连接队列的容量

上面被我划掉的部分，就是我与 man 手册差异的地方。

什么是 TCP 半连接队列和全链接队列？

在 TCP 三次握手的时候，Linux 内核会维护两个队列，分别是：

半连接队列，也称 SYN 队列；
全连接队列，也称 accept 队列；

服务端收到客户端发起的 SYN 请求后，内核会把该连接存储到半连接队列，并向客户端响应 SYN+ACK，接着客户端会返回 ACK，服务端收到第三次握手的 ACK 后，内核会把连接从半连接队列移除，然后创建新的完全的连接，并将其添加到全连接队列，等待进程调用 accept 函数时把连接取出来。

如果你想知道 TCP 半连接和全连接溢出会发生什么？可以看看这篇文章：TCP 半连接队列和全连接队列满了会发生什么？又该如何应对？

源码分析

netstat 工具在获取 TCP 连接的信息的时候，实际上是读取了 /proc/net/tcp 文件里的数据，而这个文件的数据是由内核由 net/ipv4/tcp_ipv4.c 文件中的 tcp4_seq_show() 函数打印的。

所以，我们直接看 tcp4_seq_show() 函数是根据什么信息打印出 Recv-Q 和 Send-Q 的数据。

有一个网站可以在线看 Linux 内核代码：https://elixir.bootlin.com/，每个内核版本的代码都有，平常我都是在这里看。

这次，我们选择内核版本为 2.6.18 查看 tcp4_seq_show() 函数的实现，如下：

static int tcp4_seq_show(struct seq_file *seq, void *v)
{
 .....

 switch (st->state) {
 case TCP_SEQ_STATE_LISTENING:
 case TCP_SEQ_STATE_ESTABLISHED:
  get_tcp4_sock(v, tmpbuf, st->num);
  break;
 .......
 }
 ...
 return 0;
}

我们只分析 tcp 连接状态为 ESTABLISHED 和 LISTENING 时打印的信息，所以接下来看 get_tcp4_sock 函数。

get_tcp4_sock 函数中，打印信息的代码如下：我在图中标红了两行代码，这两行代码分别是 Recv-Q 和 Send-Q 的数据。

我单独把这两行代码抽了出来：

// Send-Q 打印的数据
tp->write_seq - tp->snd_una,

//Recv-Q 打印的数据
(sp->sk_state == TCP_LISTEN) ? sp->sk_ack_backlog : (tp->rcv_nxt - tp->copied_seq),

可以看到，不管 TCP 连接状态是什么， Send-Q 都是发送缓冲区中已发送但未被确认的数据大小。

然后针对 Recv-Q ，在 TCP 连接状态为 LISTEN 时，打印的是 sk_ack_backlog 的值。

那 sk_ack_backlog 的值代表什么意思呢？

下面这个是判断全连接队列是否溢出的函数：可以得知，sk_ack_backlog 其实是当前全连接队列的大小，也就是经历三次握手后等待被应用层 accpet() 的连接的数量。

所以，从上面的源码分析过，得到的结论如下：

netstat 命令中的 Recv-Q：如果 TCP 连接状态处于 Established，Recv-Q 的数值表示接收缓冲区中还没拷贝到应用层的数据大小；如果 TCP 连接状态处于 Listen 状态，Recv-Q 的数值表示当前全连接队列的大小；
netstat 命令中的 Send-Q：表示发送缓冲区中已发送但未被确认的数据大小（不管 TCP 是 Listen 状态还是 Established 状态都表示这个意思）；

好了，至此就分析完了。

最后

看到这，大家肯定会说：小林你太强了吧，为什么对 Linux 内核源码那么熟，这都能分析出来。

其实，我并没有熟读过 Linux 内核源码啦，其实只要大家有好奇心，其实你也能分析出来。

我也是通过网上的资料，一点一点分析出来的，并不是直接就在内核源码里查，不然那真是大海捞针。

我是这样一步一步查资料分析的：

先网上查下 netstat 源码，看是根据什么信息打印 Send-Q 和 Recv-Q，然后看到网上有人说是读 /proc/net/tcp 这个文件；
接着，就网上查 /proc/net/tcp 这个文件是怎么打印的，然后看到网上有人说是由 net/ipv4/tcp_ipv4.c 文件中的 tcp4_seq_show() 函数打印的；
最后，再自己去看 tcp4_seq_show 函数的实现，这个函数的代码也不多，就几十行，所以很容易就分析出来了。

你看，其实我也是通过「搜索」一步一步分析出来的，其实并没有什么难度。

只是我比较细节一点。