BSD socket是什么看了就知道

Socket 通常也称作"套接字"，是支持 TCP/IP 协议的网络通信应用的基本操作单元，可以用来实现网间不同虚拟机或不同计算机之间的通信。使用TCP/IP协议的应用程序通过在客户端和服务器各自创建一个 Socket ，然后通过操作各自的 Socket 就可以完成客户端和服务器的连接以及数据传输的任务了。
Socket 的本质是编程接口( API )，是对 TCP/IP 的封装。使开发者不需要面对复杂的 TCP/IP 协议族，只需要调用几个较简单的 Socket API 就可以完成网络通信了。
RT-Thread 中的 SAL 抽象层 提供完整的 BSD Socket 相关 API。
BSD Socket 相关 API

[tr] 名称 作用 [/tr]   

socket	创建一个 socket 套接字
bind	将端口号和 IP 地址绑定带指定套接字上
listen	开始监听
accept	接受连接请求
connect	建立连接
send	面向连接的发送数据（tcp）
recv	面向连接的接收数据（tcp）
sendto	无连接的发送数据（udp）
recvfrom	无连接的接收数据（udp）
closesocket	关闭 socket
shutdown	按设置关闭套接字
gethostbyname	通过域名获取主机的 IP 地址等信息
getsockname	获取本地主机的信息
getpeername	获取连接的远程主机的信息
ioctlsocket	设置套接字控制模式

TCP/UDP

要学用套接字编程，一定要了解 TCP/UDP 协议。TCP/UDP 协议工作在 TPC/IP 协议栈的传输层，如下图所示：

TCP（Transmission Control Protocol 传输控制协议）是一种面向连接的协议，使用该协议时，可以保证客户端和服务端的连接是可靠和安全的。使用 TCP 协议进行通信之前，通信双方必须先建立连接，然后再进行数据传输，通信结束后终止连接。
优点：能保证可靠性、稳定性。
适用场景：TCP适合用于端到端的通信，适用于对可靠性要求较高的服务。
基于 TCP 的 socket 编程流程如下图所示：

UDP（User Datagram Protocol 用户数据报协议）是一种非面向连接的协议，它不能保证网络连接的可靠性。 客户端发送数据之前并不会去服务器建立连接，而是直接将数据打包发送出去。当服务器接收数据时它也不向发送方提供确认信息，如果出现丢失包或重份包的情况，也不会向发送方发出差错报文。
优点：控制选项少，无须建立连接，从而使得数据传输过程中的延迟小、数据传输效率高。
适用场景：UDP适合对可靠性不高，或网络质量有保障，或对实时性要求较高的应用程序。
基于 UDP 的 socket 编程流程如下图所示：

API 详解

socket

使用 socket 通信之前，通信双方都需要各自建立一个 socket。我们通过调用 socket 函数来创建一个 socket 套接字：
int socket(int domain, int type, int protocol)   函数参数
[tr] 参数 描述 [/tr]   

domain	协议域
type	类型
protocol	传输协议
返回	——
> = 0	成功，返回一个代表套接字描述符的整数
< 0	失败

domain 参数支持下列参数：
AF_INET    Ipv4  AF_INET6   Ipv6  AF_UNIX    UNIX 域 AF_UNSPEC  未指定   type 参数支持下列参数：
SOCK_DGRAM   长度固定的、无连接的不可靠的报文传递（UDP） SOCK_RAM     IP 协议的数据报接口 SOCK_STREAM  有序、可靠、双向的面向连接字节流（TCP）   protocol 参数：
通常是 0 ，表示按给定的 domain 和 type 选择默认传输协议。在 AF_INET 通信域中套接字类型 SOCK_STREAM 的默认传输协议是 TCP。在 AF_INET 通信域中套接字类型 SOCK_DGRAM 的默认传输协议是 UDP。
当对同一 domian 和 type 支持多个协议时，可以使用 protocol 参数选择一个特定协议。
函数返回
返回一个 socket 描述符，它唯一标识一个 socket。这个 socket 描述符 跟文件描述符 一样，后续的操作都有用到它，比如，把它作为参数，通过它来进行一些读写操作等。
bind

bind 函数用来将套接字与计算机上的一个端口号相绑定，进而在该端口监听服务请求，该函数的一般形式如下：
int bind(int sockfd, const struct sockaddr *my_addr, socklen_t addrlen)   函数参数
[tr] 参数 描述 [/tr]   

sockfd	要绑定的 socket描述符
my_addr	一个指向含有本机 IP 地址和端口号等信息的 sockaddr 结构的指针
addrlen	sockaddr 结构的长度
返回	——
0	成功
< 0	失败

sockaddr 结构体定义如下:
struct sockaddr {   u8_t sa_len;   u8_t sa_family;   char sa_data[14]; };   在 IPv4 因特网域（AF_INET）中，我们使用 sockaddr_in 结构体来代替 sockaddr 结构体：
struct sockaddr_in {   u8_t            sin_len;   sa_family_t     sin_family;   in_port_t       sin_port;   struct in_addr  sin_addr;   char            sin_zero[SIN_ZERO_LEN]; };   其中，

• sin_family 一般固定写 AF_INET；
• sin_port 为套接字的端口号；
• sin_addr 为套接字的 IP 地址，
• sin_zero 通常全为 0，主要功能是为了与 sockaddr 结构在长度上保持一致。这样指向 sockaddr_in 的指针和指向 sockaddr 的指针可以互相转换。
  

一般情况下，可以将 sin_port 设为 0，这样系统会随机选择一个未被占用的端口号。同样，sin_addr 设为 INADDR_ANY，系统会自动填入本机的 IP 地址。
  注意事项
当调用 bind 函数时，不要将端口号设为小于 1024 的值，因为 1-1024 为系统的保留端口号，我们可以选择大于 1024 的任何一个未被占用的端口号。

listen

listen 函数用来将套接字设为监听模式，并在套接字指定的端口上开始监听，以便对到达的服务请求进行处理。listen 函数的一般形式如下：
int listen(int sockfd, int backlog)   函数参数
[tr] 参数 描述 [/tr]   

sockfd	绑定后的 socket描述符
backlog	连接请求队列可以容纳的最大数目
返回	——
0	成功
< 0	失败

accept

accept 函数用来从完全建立的连接的队列中接受一个连接，它的一般形式如下：
int accept(int sockfd, struct sockaddr *addr, socklen_t *addrlen)   函数参数
[tr] 参数 描述 [/tr]   

sockfd	被监听的 socket 描述符
addr	一个指向 scokaddr_in 结构的指针，存放提出连接请求的主机 IP 地址和端口号等信息
addrlen	一个指向 socklen_t 的指针，用来存放 sockaddr_in 结构的长度
返回	——
> = 0	成功，返回新创建的套接字描述符
< 0	失败

服务端接受连接后，accept 函数会返回一个新的 socket 描述符，线程可以使用这个新的描述符同客户端传输数据。
connect

connect 函数用来与服务器建立一个 TCP 连接，它的一般形式如下：
int connect(int sockfd, const struct sockaddr *serv_addr, socklen_t addrlen)   函数参数
[tr] 参数 描述 [/tr]   

sockfd	socket 描述符
addr	指向 sockaddr 结构的指针，存放要连接的服务器的 IP 地址和端口号等信息
addrlen	sockaddr 结构体的长度
返回	——
> = 0	成功，返回新创建的套接字描述符
< 0	失败

send

send 函数用来在面向连接的数据流 socket 模式下发送数据，send 函数的一般形式如下：
int send(int sockfd, const void *msg, size_t len, int flags)   函数参数
[tr] 参数 描述 [/tr]   

sockfd	socket 描述符
msg	指向所要发送的数据区的指针
len	要发送的字节数
flags	控制选项，通常为 0
返回	——
>0	成功，返回发送的数据的长度
<=0	失败

如果返回值小于 len 的话，你需要再次发送剩下的数据。
recv

recv 函数用来在面向连接的数据流 socket 模式下接收数据，recv 函数的一般形式如下：
int recv(int sockfd, void *buf, size_t len, int flags)   函数参数
[tr] 参数 描述 [/tr]   

sockfd	socket 描述符
msg	指向存储数据的内存缓存区的指针
len	缓冲区的长度
flags	控制选项，通常为 0
返回	——
> 0	成功，返回接收的数据的长度
= 0	目标地址已传输完并关闭连接
< 0	失败

sendto

sendto 函数用来在无连接的数据报 socket 模式下发送数据，sendto 函数的一般形式如下：
int sendto(int sockfd, const void *msg, size_t len, int flags, const struct sockaddr *to, socklen_t tolen)   函数参数
[tr] 参数 描述 [/tr]   

sockfd	socket 描述符
msg	指向所要发送的数据区的指针
len	要发送的字节数
flags	控制选项，通常为 0
to	指向 sockaddr 结构体的指针，存放目的主机的 IP 和端口号
tolen	sockaddr 结构体的长度
返回	——
> 0	成功，返回发送的数据的长度
< = 0	失败

recvfrom

recvfrom函数用来在无连接的数据报 socket 模式下接收数据，recvfrom 函数的一般形式如下：
int recvfrom(int sockfd, void*buf, size_t len, int flags, struct sockaddr *from, socklen_t *fromlen)   函数参数
[tr] 参数 描述 [/tr]   

sockfd	socket 描述符
msg	指向存储数据的内存缓存区的指针
len	缓冲区的长度
flags	控制选项，通常为 0
from	指向 sockaddr 结构体的指针，存放源主机的 IP 和端口号
fromlen	指向 sockaddr 结构体的长度的指针
返回	——
> 0	成功，返回接收的数据的长度
= 0	目标地址已传输完并关闭连接
< 0	失败

closesocket

closesocket 在传输完数据之后关闭 socket  并释放资源的函数，closesocket 函数的一般形式如下：
int closesocket(int sockfd)   函数参数
[tr] 参数 描述 [/tr]   

sockfd	socket 描述符
返回	——
0	成功
< 0	失败

shutdown

shutdown 允许进行单向的关闭操作，或是全部禁止掉，shutdown 函数的一般形式如下：
int shutdown(int sockfd, int how)   函数参数
[tr] 参数 描述 [/tr]   

sockfd	socket 描述符
how	控制选项
返回	——
0	成功
< 0	失败

how 参数支持下列参数：
SHUT_RD     关闭接收信道  SHUT_WR     关闭发送信道  SHUT_RDWR   将发送和接收信道全部关闭   函数返回
返回 0 表示成功
gethostbyname

此函数可以通过域名来获取主机的 IP 地址等信息，它的一般形式如下：
struct hostent* gethostbyname(const char*name)   函数参数
[tr] 参数 描述 [/tr]   

name	主机域名
返回	——
> 0	成功，返回一个 hostent 结构体指针
< 0	失败

name 可以是具体域名，如：“www.rt-thread.org”，也可以是 IP 地址，如：“192.168.2.56”
hostent 结构体定义如下：
struct hostent {     char  *h_name;      /* 主机正式域名 */     char **h_aliases;   /* 主机的别名数组 */     int    h_addrtype;  /* 协议类型，对于 TCP/IP 为 AF_INET  */     int    h_length;    /* 协议的字节长度，对于 IPv4 为 4 个字节 */     char **h_addr_list; /* 地址的列表*/ #define h_addr h_addr_list[0] /* 保持向后兼容 */ };   getsockname

此函数可以获取本地主机的信息，它的一般形式如下：
int getsockname(int sockfd, struct sockaddr *name, socklen_t *namelen)   函数参数
[tr] 参数 描述 [/tr]   

sockfd	socket 描述符
name	sockaddr 结构体指针，用来存储得到的主机信息
namelen	指向 sockaddr 结构体的长度的指针
返回	——
0	成功
< 0	失败

getpeername

此函数可以得到与本地主机连接的远程主机的信息，它的一般形式如下：
int getpeername(int socket, struct sockaddr *name, socklen_t *namelen)   函数参数
[tr] 参数 描述 [/tr]   

sockfd	socket 描述符
name	sockaddr 结构体指针，用来存储得到的主机信息
namelen	指向 sockaddr 结构体的长度的指针
返回	——
0	成功
< 0	失败

ioctlsocket

设置套接字控制模式，它的一般形式如下：
int ioctlsocket(int sockfd, long cmd, void *arg)   函数参数
[tr] 参数 描述 [/tr]   

sockfd	socket 描述符
cmd	套接字操作命令
arg	操作命令所带参数
返回	——
0	成功
< 0	失败

cmd 参数支持下列参数：
FIONBIO  开启或关闭套接字的非阻塞模式，arg 参数为 1 开启非阻塞，为 0 关闭非阻塞。    注意事项
在网络中都采用大端字节序，但是不同的嵌入式系统，其字节序不一定都是大端格式，相反小端字节序倒是很常见，比如 STM32。我们在设置 IP 和端口号时，要根据自己的平台特点进行必要的字节序转换。

下面给出套接字字节转换函数的列表：
htons() —— "Host to Network Short"  主机字节顺序转换为网络字节顺序 htonl() —— "Host to Network Long"   主机字节顺序转换为网络字节顺序 ntohs() —— "Network to Host Short"  网络字节顺序转换为主机字节顺序 ntohl() —— "Network to Host Long"   网络字节顺序转换为主机字节顺序   对于一个“192.168.2.1”这种字符串形式的 IP 地址，我们如何将其正确的转换为网络字节序呢？
可以使用 inet_addr（“192.168.2.1”），结果直接就是网络字节序了；
我们也可以使用 inet_ntoa()（“ntoa”代表“Network to ASCII”）函数将一个长整形的 IP 地址转换为一个字符串。