1 struct sockaddr 2 {
3 unsigned short int sa_family; 4 char sa_data[14]; 5 };
sa_family 为调用socket()时的domain参数,即AF_xxxx值。 sa_data 最多使用14个字符长度。
此sockaddr结构会因使用不同的socket domain而有不同结构定义,例如使用AF_INET domain,其socketaddr结构定义便为
1 struct socketaddr_in 2 {
3 unsigned short int sin_family; 4 uint16_t sin_port; 5 struct in_addr sin_addr; 6 unsigned char sin_zero[8]; 7 };
8 struct in_addr 9 {
10 uint32_t s_addr; 11 };
sin_family 即为sa_family sin_port 为使用的port编号 sin_addr.s_addr 为IP 地址 sin_zero 未使用。 参数
addrlen为sockaddr的结构长度。 返回值
成功则返回0,失败返回-1,错误原因存于errno中。 错误代码
EBADF 参数sockfd 非合法socket处理代码。 EACCESS 权限不足
ENOTSOCK 参数sockfd为一文件描述词,非socket。 3、connect(建立socket连线)
头文件
1 #include
定义函数
1 int connect (int sockfd,struct sockaddr * serv_addr,int addrlen);
函数说明
connect()用来将参数sockfd 的socket 连至参数serv_addr 指定的网络地址。结构sockaddr请参考bind()。参数addrlen为sockaddr的结 构长度。 返回值
成功则返回0,失败返回-1,错误原因存于errno中。 错误代码
EBADF 参数sockfd 非合法socket处理代码
EFAULT 参数serv_addr指针指向无法存取的内存空间 ENOTSOCK 参数sockfd为一文件描述词,非socket。 EISCONN 参数sockfd的socket已是连线状态 ECONNREFUSED 连线要求被server端拒绝。
ETIMEDOUT 企图连线的操作超过限定时间仍未有响应。 ENETUNREACH 无法传送数据包至指定的主机。 EAFNOSUPPORT sockaddr结构的sa_family不正确。 EALREADY socket为不可阻断且先前的连线操作还未完成。 4、htonl(将32位主机字符顺序转换成网络字符顺序) 头文件
1 #include
定义函数
1 unsigned long int htonl(unsigned long int hostlong);
函数说明
htonl()用来将参数指定的32位hostlong 转换成网络字符顺序。 返回值
返回对应的网络字符顺序。
5、htons(将16位主机字符顺序转换成网络字符顺序) 头文件
1 #include
定义函数
1 unsigned short int htons(unsigned short int hostshort);
函数说明
htons()用来将参数指定的16位hostshort转换成网络字符顺序。 返回值
返回对应的网络字符顺序。
6、inet_addr(将网络地址转成二进制的数字) 头文件
1 #include
定义函数
1 unsigned long int inet_addr(const char *cp);
函数说明
inet_addr()用来将参数cp所指的网络地址字符串转换成网络所使用的二进制数字。网络地址字符串是以数字和点组成的字符串,例 如:“163.13.132.68”。 返回值
成功则返回对应的网络二进制的数字,失败返回-1。 7、inet_aton(将网络地址转成网络二进制的数字) 头文件
1 #include
定义函数
1 int inet_aton(const char * cp,struct in_addr *inp);
函数说明
inet_aton()用来将参数cp所指的网络地址字符串转换成网络使用的二进制的数字,然后存于参数inp所指的in_addr结构中。 结构in_addr定义如下
struct in_addr {
unsigned long int s_addr; };
返回值
成功则返回非0值,失败则返回0。
8、inet_ntoa(将网络二进制的数字转换成网络地址) 头文件
1 #include
定义函数
1 char * inet_ntoa(struct in_addr in);
函数说明
inet_ntoa()用来将参数in所指的网络二进制的数字转换成网络地址,然后将指向此网络地址字符串的指针返回。 返回值
成功则返回字符串指针,失败则返回NULL。 9、listen(等待连接) 头文件
1 #include
定义函数
1 int listen(int s,int backlog);
函数说明
listen()用来等待参数s 的socket连线。参数backlog指定同时能处理的最大连接要求,如果连接数目达此上限则client端将收到
ECONNREFUSED的错误。 Listen()并未开始接收连线,只是设置socket为listen模式,真正接收client端连线的是accept()。通常listen()
会在socket(),bind()之后调用,接着才调用accept()。 返回值
成功则返回0,失败返回-1,错误原因存于errno 附加说明
listen()只适用SOCK_STREAM或SOCK_SEQPACKET的socket类型。如果socket为AF_INET则参数backlog 最大值可设至128。 错误代码
EBADF 参数sockfd非合法socket处理代码 EACCESS 权限不足
EOPNOTSUPP 指定的socket并未支援listen模式。 10、ntohl(将32位网络字符顺序转换成主机字符顺序) 头文件
1 #include
定义函数
1 unsigned long int ntohl(unsigned long int netlong);
函数说明
ntohl()用来将参数指定的32位netlong转换成主机字符顺序。 返回值
返回对应的主机字符顺序。
11、ntohs(将16位网络字符顺序转换成主机字符顺序) 头文件
1 #include
定义函数
1 unsigned short int ntohs(unsigned short int netshort);
函数说明
ntohs()用来将参数指定的16位netshort转换成主机字符顺序。 返回值
返回对应的主机顺序。
12、recv(经socket接收数据) 头文件
1 #include
定义函数
1 int recv(int s,void *buf,int len,unsigned int flags);
函数说明
recv()用来接收远端主机经指定的socket传来的数据,并把数据存到由参数buf 指向的内存空间,参数len为可接收数据的最大长度。 参数
flags一般设0。其他数值定义如下:
MSG_OOB 接收以out-of-band 送出的数据。
MSG_PEEK 返回来的数据并不会在系统内删除,如果再调用recv()会返回相同的数据内容。 MSG_WAITALL强迫接收到len大小的数据后才能返回,除非有错误或信号产生。
MSG_NOSIGNAL此操作不愿被SIGPIPE信号中断返回值成功则返回接收到的字符数,失败返回-1,错误原因存于errno中。 错误代码
EBADF 参数s非合法的socket处理代码
EFAULT 参数中有一指针指向无法存取的内存空间 ENOTSOCK 参数s为一文件描述词,非socket。
百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读,免费范文网,提供经典小说综合文库Linux系统API函数手册(5)在线全文阅读。
相关推荐: