基本套接字函数
1.socket函数原型
socket(建立一个socket文件描述符)
-
所需头文件
#include <sys/types.h>
#include <sys/socket.h>
-
函数说明:建立一个socket文件描述符
-
函数原型
int socket(int domain, int type, int protocol)
- 函数传入值:domain
type:协议类型
AF_INET:IPv4协议
AF_INET6:IPv6协议
AF_LOCAL:Unix域协议
AF_ROUTE:路由套接口
AF_KEY:密钥套接口
protocol
SOCKET_STREAM:双向可靠数据流,对应TCP
SOCKET_DGRAM:双向不可靠数据报,对应UDP
SOCKET_RAW:提供传输层以下的协议,可以访问内部网络接口,例如接收和发送ICMP报文
type为SOCKET_RAW时需要设置此值说明协议类型,其他类型设置为0即可
- 函数返回值
成功:socket文件描述符
失败:-1,失败原因存于error中
2.bind函数原型
bind(将一个本地协议地址与socket文件描述符联系起来)
- 所需头文件
#include <sys/types.h>
#include <sys/socket.h>
-
函数说明:将一个协议地址与socket文件描述符联系起来
-
函数原型:
int bind(int sockfd, const struct sockaddr *addr, socklen_t addrlen)
-
函数传入值:sockfd
socket文件描述符
addr : my_addr指向sockaddr结构,该结构中包含IP地址和端口等信息
addrlen : sockaddr结构的大小,可设置为sizeof(struct sockaddr)
- 函数返回值
成功:0
失败:-1,失败原因存于error中
利用bind函数绑定地址时,可以指定IP地址和端口号,也可以指定其中之一,甚至一个也不指定。可以使用通配地址INADDR_ANY(为宏定,义其值等于0),它通知内核选择IP地址。
3.listen函数原型
listen (等待连接)
- 所需头文件
#include <sys/types.h>
#include <sys/socket.h>
-
函数说明:等待连接
-
函数原型
int listen(int sockfd, int backlog)
-
函数传入值:sockfd
监听socket文件描述符
backlog:套接字排队的最大连接个数
函数返回值
成功:0
失败:-1,失败原因存于error中
特别说明
对于监听socket文件描述符sockfd,内核要维护两个队列,分别为未完成连接队列和已完成连接队列,这两个队列之和不超过backlog
4.connect函数原型
connect(建立socket连接)
- 所需头文件
#include <sys/types.h>
#include <sys/socket.h>
-
函数说明:建立socket连接
-
函数原型
int connect(int sockfd, const struct sockaddr *serv_addr, socklen_t addrlen)
- 函数传入值:sockfd
socket文件描述符
serv_addr : 连接的网络地址和端口
addrlen : sockaddr结构的大小,可设置为sizeof(struct sockaddr)
- 函数返回值
成功:0
失败:-1,失败原因存于error中
附加说明
函数connect激发TCP的三路握手过程,出错返回有以下几种情况:
① 如果客户没有收到SYN分节的响应(总共75秒,这之间可能重发了若干次SYN),则返回ETIMEDOUT
② 如果对客户的SYN的响应是RST,则表明该服务器主机在指定的端口上没有进程在等待与之相连,函数返回错误ECONNREFUSED
③ 如果客户发出的SYN在中间路由器上引发一个目的地不可达的ICMP错误,内核返回EHOSTUNREACH或ENETUNREACH错误(即ICMP错误)给进程
5.accept函数原型
accept(接受socket连接)
- 所需头文件
#include <sys/types.h>
#include <sys/socket.h>
-
函数说明 : 接受socket连接,返回一个新的socket文件描述符,原socket文件描述符仍为listen函数所用,而新的socket文件描述符用来处理连接的读写操作
-
函数原型
int accept(int sockfd, struct sockaddr *addr, socklen_t *addrlen)
- 函数传入参数
sockfd: socket文件描述符
addrlen:addr的大小,可设置为sizeof(struct sockaddr)
- 函数传出参数
addr:填入远程主机的地址数据
- 函数返回值
成功:实际读取字节数
失败:-1,错误代码存放在error中
附加说明
① accept函数由TCP服务器调用,为阻塞函数,从已完成连接的队列中返回一个连接;如果该对列为空,则进程进入阻塞等待
② 函数返回的套接字为已连接套接字,而监听套接字仍为listen函数所用
6.close函数原型
close (关闭连接的socket文件描述符)
- 所需头文件
#include <unistd.h>
-
函数说明 : 关闭连接的socket文件描述符
-
函数原型
int close(int sockfd)
- 函数传入值
sockfd:socket文件描述符
- 函数返回值
成功:0
失败:-1,失败原因存于error中
附加说明
① close函数默认功能是将套接字置为“已关闭”标记,并立即返回给进程,这个套接字不能再为该进程所用
② 正常情况下,close将引发四个分节终止序列,但在终止前将发送已排队的数据
③ 如果套接字描述符访问计数在调用close后大于0(多个进程共享同一个套接字的情况下),则不会引发TCP终止序列(即不会发送FIN分节)
7.shutdown函数原型
shutdown(终止socket通信)
- 所需头文件
#include <sys/socket.h>
-
函数说明 : 终止socket通信
-
函数原型
int shutdown(int s, int how)
- 函数传入值 : s
socket文件描述符
how
0(SHUT_RD):关闭socket连接的读这一半,不再接收套接字中的数据且现留在收缓冲区的数据作废
1(SHUT_WR):关闭socket连接的写这一半(半关闭),但留在套接字发送缓冲区中的数据都会被发送,后跟TCP连接终止序列,不管访问计数是否大于0,此后将不能再执行对套接字的任何写操作
2(SHUT_RDWR):socket连接的读、写都关闭
- 函数返回值
成功:0
失败:-1,失败原因存于error中
8.read函数原型
read(从打开的socket文件流中读取数据)
-
所需头文件
#include <unistd.h>
-
函数说明 : 从打开的socket文件流中读取数据,这里仅说明此函数应用于socket的情况
-
函数原型
ssize_t read(int fd, void *buf ,size_t count)
- 函数传入参数
fd: socket文件描述符
count:最大读取字节数
- 函数传出参数
buf:读取数据的首地址
- 函数返回值
成功:实际读取字节数
失败:-1,错误代码存放在error中
附加说明
调用函数read从socket文件流中读取数据时,有如下几种情况:
① 套接字接收缓冲区接收数据,返回接收到的字节数
② TCP协议收到FIN数据,返回0
③ TCP协议收到RST数据,返回-1,同时errno设置为ECONNRESET
④ 进程阻塞过程中接收到信号,返回-1,同时errno设置为EINTR
9.write函数原型
write(向socket文件流中写入数据)
- 所需头文件
#include <unistd.h>
-
函数说明 : 向socket文件流中写入数据,这里仅说明此函数应用于socket的情况
-
函数原型
ssize_t write (int fd,const void *buf,size_t count)
- 函数传入参数
fd: socket文件描述符
buf:写入数据的首地址
count:最大写入字节数
- 函数返回值
成功:实际写入的字节数
失败:-1,错误代码存放在error中
附加说明
调用函数write向socket文件流写数据时,有如下几种情况:
① 套接字发送缓冲区有足够空间,返回发送的字节数
③ TCP协议收到RST数据,返回-1,同时errno设置为ECONNRESET
④ 进程阻塞过程中接收到信号,返回-1,同时errno设置为EINTR