Windows 和 Linux 上常用的 socket API 函数并不多，除了特定操作系统提供的一些基于自身系统特性的 API， 大多数 Socket API 都源于**BSD Socket** （即**伯克利套接字**（**Berkeley Sockets**）），因此这些 socket 函数在不同的平台有着相似的签名和参数。

经常有想学习网络编程的新人询问要掌握哪些基础的socket API，我这里给一个简单的函数列表，列表中给出的都是应该熟练掌握的 socket 函数。

​ 常用 Berkeley Sockets API 一览表

| 函数名称 | 函数简单描述 | 附加说明 |

| :-----------: | :--------------------------------------: | :--------------------------------: |

| socket | 创造某种类型的套接字 | |

| bind | 将一个 socket 绑定一个ip与端口的二元组上 | |

| listen | 将一个 socket 变为侦听状态 | |

| connect | 试图建立一个 TCP 连接 | 一般用于客户端 |

| accept | 尝试接收一个连接 | 一般用于服务端 |

| send | 通过一个socket发送数据 | |

| recv | 通过一个socket收取数据 | |

| select | 判断一组socket上的读事件 | |

| gethostbyname | 通过域名获取机器地址 | |

| close | 关闭一个套接字，回收该 socket 对应的资源 | Windows 系统中对应的是 closesocket |

| shutdown | 关闭 socket 收或发通道 | |

| setsockopt | 设置一个套接字选项 | |

| getsockopt | 获取一个套接字选项 | |

对于某个 socket 函数，如果你想查看它的用法，可以通过相应的帮助文档。

如果是 Linux 系统，你可以通过 man 手册去查看相应的函数签名和用法。举个例子，如果你要查看 connect 函数的用法，只需要在 Linux shell 终端输入 **man connect** 即可。

如上面的代码片段所示，man手册对于一个函数的说明一般包括如下几部分：

- 函数声明及相关数据结构所在的头文件，你实际编码时如果需要使用这个函数必须包含该头文件；

- 函数的签名，即该函数的参数类型、个数和返回值；

- 函数用法说明，并可能包括一些注意事项；

- 函数返回值说明；

- 调用函数出错可能得到的错误码值；

- 一些相关函数在 man 手册的位置索引。（connect 没有这个部分）

如下图所示：


需要注意的是，这个方法不仅可以查 socket 函数也可以查看 Linux 下其他通用函数（如 fread）甚至一个 shell 命令（如 sleep）。以 sleep 为例，如果你想查程序中 sleep 函数的用法，由于Linux 内置有一个叫 sleep 的 shell 命令，如果你在 shell 窗口直接输入 **man sleep**，显示出来的默认会是 sleep 命令而不是我们要的 sleep 函数的帮助信息。


我们可以通过 **man man** 命令查看一下 man 手册组成部分：

通过上面的代码片段，我们可以看出来，man 手册的内容总共有9部分组成，而 sleep 函数属于上面的 Section 3，所以我们输入 **man 3 sleep** 就可以查看 sleep 函数的帮助信息了：

Windows 也有类似 man 手册的帮助文档，早些年 Visual Studio 会自带一套离线的 MSDN 文档库，其优点就是不需要电脑联网，缺点是占磁盘空间比较大，内容陈旧。在手机网络都如此普及的今天，笔者还是建议使用在线版本的 MSDN。查看 Windows API 的帮助链接是：https://docs.microsoft.com/en-us/windows/desktop/，在页面的搜索框中输入你想要搜索的 API 函数即可。


我们还是以 connect 函数为例，在上述页面的搜索框中输入 **socket connect** ，然后回车，得到一组搜索结果，我们选择我们需要的页面，打开链接：https://docs.microsoft.com/en-us/windows/desktop/api/winsock2/nf-winsock2-connect。与简陋的 man 手册相比，MSDN 关于connect 函数的说明就比较详细了，大体也分为以下几部分：

1. **Syntax**， 即函数签名，函数的参数类型、个数和返回值；

2. **Parameters**，参数的用法详细说明；

3. **Return Value**， 函数的返回值说明，在返回值部分，还有如果函数调用失败详细的错误码说明信息；

4. **Remarks**，这部分就是该函数的详细用法说明，某些函数还会给出示例代码；

5. **Requirements**，这部分指的是要使用这个函数，操作系统的版本要求，代码需要引入的头文件和库文件（如果有的话）。

6. **See Also**， 这部分一般是一些相关函数和知识点的链接信息。

需要注意的是，在 MSDN 上阅读相关 API 的帮助信息时，你要辩证性地对待其提供的信息，因为很多函数的实际工作原理和行为并不一定如 MSDN 介绍的那样。所以在有些 API 帮助下面会有一些读者的评论信息，这些评论信息或对文档内容做一些补充或纠错，或给出一些代码示例。建议读者实际查阅时，留意一下这部分信息，或许能得到一些很有用的帮助。

本书不会逐一介绍每个 socket 函数的基本用法，因为已经有大量的网络编程书籍介绍过了，这里就不再赘述。当然，这并不是说明它们不重要，相反**读者应该认真地把每一个函数的用法都学会**。但是关于这些函数的一些重要使用事项和原理我们还是要重点介绍一下。让我们开始吧。

**本文首发于『<font color=red>easyserverdev</font>』公众号，欢迎关注，转载请保留版权信息。**

**欢迎加入高性能服务器开发 QQ 群一起交流：<font color=red> 578019391 </font>。**