Unix网络编程API.doc

Unix 网络编程 API

1.字节序函数

#include <netinet.h>

uint16_t htons(uint16_t host16bitvalue);

uint32_t htonl(uint32_t host32bitvalue);

返回：网络字节序值

uint16_t ntohs(uint16_t net16bitvalue);

uint32_t ntohl(uint32_t net32bitvalue);

返回：主机字节序值

返回：0—相等，非 0—不相等

#include <string.h>

void *memset(void *dest, int c, size_t len);

void *memcpy(void *dest, void *src, size_t nbytes);

int memcmp(const void *ptr1, const void *ptr2, size_t nbytes);

返回：0—相同，>0 或<0—不相同；进行比较操作时，假定两个不相等的字节均为无符号字符

（unsigned char）。

3.地址转换函数

#include <arpa/inet.h>

int inet_aton(const char *strptr, struct in_addr *addrptr);

返回：1—成功；0—输入不是有效的表达格式，-1—出错。

const char *inet_ntop(int family, const void *addrptr, char *strptr, size_t len);

返回：指向结果的指针—成功，NULL—失败。

说明：

� inet_aton 函数的指针若为空，则函数仍然执行输入串的有效性检查，但

不存储任何结果。

� inet_addr 的缺陷：出错返回值 INADDR_NONE 等于 255.255.255.255

（IPv4 的有限广播地址），所以该函数不能处理此地址。

尽量使用 inet_aton，不使用 inet_addr。

� inet_ntoa 函数的执行结果放在静态内存中，是不可重入的。

#define INET_ADDRSTRLEN 16 /*fro IPv4 dotted-decimal */

#define INET6_ADDRSTRLEN 46 /*for IPv6 hex string */

� inet_ntop 函数的参数 strptr 不能为空指针，成功时，此指针即是函数的

返回值。

实现 IPv4 版本的 inet_pton 和 inet_ntop 的程序，参见：unpv12e：

libfree/inet_pton_ipv4.c 和 libfree/inet_ntop_ipv4.c。

4.readn、writen 和 readline

函数原型如下：

ssize_t readn(int filedes, void *buff, size_t nbytes);

ssize-t writen(int filedes, void *buff, size_t nbytes);

返回：1—是指定类型，0—不是指定类型，-1—出错。

要测试是否为套接口描述子，fdtype 应设为 S_IFSOCK。

该函数的一个实现程序，参见 unpv12e：lib/isfdtype.c

6.socket 函数

#include <sys/socket.h>

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

返回：非负描述字—成功，-1—出错。

family 指定协议族，有如下取值：

� AF_INET IPv4 协议

� AF_INET6 IPv6 协议

� SOCK_RAW 原始套接口

protocol 一般设为 0，除非用在原始套接口上。

并非所有 family 和 type 的组合都是有效的。

AF_LOCAL 等于早期的 AF_UNIX。

7.connect 函数

#include <sys/socket.h>

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

返回：0—成功，-1—出错。

sockfd 是 socket 函数返回的套接口描述字，servaddr 和 addrlen 是指向服务器的套接口地址结

构指针和结构大小。

� 如果对 SYN 分节的响应是 RST，表示服务器在指定端口上没有相应的服

务，返回 ECONNREFUSED；

� 如果发出 SYN 在中间路由器上引发一个目的地不可达 ICMP 错误，在规

定时间内经过重发仍无效，则返回 EHOSTUNREACH 或 ENETUNREACH 错误。

注意：如果 connect 失败，则套接口将不能再使用，必须关闭，不能对此套接口

再调用函数 connect。

8.bind 函数

#include <sys/socket.h>

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

返回：0—成功，-1—出错。

IN6ADDR_ANY_INIT。）

如果让内核选择临时端口，注意的是 bind 并不返回所选的断口值，要得到一个端口，必须使用

getsockname 函数。

bind 失败的常见错误是 EADDRINUSE（地址已使用）。

9.listen 函数

#include <sys/socket.h>

int listen(int sockfd, int backlog);

返回：0—成功，-1—出错。

listen 把未连接的套接口转化为被动套接口，指示内核应接受指向此套接口的连接请求。第二个

参数规定了内核为此套接口排队的最大连接数。

返回：非负描述字—OK，-1—出错。

accept 从已完成连接队列头返回下一个连接，若已完成连接队列为空，则进程睡眠（套接口为

阻塞方式时）。