socket函数手册

序分组)

protocol - 0为给定family和type组合的系统默认值

返回：成功- 套接口描述字，失败- -1 */

int socket(int family,int type,int protocol);

/** TCP客户端与TCP服务器建立连接，调用此函数会触发TCP的三次握手，并建立连接。调用此函数前，不必调用bind函数，内核会决定源IP并选择一个临时端口作为源端口。

* 参数：

sockfd - 套接口描述字

servaddr - 包含要连接的服务器的IP和端口号的套接口地址结构

addrlen - servaddr套接口地址结构体的大小

返回：成功- 0，失败- -1*/

int connect(int sockfd,const struct sockaddr*servaddr,socklen_t addrlen);

/** 将一个本地协议地址赋给套接口

参数：

sockfd - 套接口描述字

myaddr - 绑定的本地协议地址，对于网际协议，即IP地址和端口，如果IP地址赋值为INADDR_ANY(通配地址wildcard)，则由内核去选择IP地址，如果端口赋值为0，则由内核选择一个临时端口

addrlen - 地址结构体的大小

返回：成功- 0，失败- -1*/

int bind(int sockfd,const struct sockaddr*myaddr,socklen_t addrlen);

/* * 指示内核接受一个未连接的套接口上的连接请求

* 参数：

sockfd - 套接口描述字

backlog - 套接口两个队列（完成连接和未完成连接）的排队最大连接个数，各个操作系统有不同的根据backlog计算排队最大连接个数的算法返回：成功- 0，失败- -1*/

int listen(int sockfd,int backlog);

/* * 从已完成连接队列对头返回一个已完成连接，如果已完成连接队列为空，那么进程被阻塞(假设套接口为缺省的阻塞方式)

* 参数：

sockfd - 监听套接口描述字

cliaddr - 输出参数，返回已连接的客户端的协议地址，为NULL，则不返回

addrlen - 输出参数，返回套接口地址结构体的大小，为NULL，则不返回

返回：

成功- 已连接套接口描述字(由内核自动生成的一个新描述字，代表与所返回客户端的TCP连接)

失败- -1，EINTER - 收到中断 */

int accept(int sockfd,struct sockaddr*cliaddr,socklen_t*addrlen);

#include<>

/* * 关闭套接口，并终止TCP连接，如果为并发服务器父进程关闭已连接套接口，会将相应描述字的引用计数减一，如果计数不为0，将不会发送FIN

参数：sockfd - 套接口描述字

返回：成功- 0，失败- -1

*/

int send( SOCKET s, const char FAR *buf, int len, int flags );

不论是客户还是服务器应用程序都用send函数来向TCP连接的另一端发送数据。

客户程序一般用send函数向服务器发送请求，而服务器则通常用send函数来向客户程序发送应答。

该函数的第一个参数指定发送端套接字描述符；

第二个参数指明一个存放应用程序要发送数据的缓冲区；

第三个参数指明实际要发送的数据的字节数；

第四个参数一般置0。

这里只描述同步Socket的send函数的执行流程。当调用该函数时，send先比较待发送数据的长度len和套接字s的发送缓冲的长度，如果len大于s 的发送缓冲区的长度，该函数返回SOCKET_ERROR；如果len小于或者等于s的发送缓冲区的长度，那么send先检查协议是否正在发送s的发送缓冲中的数据，如果是就等待协议把数据发送完，如果协议还没有开始发送s的发送缓冲中的数据或者s的发送缓冲中没有数据，那么send就比较s的发送缓冲区的剩余空间和len，如果len大于剩余空间大小send就一直等待协议把s的发送缓冲中的数据发送完，如果len小于剩余空间大小send就仅仅把buf中的数据copy到剩余空间里（注意并不是send把s的发送缓冲中的

数据传到连接的另一端的，而是协议传的，send仅仅是把buf中的数据copy 到s的发送缓冲区的剩余空间里）。如果send函数copy数据成功，就返回实际copy的字节数，如果send在copy数据时出现错误，那么send就返回SOCKET_ERROR；如果send在等待协议传送数据时网络断开的话，那么send 函数也返回SOCKET_ERROR。

要注意send函数把buf中的数据成功copy到s的发送缓冲的剩余空间里后它就返回了，但是此时这些数据并不一定马上被传到连接的另一端。如果协议在后续的传送过程中出现网络错误的话，那么下一个Socket函数就会返回SOCKET_ERROR。（每一个除send外的Socket函数在执行的最开始总要先等待套接字的发送缓冲中的数据被协议传送完毕才能继续，如果在等待时出现网络错误，那么该Socket函数就返回SOCKET_ERROR）

注意：在Unix系统下，如果send在等待协议传送数据时网络断开的话，调用send的进程会接收到一个SIGPIPE信号，进程对该信号的默认处理是进程终止。

通过测试发现，异步socket的send函数在网络刚刚断开时还能发送返回相应的字节数，同时使用select检测也是可写的，但是过几秒钟之后，再send 就会出错了，返回-1。select也不能检测出可写了。

int recv( SOCKET s, char FAR *buf, int len, int flags );

不论是客户还是服务器应用程序都用recv函数从TCP连接的另一端接收数据。

该函数的第一个参数指定接收端套接字描述符；

第二个参数指明一个缓冲区，该缓冲区用来存放recv函数接收到的数据；第三个参数指明buf的长度；

UDP套接口函数

#include

/*

* 接收UDP报文

* 参数：

sockfd - 套接字

buff - 指向接收缓存的地址

nbytes - 接收字节数

flags -

from - 返回UDP报文发送者的套接口地址

addrlen - 返回from套接口地址的大小

* 返回：成功返回接收的字节数，出错返回-1

*/

ssize_t recvfrom(int sockfd,void*buff,size_t nbytes,int flags,struct sockadd r*from,socklen_t*addrlen);

/*

* 发送UDP报文

* 参数：

sockfd - 套接字

buff - 指向发送缓存的地址

nbytes - 发送字节数

flags -

to - UDP报文接收者的套接口地址

addrlen - to套接口地址的大小

* 返回：成功返回发送的字节数，出错返回-1

*/

ssize_t sendto(int sockfd,void*buff,size_t nbytes,int flags,const struct sock addr*to,socklen_t addrlen);