4. 内核API详解

在PCIe MSI-X中断驱动开发中，内核提供了一套标准化的API用于中断向量的分配、注册与释放。正确理解这些API的语义、参数约束及生命周期管理，是构建稳定高效驱动的基础。本章将深入剖析三个核心函数：pci_alloc_irq_vectors、pci_request_irq 和 pci_free_irq_vectors，并结合实际场景分析其使用要点。

4.1 pci_alloc_irq_vectors：中断向量的分配与协商

该函数是中断初始化的入口，负责向PCI子系统请求指定数量的中断向量，并自动选择MSI-X或MSI模式。

int pci_alloc_irq_vectors(struct pci_dev *dev,
                          unsigned int min_vecs,
                          unsigned int max_vecs,
                          unsigned int flags);

flags 常用组合：

• PCI_IRQ_MSIX：仅尝试MSI-X模式。
• PCI_IRQ_MSI：仅尝试MSI模式。
• PCI_IRQ_MSIX | PCI_IRQ_MSI：优先尝试MSI-X，失败后自动回退到MSI（推荐）。
• PCI_IRQ_MSIX | PCI_IRQ_MSI | PCI_IRQ_LEGACY：包含传统INTx回退。

4.2 pci_request_irq：中断处理程序的注册

分配向量后，需要为每个向量注册中断处理函数。pci_request_irq 是对 request_threaded_irq 的封装，自动传入设备关联的 struct pci_dev * 上下文。

int pci_request_irq(struct pci_dev *dev, unsigned int nr,
                    irq_handler_t handler,
                    irq_handler_t thread_fn,
                    void *dev_id, const char *fmt, ...);

4.3 pci_free_irq_vectors：中断向量的释放

在驱动卸载或设备移除时，必须释放之前分配的中断向量。该函数会释放所有通过 pci_alloc_irq_vectors 分配的资源。

void pci_free_irq_vectors(struct pci_dev *dev);

调用时机：

• 在 pci_free_irq 或 free_irq 释放所有已注册的中断处理程序之后。
• 在 pci_disable_device 之前。

4.4 完整生命周期与错误处理模式

以下代码片段展示了三个API在驱动probe和remove中的标准使用模式：

// probe 阶段
int irq_vecs;
int i;

irq_vecs = pci_alloc_irq_vectors(pdev, 1, num_queues,
                                  PCI_IRQ_MSIX | PCI_IRQ_MSI);
if (irq_vecs < 0) {
    dev_err(&pdev->dev, "Failed to allocate IRQ vectors: %d\n", irq_vecs);
    return irq_vecs;
}

for (i = 0; i < irq_vecs; i++) {
    ret = pci_request_irq(pdev, i, my_handler, NULL,
                          &priv[i], "mydrv-%d", i);
    if (ret) {
        dev_err(&pdev->dev, "Failed to request IRQ %d: %d\n", i, ret);
        goto err_free_irqs;
    }
}
// ... 继续初始化 ...

err_free_irqs:
    while (--i >= 0)
        pci_free_irq(pdev, i, &priv[i]);
    pci_free_irq_vectors(pdev);
    return ret;

// remove 阶段
for (i = 0; i < irq_vecs; i++)
    pci_free_irq(pdev, i, &priv[i]);
pci_free_irq_vectors(pdev);

4.5 性能对比：MSI-X vs MSI vs INTx

不同中断模式在延迟、吞吐量和CPU开销上存在显著差异。以下数据基于典型NVMe SSD和10GbE网卡实测：