1、创建epoll例程
#include <sys/epoll.h>
int epoll_create(int size);
// 成功时返回epoll文件描述符,失败时返回-1
调用epoll_create函数时创建的监视对象文件描述符保存空间称为“epoll例程”。
参数size并非用来决定epoll例程的大小,而仅供操作系统参考。该函数返回的文件描述符主要用于区分epoll例程。
2、向epoll例程内部注册监视对象文件描述符
调用epoll_ctl函数向epoll例程内部注册监视对象文件描述符。
#include <sys/epoll.h>
int epoll_ctl(int epfd, int op, int fd, struct epoll_event *event);
//成功时返回0, 失败时返回-1
参数epfd 表示向文件描述符epfd所指代的epoll例程中注册监视对象。
参数op 用于指定监视对象的添加、删除或更改等操作
参数fd 需要注册的监视对象的文件描述符
参数event 监视对象的事件类型。
参数event是结构体epoll_event类型的指针,结构体epoll_event的声明如下所示:
struct epoll_event
{
__uint32_t events;
epoll_data_t data;
}
该结构体的成员data用于注册监视对象文件描述符,成员events用于注册关注的事件,事件可以是EPOLLIN(需要读取数据的事件)、EPOLLOUT(可以立即发送数据的事件)等。
3、等待事件的发生
调用epoll_wait函数等待监视对象发生变化。
#include <sys/epoll.h>
int epoll_wait(int epfd, struct epoll_event *events, int maxevents, int timeout);
// 成功时返回发生事件的文件描述符数量,失败时返回-1
参数epfd 表示事件发生监视范围的epoll例程的文件描述符。
参数events 用于记录发生事件的文件描述符的结构体epoll_event型数组的地址。
参数maxevents 第二个参数可以保存的最大事件数。
参数timeout 以1/1000秒为单位的等待时间,传递-1时,表示一直等待直到发生事件。
第二个参数所指缓冲需要使用malloc函数动态分配。
调用函数后,返回发生事件的文件描述符数,同时将记录发生事件的文件描述符的结构体epoll_event保存在第二个参数指向的缓冲中
4、epoll机制服务器实例
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <arpa/inet.h>
#include <sys/socket.h>
#include <sys/epoll.h>
#define BUF_SIZE 100
#define EPOLL_SIZE 50
void error_handling(char *message);
int main(int argc, char *argv[])
{
int serv_sock, clnt_sock;
struct sockaddr_in serv_adr, clnt_adr;
socklen_t adr_sz;
int str_len, i;
char buf[BUF_SIZE];
struct epoll_event *ep_events;
struct epoll_event event;
int epfd, event_cnt;
if (argc != 2)
{
printf("Usage : %s <port> \n", argv[0]);
exit(1);
}
serv_sock = socket(PF_INET, SOCK_STREAM, 0);
memset(&serv_adr, 0, sizeof(serv_adr));
serv_adr.sin_family = AF_INET;
serv_adr.sin_addr.s_addr = htonl(INADDR_ANY);
serv_adr.sin_port = htons(atoi(argv[1]));
if (bind(serv_sock, (struct sockaddr *)&serv_adr, sizeof(serv_adr)) == -1)
error_handling("bind() error");
if (listen(serv_sock, 5) == -1)
error_handling("listen() error");
// epoll_create函数创建的文件描述符保存空间称为“epoll例程”,该函数返回的文件描述符主要用于区分epoll例程。
epfd = epoll_create(EPOLL_SIZE); //可以忽略这个参数,填入的参数为操作系统参考
// 创建用于记录发生事件的文件描述符的epoll_event型数组
ep_events = malloc(sizeof(struct epoll_event) * EPOLL_SIZE);
event.events = EPOLLIN; //需要读取数据的情况
event.data.fd = serv_sock;
epoll_ctl(epfd, EPOLL_CTL_ADD, serv_sock, &event); //向例程epfd 中注册文件描述符 serv_sock,目的是监听 event 中的事件
while (1)
{
event_cnt = epoll_wait(epfd, ep_events, EPOLL_SIZE, -1); //获取改变了的文件描述符,返回数量
if (event_cnt == -1)
{
puts("epoll_wait() error");
break;
}
for (i = 0; i < event_cnt; i++)
{
if (ep_events[i].data.fd == serv_sock) //客户端请求连接时
{
adr_sz = sizeof(clnt_adr);
clnt_sock = accept(serv_sock, (struct sockaddr *)&clnt_adr, &adr_sz);
event.events = EPOLLIN;
event.data.fd = clnt_sock; //把客户端套接字添加进去
epoll_ctl(epfd, EPOLL_CTL_ADD, clnt_sock, &event);
printf("connected client : %d \n", clnt_sock);
}
else //是客户端套接字时
{
str_len = read(ep_events[i].data.fd, buf, BUF_SIZE);
if (str_len == 0)
{
epoll_ctl(epfd, EPOLL_CTL_DEL, ep_events[i].data.fd, NULL); //从epoll中删除套接字
close(ep_events[i].data.fd);
printf("closed client : %d \n", ep_events[i].data.fd);
}
else
{
write(ep_events[i].data.fd, buf, str_len);
}
}
}
}
close(serv_sock);
close(epfd);
return 0;
}
void error_handling(char *message)
{
fputs(message, stderr);
fputc('\n', stderr);
exit(1);
}