最基本的socket api,记录下来方便查找。
socket
#include<sys/types.h>
#include<sys/socket.h>
int socket(int domain,int type,int protocol);
返回:成功则返回非负描述符,出错则返回-1
创建一个套接字,domain-协议族,常用值:AF_INET、AF_INET6;type-套接字类型,常用值:SOCK_STREAM、SOCK_DGRAM、SOCK_SEQPACKET;protocol-协议类型,一般设为0,表示用系统默认。
bind
#include<sys/socket.h>
int bind(int sockfd,const struct sockaddr *myaddr,socklen_t addlen);
返回:成功为0,出错为-1
套接字sockfd指定本地地址myaddr,sockaddr为协议地址,addlen为此地址长度。
connect
#include<sys/socket.h>
int connect(int sockfd,const struct sockaddr *servaddr,socklen_t addrlen);
返回:成功为0,出错为-1
客户端用connect与服务器建立tcp连接,servaddr和addrlen为服务器端协议地址和长度。
listen
#include<sys/socket.h>
int listen(int sockfd,int backlog);
返回:成功为0,出错为-1
sockfd为将要监听的套接字,backlog为established队列的最大值。
accept
#include<sys/socket.h>
int accept(int sockfd,struct sockaddr *cliaddr,socklen_t *addrlen);
返回:成功则返回非负描述符,出错则返回-1
返回一个全新描述符,代表tcp连接,cliaddr和addrlen为客户端的协议地址和长度。
字节序转换
#include<arpa/inet.h>
uint32_t htonl(uint32_t hostlong);
uint16_t htons(uint16_t hostshort);
uint32_t ntohs(uint32_t netlong);
uint16_t ntohs(uint16_t netshort);
h-host,n-net,这四个函数为主机序和网络序转换,分别为两字节和四字节。
ip格式
#include<arpa/inet.h>
const char *inet_ntop(int af,const void *src,char *dst,socklen_t size);
int inet_pton(int af,const char *src,void *dst);
p-presentation,n-numeric,用于ip的字符串格式和数值格式的转换。
ip表达式格式长度
#include<netinet/in.h>
#define INET_ADDRSTRLEN 16
#define INET6_ADDRSTRLEN 46
地址结构
#include<netinet/in.h>
struct in_addr
{
uint32_t s_addr;
};
typedef unsigned short int sa_family_t;
struct sockaddr_in {
short sin_family; // e.g. AF_INET
unsigned short sin_port; // e.g. htons(3490)
struct in_addr sin_addr; // see struct in_addr, below
char sin_zero[8]; // zero this if you want to
};
#include<sys/socket.h>
struct sockaddr {
sa_family_t sa_family; /* 地址族, AF_xxx */
char sa_data[14]; /* 14字节的协议地址 */
}