常用套接字 API 原型

#include <sys/socket.h>

int socket(int af, int type, int protocol);
// af：一个地址描述。常用AF_INET（支持TCP和UDP）。
// type：指定socket类型。TCP（SOCK_STREAM）、UDP（SOCK_DGRAM）。
// protocal：指定协议。如调用者不想指定，可用0。常用协议有IPPROTP_TCP、IPPROTO_UDP、IPPROTO_STCP。
// 成功返回新套接字的描述，失败返回负数。

int connect(int sockfd, struct sockaddr* serv_addr, socklen_t addrlen);
// 成功返回0，失败返回负数

int bind(int sockfd, struct sockaddr* my_addr, sockelen_t addrlen);
// 成功返回0，失败返回负数

int listen(int sockfd, intbacklog);
// 成功返回0，失败返回负数

int accept(int sockfd, struct sockaddr* addr, socklen_t* addrlen);
// 成功返回套接字的描述，错误返回负数

int getsockname(int sockfd, struct sockaddr* local_addr, socklen_t* addrlen);
// 成功返回0，失败返回-1

int  getpeername(int sockfd, struct sockaddr* peer_addr, socklen_t* addrlen);
// 成功返回0，失败返回-1

int shutdown(int sockfd, int howto);
// 成功返回0， 失败返回-1
// howto：
// SHUT_RD、SHUT_WR、SHUT_RDWR

#include <unistd.h>

int read(int sockfd, void* buf, size_t bufsize);
// 成功返回读取字节数，失败返回-1，若在调read之前已到达文件末尾，则返回0

int write(int sockfd, void* buf, size_t nbyte);
// 成功返回实际写入的字节数，失败返回-1 

#include <netinet/in.h>

uint16_t htons(uint16_t host16bitvalue);
uint32_t htonl(uint32_t host32bitvalue);

uint16_t ntohs(uint16_t net16bitvalue);
uint32_t ntohl(uint32_t net32bitvaule);

#include <string.h>

void bzero(void* dest, size_t nbytes);
void bcopy(const void* src, void* dest, size_t nbytes);
int bcmp(const void* ptr1, const void* ptr2, size_t nbytes);

void* memset(void* dest, int c, size_t len);
void* memcpy(void* dest, const void* src, size_t nbytes);
int memcpy(const void* ptr1, const void* ptr2, size_t nbytes);

#include <arpa/inet.h>

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

in_addr_t inet_addr(const char* strptr);

char* inet_ntoa(struct in_addr inaddr);

int inet_pton(int family, const char* strptr, void* addrptr);

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

#include <sys/wait.h>

pid_t wait(int* statloc);

pid_t waitpid(pid_t pid, int* statloc, int options);
// 成功返回进程id，失败返回0或-1

#include <sys/select.h>
#include <signal.h>
#include <sys/time.h>

int select(int maxfdp1, fd_set *readset, fd_set* writeset, fd_set* exceptset, const struct timeval* timeout);
// 若有就绪描述符则为其数目，若超时则为0，若出错则为-1

void FD_ZERO(fd_set* fdset); // clear all bits in fdset
void FD_SET(int fd, fd_set* fdset); // turn on the bit for fd in fdset
void FD_CLR(int fd, fd_set* fdset); // turn off the bit for fd in fdset
int FD_ISSET(int fd, fd_set* fdset); // is the bit for fd on in fdset ?

int pselect(int maxfdp1, fd_set* readset, fd_set* writeset, fd_set* exceptset, const struct timespec* timeout, const sigset_t* sigmask);
// 若有就绪描述符则为其数目，若超时则为0，若出错则为-1

#include <poll.h>

int poll(struct pollfd* fdarray, unsigned long fds, int timeout);
// 若有就绪描述符则为其数目，若超时则为0，若出错则为-1

#include <signal.h>

int sigaction(int signum, const struct sigaction* act, struct sigaction* oldact);
// 失败返回负数

typedef void (* Sigfunc) (int);
Sigfunc signal(int signo, Sigfunc func);
// 失败返回 SIG_ERR，成功返回指向旧处理函数的指针