Linux网络编程API(一)

#include <netinet/in.h>
unsigned long int htonl( unsigned long int hostlong );
unsigned short int htons( unsigned long int hostlong );
unsigned long int ntohl( unsigned long int netlong );
unsigned short int ntohs( unsigned long int netlong );

#include <bits/socket.h>
struct sockaddr{
    sa_family_t	sa_family;	//地址族类型变量
    char	sa_data[14];	//存放socket地址值
}

#include <bits/socket.h>
struct sockaddr_storage {
    sa_family_t		sa_family;	//地址族类型变量
    unsigned long int	__ss_align;	//用来内存对齐
    char		__ss_padding[128-sizeof(__ss_align)];	
}

#include <sys/un.h>
struct sockaddr_un {
	sa_family_t	sin_family;	//地址族: AF_UNIX
	char		sun_path[108];	//文件路径名
}

struct sockaddr_in {
    sa_family_t		sin_family;			//地址族: AF_INET
    u_int16_t		sin_port;			//端口号，用网络字节序表示
    struct in_addr	sin_addr;			//IPv4地址结构体
};
struct in_addr {
    u_int32_t		s_addr;				//IPv4地址，要用网络字节序表示
}

struct sockaddr_in6 {
    sa_family_t		sin6_family;		//地址族: AF_INET6
    u_int16_t		sin6_port;			//端口号，用网络字节序表示
    u_int32_t		sin6_flowinfo;		//流信息，应设置为0
    struct in6_addr	sin6_addr;			//IPv6地址结构体
    u_int32_t		sin6_scopt_16;		//scope ID,尚处于实验阶段
};
struct in6_addr {
    unsigned char	sa_addr[16];		//IPv6地址，要用网络字节序表示
}

#include <arpa/inet.h>
in_addr_t inet_addr(const char* strptr);				
int inet_aton(const char* cp, struct in_addr* inp);
char* inet_ntoa(struct in_addr in);

#include <arpa/inet.h>
int inet_pton(int af, const char* src, void* dst);
const char* inet_ntop(int af, const void* src, char* dst, socketlen_t cnt);

#include <netinet/in.h>
#define	INET_ADDRSTRLEN 	16
#define	INET6_ADDRSTRLEN	46

#include <sys/types.h>
#include <sys/socket.h>
//成功返回socket文件描述符,失败返回-1并设置errno
int socket(int domain, int type, int protocol);

#include <sys/types.h>
#include <sys/socket.h>
//成功返回0，失败返回-1并设置errno
//errno的类型: EACCES,表示被绑定地址是受保护的
//			  EADDRINUSE, 被绑定地址正在使用中
int bind(int sockfd, const struct sockaddr* my_addr, socklen_t addrlen);

#include <sys/socket.h>
//成功返回0，失败返回-1并设置errno
int listen(int sockfd, int backlog);

#include <sys/types.h>
#include <sys/socket.h>
//成功返回一个新的socket文件描述符，用来唯一标识被接受的这个连接，服务器可以通过读写该socket来与被连接的客户端通信
int accept(int sockfd, struct sockaddr *addr, socklen_t *addrlen);

//例
struct sockaddr_in client;
socklen_t client_addrlength = sizeof(client);
int connfd = accept(sock, (struct sockaddr*)&client, &client_addrlength);

#include <sys/types.h>
#include <sys/socket.h>
int connect(int sockfd, const struct sockaddr *serv_addr, socklen_t addrlen);

#include <unistd.h>
int close(int fd);

#include <sys/socket.h>
//成功返回0，失败返回-1并设置errno
int shutdown(int sockfd, int howto);

#include <sys/types.h>
#include <sys/socket.h>
//函数返回实际读(写)的数据长度，返回0的话意味对方已关闭连接，出错时返回-1并设置errno
ssize_t recv(int sockfd, void *buf, size_t len, int flags);
ssize_t send(int sockfd, cons void *buf, size_t len, int flags);

#include <sys/types.h>
#include <sys/socket.h>
//函数返回实际读(写)的数据长度
ssize_t recvfrom(int sockfd, void *buf, size_t len, int flags, struct sockaddr* src_addr, socklen_t* addrlen);
ssize_t sendto(int sockfd, cons void *buf, size_t len, int flags, const struct sockaddr* dest_addr, socklen_t addrlen);

#include <sys/socket.h>
ssize_t recvmsg(int sockfd, struct msghdr* msg, int flags);
ssize_t sendmsg(int sockfd, struct msghdr* msg, int flags);

struct msghdr{
    void*		msg_name;				//socket地址
    socklen_t 		msg_namelen;				//socket地址的长度
    struct iovec* 	msg_iov;				//分散的内存块，见后文
    int 		msg_iovlen;				//分散内存块的数量
    void* 		msg_control;			//指向辅助数据的起使位置
    socklen_t 		msg_controllen;			//辅助数据的大小
    int 		msg_flags;				//复制函数中的flags参数，并在调用过程中更新
};``
//iovec封装了一块内存的起始位置和长度
struct iovec{
    void*		iov_base;				//内存起始地址
    size_t 		iov_len;				//这块内存的长度
};

#include <sys/socket.h>
//成功返回1，失败返回0
//若成功了，我们就可以利用带MSG_OOB标志的recv调用来接收带外数据
int sockatmark(int sockfd);

#include <sys/socket.h>
//获取sockfd对应的本端socket地址,成功返回1，失败返回-1并设置errno
int getsockname(int sockfd, struct sockaddr* address, socklen_t* address_len);
//获取sockfd对应的远端socket地址,成功返回1，失败返回-1并设置errno
int getpeername(int sockfd, struct sockaddr* address, socklen_t* address_len);

#include <sys/socket.h>
//两个函数都是成功返回1，失败返回0并设置errno
int getsockopt(int sockfd, int level, int option_name, void* option_value, socklen_t* restrict option_len);
int setsockopt(int sockfd, int level, int option_name, const void* option_value, socklen_t* restrict option_len);

#include <netdb.h>
//根据主机名获取主机的完整信息
struct hostnet* gethostbyname(const char* name);
//根据IP地址获取主机的完整信息
struct hostnet* gethostbyaddr(const void* addr, size_t len, int type);

struct hostnet{
    char*	h_name;			//主机名
    char**	h_aliases;		//主机别名列表，可能有多个
    int		h_addrtype;		//地址类型(地址族)
    int		h_length;		//地址长度
    char**	h_addr_list;	//按网络字节序 列出的主机IP地址列表
}

#include <netdb.h>
//根据服务名称获取某个服务的完整信息
struct servent* getservbyname(const char* name, const char* proto);
//根据服务端口号获取某个服务的完整信息
struct servent* getservbyport(int port, const char* proto);

struct servent{
    char*	s_name;			//服务名称
    char**	s_aliases;		//服务的别名列表，可能有多个
    int		s_port;			//服务对应的端口号
    char*	s_proto;		//服务的类型，通常是tcp或者udp
}

#include <netdb.h>
int getaddrinfo(const char* hostname, const char* service, const struct addrinfo* hints, struct addrinfo** result);

//由于getaddrin隐式分配堆内存到result,因此需要使用这个函数释放内存
void freeaddrinfo(struct addrinfo* res);

struct addrinfo{
    int			ai_flags;		//见后文
    int			ai_family;		//地址族
    int			ai_socktype;	//服务类型，SOCK_STREAM或SOCK_DGRAM
    int			ai_protocal;	//见后文
    socklen_t		ai_addrlen;		//socket地址ai_addr的长度
    char*		ai_canonname;	//主机的别名
    struct sockaddr*	ai_addr;		//指向socket地址
    struct addrinfo*	ai_next;		//指向下一个socketinfo结构对象
}

#include <netdb.h>
int getnameinfo(const struct sockaddr* sockaddr, socklen_t addrlen, char* host, socklen_t hostlen, char* serv, socklen_t servlen, int flags);