IO多路复用之select,poll,epoll总结

/* 
 * maxfdp1: 最大的fd加1 (fd是一个整形)
 * fd_set: 文件描述符fd的集合，通过FD_ZERO，FD_SET，FD_CLR，FD_ISSET等宏来控制
 * return: int 若有就绪描述符返回其数目，若超时则为0，若出错则为-1
*/
int select (int maxfdp1, fd_set *readfds, fd_set *writefds, fd_set *exceptfds, struct timeval *timeout);

/////////////////////////////////////////////////
//相关接口:
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

/* 
 * fds: pollfd数组，文件描述及其监听事件的结构体集合
 * nfds: pollfd数组的大小
 * timeout: 超时时间，-1表示永久阻塞，0表示立即返回
 * return: int 若有就绪描述符返回其数目，若超时则为0，若出错则为-1
 */
int poll (struct pollfd *fds, unsigned int nfds, int timeout);

/////////////////////////////////////////////////
//相关结构:
struct pollfd {
    int fd; /* file descriptor */
    short events; /* requested events to watch */
    short revents; /* returned events witnessed */
};

/* 创建一个epoll对象
 * size: 监听的描述符数量
 * return: epoll句柄描述符 or -1 if failed
 */
int epoll_create(int size);

/* 向epoll对象添加/删除/修改fd描述符，以及要监听的事件类型
 * epfd: epoll句柄描述符
 * op: fd操作类型: EPOLL_CTL_ADD, EPOLL_CTL_MOD, EPOLL_CTL_DEL
 * fd: 操作的fd描述符
 * event: 注册/取消监听的事件
 * return: 0 if success or -1 if failed
 */
int epoll_ctl(int epfd, int op, int fd, struct epoll_event *event);

/* 等待事件的就绪
 * epfd: epoll句柄描述符
 * events: 接收事件的数组
 * maxevents: 事件数组的大小
 * fd: 操作的fd描述符
 * timeout: 超时时间，-1表示永久阻塞，0表示立即返回
 * return: 就绪fd的数量 or -1 if failed
 */
int epoll_wait(int epfd, struct epoll_event * events, int maxevents, int timeout);

/////////////////////////////////////////////////
// 相关结构
struct epoll_event {
    __uint32_t events;  /* Epoll events */
    epoll_data_t data;  /* User data variable */
};

typedef union epoll_data {
    void *ptr;
    int fd;
    __uint32_t u32;
    __uint64_t u64;
} epoll_data_t;

//events可以是以下几个宏的集合:
EPOLLIN :表示对应的文件描述符可以读(包括对端SOCKET正常关闭)；
EPOLLOUT:表示对应的文件描述符可以写；
EPOLLPRI:表示对应的文件描述符有紧急的数据可读(这里应该表示有带外数据到来)；
EPOLLERR:表示对应的文件描述符发生错误；
EPOLLHUP:表示对应的文件描述符被挂断；
EPOLLET: 将EPOLL设为边缘触发(Edge Triggered)模式，这是相对于水平触发(Level Triggered)来说的。
EPOLLONESHOT:只监听一次事件，当监听完这次事件之后，如果还需要继续监听这个socket的话，需要再次把这个socket加入到EPOLL队列里