1.socket函数
函数作用:创建一个socket
函数原型:int socket(int family, int type, int protocol);
参数:
Family:一个地址描述。目前仅支持AF_INET格式,也就是说ARPA Internet地址格式。对于IPv4,family参数指定为AF_INET
type:新套接口的类型描述。
对于TCP协议,type参数指定SOCK_STREAM,表示面向流的传输协议如果是UDP协议,则type参数指定为SOCK_DGRAM,表示面向数据报的传输协议
protocol:套接口所用的协议。如调用者不想指定,可用0指定,表示缺省。
返回值:
2.bind函数
函数作用:用于绑定IP地址和端口号到socket
函数原型:int bind( int sockfd , const struct sockaddr * my_addr, socklen_t addrlen);
参数:
Sockfd:已经建立的socket编号(描述符);
my_addr:是一个指向sockaddr结构体类型的指针;
Addrlen:my_addr结构的长度,可以用sizeof函数获得。
sockaddr:标识一未捆绑套接口的描述字。
sockaddr结构定义如下:
struct sockaddr{
u_short sa_family;
char sa_data[14];
};
返回值:返回:成功返回0,失败返回-1。
sockaddr_in 初始化:
bzero(&servaddr, sizeof(servaddr));
servaddr.sin_family = AF_INET;
servaddr.sin_addr.s_addr = htonl(INADDR_ANY);
servaddr.sin_port = htons(SERV_PORT);
首先将整个结构体清零,然后设置地址类型为AF_INET,网络地址为INADDR_ANY,这个宏表示本地的任意IP地址,因为服务器可能有多个网卡,每个网卡也可能绑定多个IP地址,这样设置可以在所有的IP地址上监听,直到不某个客户端建立了连接时才确定下来到底用哪个IP地址,端口号为SERV_PORT
3.listen函数
函数作用:设置能处理的最大连接要求,Listen()并未开始接收连线,只是设置socket为listen模式。
函数原型:int listen(SOCKET sockfd, int backlog);
参数:
sockfd 一个已绑定未被连接的套接字描述符
backlog 连接请求队列(queue of pending connections)的最大长度(一般由2到4)。
返回值:无错误,返回0,
否则,返回SOCKET ERROR,可以调用函数WSAGetLastError取得错误代码。
4.accept函数
函数作用:用来接受socket连接。
函数原型:int accept(int sockfd, struct sockaddr *addr, socklen_t *addrlen);
参数:
sockfd:套接字描述符,该套接口在listen()后监听连接。
addr:(可选)指针,指向一缓冲区,其中接收为通讯层所知的连接实体的地址。Addr参数的实际格式由套接口创建时所产生的地址族确定。
addrlen:(可选)指针,输入参数,配合addr一起使用,指向存有addr地址长度的整型数。
返回值:如果没有错误产生,则accept()返回一个描述所接受包的SOCKET类型的值。否则的话,返回INVALID_SOCKET错误,应用程序可通过调用WSAGetLastError()来获得特定的错误代码。
5.connect函数
函数作用: 该函数用于绑定之后的client端与服务器建立连接
函数原型:int connect(int s, const struct sockaddr *name, socklen_t namelen);
参数:
s:标识一个未连接socket
name:指向要连接套接字的sockaddr结构体的指针
namelen:sockaddr结构体的字节长度
返回值:成功则返回0, 失败返回-1
6.send函数
函数作用:用于向一个已经连接的socket发送数据
函数原型:int send( SOCKET s, const char FAR* buf, int len, int flags);
参数:
s:一个用于标识已连接套接口的描述字。
buf:包含待发送数据的缓冲区。
len:缓冲区中数据的长度。
flags:调用执行方式。
返回值:
成功,send()返回所发送数据的总数(请注意这个数字可能小于len中所规定的大小)。
出错,返回SOCKET_ERROR错误,应用程序可通过WSAGetLastError()获取相应错误代码。
7.recv函数
函数原型:int recv( SOCKET s,char FAR *buf,int len,int flags);
函数作用:不论是客户还是服务器应用程序都用recv函数从TCP连接的另一端接收数据。
参数:
s:接收端套接字描述符;
buf:指明一个缓冲区,该缓冲区用来存放recv函数接收到的数据;
len:指明buf的长度;
flags:一般置0。
返回值:
成功,返回其实际copy的字节数。
如果recv在copy时出错,那么它返回SOCKET_ERROR;
如果recv函数在等待协议接收数据时网络中断了,那么它返回0
8.sendto函数
函数原型:int sendto ( socket s , const void * msg, int len, unsigned int flags, const struct sockaddr * to , int tolen ) ;
函数作用:sendto() 用来将数据由指定的socket传给对方主机。
参数:
S:已建好连线的socket,如果利用UDP协议则不需经过连线操作。
Msg:指向欲连线的数据内容,参数flags 一般设0,详细描述请参考send()。
To:用来指定欲传送的网络地址,结构sockaddr请参考bind()。
Tolen:sockaddr的结构长度。
返回值:成功则返回实际传送出去的字符数,失败返回-1,错误原因存于errno 中。
9.recvfrom函数
函数作用:用于从(已连接)套接口上接收数据,并捕获数据发送源的地址
函数原型int recvfrom( SOCKET s, char FAR* buf, int len, int flags,
struct sockaddr FAR* from, int FAR* fromlen);
参数:
s:标识一个已连接套接口的描述字。
buf:接收数据缓冲区。
len:缓冲区长度。
flags:调用操作方式。
from:(可选)指针,指向装有源地址的缓冲区。
fromlen:(可选)指针,指向from缓冲区长度值。
返回值:若无错误发生,recvfrom()返回读入的字节数。如果连接已中止,返回0。否则的话,返回SOCKET_ERROR错误,应用程序可通过WSAGetLastError()获取相应错误代码。