epoll_create1系统调用及示例

epoll_create1 – 创建epoll实例（扩展版）

函数介绍

epoll_create1是epoll_create的扩展版本，支持额外的标志位参数，提供了更多的控制选项。

函数原型

#include <sys/epoll.h>

int epoll_create1(int flags);

功能

创建一个新的epoll实例，支持额外的标志位控制。

参数

• int flags: 控制标志
  • 0: 与epoll_create(size)相同
  • EPOLL_CLOEXEC: 设置文件描述符在exec时自动关闭

返回值

• 成功时返回epoll文件描述符
• 失败时返回-1，并设置errno

特殊限制

• 需要Linux 2.6.27以上内核支持

相似函数

• epoll_create(): 基础版本
• poll(), select(): 传统多路复用函数

示例代码

#define _GNU_SOURCE
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <sys/epoll.h>
#include <errno.h>
#include <string.h>
#include <fcntl.h>

int main() {
    int epfd1, epfd2;
    
    printf("=== Epoll_create1 函数示例 ===\n");
    
    // 示例1: 基本使用
    printf("\n示例1: 基本使用\n");
    
    epfd1 = epoll_create1(0);
    if (epfd1 == -1) {
        perror("epoll_create1(0) 失败");
    } else {
        printf("成功创建epoll实例（无标志）: %d\n", epfd1);
        close(epfd1);
    }
    
    // 示例2: 使用EPOLL_CLOEXEC标志
    printf("\n示例2: 使用EPOLL_CLOEXEC标志\n");
    
    epfd2 = epoll_create1(EPOLL_CLOEXEC);
    if (epfd2 == -1) {
        perror("epoll_create1(EPOLL_CLOEXEC) 失败");
    } else {
        printf("成功创建epoll实例（带CLOEXEC）: %d\n", epfd2);
        
        // 验证CLOEXEC标志是否设置
        int flags = fcntl(epfd2, F_GETFD);
        if (flags != -1) {
            if (flags & FD_CLOEXEC) {
                printf("FD_CLOEXEC标志已正确设置\n");
            } else {
                printf("FD_CLOEXEC标志未设置\n");
            }
        }
        
        close(epfd2);
    }
    
    // 示例3: 错误处理
    printf("\n示例3: 错误处理\n");
    
    int invalid_fd = epoll_create1(-1);
    if (invalid_fd == -1) {
        if (errno == EINVAL) {
            printf("无效标志错误处理正确: %s\n", strerror(errno));
        }
    }
    
    // 示例4: 与epoll_create对比
    printf("\n示例4: 与epoll_create对比\n");
    
    int fd1 = epoll_create(10);
    int fd2 = epoll_create1(0);
    
    if (fd1 != -1 && fd2 != -1) {
        printf("epoll_create返回: %d\n", fd1);
        printf("epoll_create1(0)返回: %d\n", fd2);
        printf("两者功能基本相同\n");
        
        close(fd1);
        close(fd2);
    }
    
    // 示例5: 实际应用演示
    printf("\n示例5: 实际应用演示\n");
    
    // 推荐的现代用法
    int epfd = epoll_create1(EPOLL_CLOEXEC);
    if (epfd != -1) {
        printf("推荐用法: epoll_create1(EPOLL_CLOEXEC) = %d\n", epfd);
        printf("优点: 避免文件描述符泄漏到子进程\n");
        close(epfd);
    }
    
    printf("\nEPOLL_CLOEXEC的优势:\n");
    printf("1. 原子性设置标志，避免竞态条件\n");
    printf("2. 防止文件描述符泄漏到exec的程序\n");
    printf("3. 提高程序安全性\n");
    printf("4. 减少系统调用次数\n\n");
    
    printf("总结:\n");
    printf("epoll_create1是现代Linux编程推荐的epoll创建函数\n");
    printf("EPOLL_CLOEXEC标志提供了更好的安全性\n");
    printf("在支持的系统上应优先使用epoll_create1\n");
    
    return 0;
}