eventfd 在内核版本,2.6.22以后有效。查看内核版本可以用命令 uname -r 。
1 #include <sys/eventfd.h> int eventfd(unsigned int initval, int flags); 这个函数会创建一个 事件对象 (eventfd object), 用来实现,进程(线程)间 的 等待/通知(wait/notify) 机制. 内核会为这个对象维护一个64位的计数器(uint64_t)。 并且使用第一个参数(initval)初始化这个计数器。调用这个函数就会返回一个新的文件描述符(event object)。2.6.27版本开始可以按位设置第二个参数(flags)。 有如下的一些宏可以使用: EFD_NONBLOCK , 功能同open(2) 的O_NONBLOCK,设置对象为非阻塞状态,如果没有设置这个状态的话,read(2)读eventfd,并且计数器的值为0 就一直堵塞在read调用当中,要是设置了这个标志, 就会返回一个 EAGAIN 错误(errno = EAGAIN)。效果也如同 额外调用select(2)达到的效果。 EFD_CLOEXEC 我的理解是,这个标识被设置的话,调用exec后会自动关闭文件描述符,防止泄漏。 如果是2.6.26或之前版本的内核,flags 必须设置为0。 创建这个对象后,可以对其做如下操作。 write 将缓冲区写入的8字节整形值加到内核计数器上。 read 读取8字节值, 并把计数器重设为0. 如果调用read的时候计数器为0, 要是eventfd是阻塞的, read就一直阻塞在这里,否则就得到 一个EAGAIN错误。 如果buffer的长度小于8那么read会失败, 错误代码被设置成 EINVAL。 poll select epoll close 当不需要eventfd的时候可以调用close关闭, 当这个对象的所有句柄都被关闭的时候,内核会释放资源。 为什么不是close就直接释放呢, 如果调用fork 创建 进程的时候会复制这个句柄到新的进程,并继承所有的状态。 下面是一个例子 1 #include < sys / eventfd.h > 2 #include < unistd.h > 3 #include < stdio.h > 4 #include < stdint.h > 5 #include < stdlib.h > 6 #include < errno.h > 7 8 #define handle_error(msg) / 9 do { perror(msg); exit( 1 ); } while ( 0 ) 10 11 int main( int argc, char ** argv ) 12 { 13 uint64_t u; 14 ssize_t s; 15 int j; 16 if ( argc < 2 ) { 17 fprintf(stderr, " input <num> in command argument " ); 18 exit( 1 ); 19 } 20 21 int efd; 22 if ( (efd = eventfd( 0 , EFD_NONBLOCK)) == - 1 ) 23 handle_error( " eventfd failed " ); 24 25 26 switch (fork()) { 27 case 0 : 28 for ( j = 1 ; j < argc; j ++ ) { 29 printf( " Child writing %s to efd/n " , argv[j] ); 30 31 u = strtoull(argv[j], NULL, 0 ); /* analogesly atoi */ 32 s = write(efd, & u, sizeof (uint64_t)); /* append u to counter */ 33 if ( s != sizeof (uint64_t) ) 34 handle_error( " write efd failed " ); 35 36 } 37 printf( " child completed write loop/n " ); 38 39 exit( 0 ); 40 default : 41 sleep ( 2 ); 42 43 printf( " parent about to read/n " ); 44 s = read(efd, & u, sizeof (uint64_t)); 45 if ( s != sizeof (uint64_t) ) { 46 if (errno = EAGAIN) { 47 printf( " Parent read value %d/n " , s); 48 return 1 ; 49 } 50 handle_error( " parent read failed " ); 51 } 52 printf( " parent read %d , %llu (0x%llx) from efd/n " , 53 s, (unsigned long long )u, (unsigned long long ) u); 54 exit( 0 ); 55 56 case - 1 : 57 handle_error( " fork " ); 58 } 59 return 0 ; 60 } 这个API还是很有用的, 当你想要编写并发型服务器的时候,aventfd 可以完美取代 pipe去通知(唤醒)其他的进程(线程)。比如经典的异步IO reactor/selector 应用场景,去唤醒select的调用。他的缓冲区处理非常方便, 规定只有8字节。