3. NAPI 初始化与注册：napi_init()、netif_napi_add()、napi_enable() 函数流程与参数解析

NAPI 机制的生命周期始于初始化与注册阶段。设备驱动必须依次调用 napi_init()（或结构体赋值）、netif_napi_add() 将 NAPI 实例挂入网络设备，最后通过 napi_enable() 使其进入可调度状态。这三个函数构成了 NAPI 从“创建”到“就绪”的完整链路。

3.1 napi_init()：NAPI 结构体初始化

napi_init() 是一个内联函数，用于初始化 struct napi_struct 的核心字段。在 Linux 内核中，该函数通常定义在 <linux/netdevice.h> 中。

函数原型

static inline void napi_init(struct napi_struct *n, 
                             int (*poll)(struct napi_struct *, int),
                             int weight);

参数解析

内部流程

1. 将 poll 函数指针赋值给 n->poll
2. 将 weight 赋值给 n->weight
3. 初始化 n->poll_list 链表节点（通过 INIT_LIST_HEAD）
4. 设置 n->state 为 NAPIF_STATE_SCHED 未置位状态
5. 初始化 n->gro_list 和 n->rx_count 等 GRO 相关字段

3.2 netif_napi_add()：将 NAPI 注册到网络设备

netif_napi_add() 是驱动注册 NAPI 的核心接口，它将初始化后的 NAPI 实例绑定到指定的 net_device 结构体上，并加入设备的 NAPI 链表。

函数原型

void netif_napi_add(struct net_device *dev,
                    struct napi_struct *napi,
                    int (*poll)(struct napi_struct *, int),
                    int weight);

参数解析

内部执行流程

1. 调用 napi_init(napi, poll, weight) 完成基础初始化
2. 将 napi->dev 指向传入的 dev 设备
3. 将 napi 通过 list_add_tail() 添加到 dev->napi_list 链表尾部
4. 设置 napi->napi_id 为设备标识

3.3 napi_enable()：使能 NAPI 调度

napi_enable() 是 NAPI 进入可工作状态的最后一步。它清除 NAPIF_STATE_SCHED 标志位，允许软中断调度该 NAPI 实例进行轮询。

函数原型

void napi_enable(struct napi_struct *n);

参数解析

内部执行流程

1. 检查 n->state 是否已包含 NAPIF_STATE_SCHED 标志
2. 使用 clear_bit(NAPIF_STATE_SCHED, &n->state) 清除调度标志
3. 确保 n->poll_owner 为当前 CPU（SMP 安全检查）
4. 如果 NAPI 实例之前被禁用，清除 NAPIF_STATE_DISABLE 标志

3.4 完整初始化序列与典型代码示例

以下是一个真实的网络驱动初始化片段，展示了三个函数的完整调用顺序：

static int mydev_open(struct net_device *dev)
{
    struct mydev_priv *priv = netdev_priv(dev);
    int ret;

    /* 1. 注册中断处理函数 */
    ret = request_irq(priv->irq, mydev_isr, 0, dev->name, dev);
    if (ret)
        return ret;

    /* 2. 初始化并注册 NAPI */
    netif_napi_add(dev, &priv->napi, mydev_poll, 64);

    /* 3. 使能 NAPI 调度 */
    napi_enable(&priv->napi);

    /* 4. 开启硬件接收 */
    mydev_hw_start(dev);

    netif_start_queue(dev);
    return 0;
}

3.5 参数配置对比与最佳实践

3.6 常见错误与调试方法

• 重复注册： 对同一个 NAPI 实例多次调用 netif_napi_add() 会导致链表节点重复，引发内核崩溃。应在驱动初始化时只调用一次。
• 忘记使能： 注册后未调用 napi_enable()，中断处理函数中调用 napi_schedule() 将无效，数据包无法被轮询处理。
• weight 值异常： 设置 weight 为 0 或负数会导致内核 panic，因为 napi_poll() 中会做除零检查。
• 调试方法： 使用 cat /proc/net/softnet_stat 查看 NAPI 调度统计；使用 tracepoint napi:napi_poll 跟踪轮询事件。