2. NAPI 数据结构：核心结构体与状态管理

NAPI 机制的高效运转依赖于精心设计的数据结构。本章深入剖析 struct napi_struct、struct softnet_data、NAPI 状态标志以及 GRO 相关数据结构，为后续驱动开发与性能调优奠定坚实基础。

2.1 struct napi_struct：NAPI 实例的核心

struct napi_struct 是 NAPI 机制的核心数据结构，每个注册了 NAPI 的网络设备或虚拟队列都对应一个实例。它管理着轮询状态、回调函数、设备关联以及 GRO 上下文。

struct napi_struct {
    /* 链表节点：用于将 napi_struct 挂入 poll_list */
    struct list_head    poll_list;

    /* 引用计数与状态标志 */
    unsigned long       state;
    int                 weight;

    /* 轮询回调函数与私有数据 */
    int                 (*poll)(struct napi_struct *, int);
    void                *dev_id;

    /* GRO 相关字段 */
    struct gro_list     gro_hash[GRO_HASH_BUCKETS];
    struct list_head    rx_list;        /* 待处理的 GRO 包列表 */
    int                 gro_count;

    /* 硬件时间戳与 IRQ 上下文 */
    ktime_t             timestamp;
    struct hrtimer      timer;

    /* 其他辅助字段 */
    struct list_head    dev_list;
    struct rcu_head     rcu;
};

2.2 struct softnet_data：Per-CPU 调度核心

struct softnet_data 是每个 CPU 独立维护的软中断调度数据结构，负责管理 NAPI 实例的轮询队列、输入包队列以及统计信息。它是 NAPI 调度机制的“调度器”。

struct softnet_data {
    /* NAPI 轮询链表 */
    struct list_head    poll_list;

    /* 输入包队列（backlog） */
    struct sk_buff_head input_pkt_queue;
    struct napi_struct  backlog;

    /* 完成队列（NAPI 完成处理） */
    struct sk_buff_head completion_queue;

    /* 统计信息 */
    unsigned int        processed;
    unsigned int        time_squeeze;
    unsigned int        cpu_collision;

    /* 其他辅助字段 */
    int                 defer_count;
    int                 defer_ipi_scheduled;
    struct rcu_head     rcu;
};

2.3 NAPI 状态标志：位掩码控制调度生命周期

napi_struct.state 字段使用位掩码记录 NAPI 实例的当前状态。内核通过原子操作设置/清除这些标志，确保多核环境下的正确性。

enum {
    NAPI_STATE_SCHED,       /* 0：已调度，等待轮询 */
    NAPI_STATE_MISSED,      /* 1：调度期间有新中断到达 */
    NAPI_STATE_DISABLE,     /* 2：被禁用，不可调度 */
    NAPI_STATE_NPSVC,       /* 3：非抢占式服务中 */
    NAPI_STATE_HASHED,      /* 4：已加入全局 napi_hash */
    NAPI_STATE_NO_BUSY_POLL,/* 5：禁止忙轮询 */
    NAPI_STATE_IN_BUSY_POLL,/* 6：正在忙轮询 */
};

2.4 GRO 相关数据结构：高效包合并

GRO（Generic Receive Offload）在 NAPI 轮询过程中将同流的小包合并为大包，减少协议栈处理开销。其核心数据结构包括 gro_list、napi_gro_cb 和 skb_gro_params。

/* GRO 哈希表项 */
struct gro_list {
    struct list_head    list;       /* 同哈希桶的 skb 链表 */
    int                 count;      /* 当前桶中 skb 数量 */
};

/* GRO 控制块（skb->cb 中存储） */
struct napi_gro_cb {
    union {
        struct {
            unsigned int    same_flow:1;    /* 与上一个包同流 */
            unsigned int    flush:1;        /* 强制刷新合并 */
            unsigned int    free:1;         /* 释放原 skb */
            unsigned int    encapsulation:1;/* 隧道封装 */
            unsigned int    gro_remcsum:1;  /* 远程校验和 */
        };
        u16     gro_bits;
    };
    u16     frag0_len;          /* 线性数据长度 */
    void    *frag0;             /* 线性数据指针 */
};

/* GRO 匹配参数 */
struct skb_gro_params {
    struct net_device   *dev;       /* 接收设备 */
    struct net_device   *orig_dev;  /* 原始设备（bonding） */
    __be16              proto;      /* L3 协议类型 */
    u16                 h_proto;    /* 原始协议字段 */
};

2.5 数据结构协作关系总结

NAPI 数据结构的协作关系可概括为：中断触发 → napi_schedule() 设置状态 → 加入 softnet_data.poll_list → 软中断遍历调用 poll → poll 内使用 GRO 合并 → 送入协议栈。