3、常见错误码总览：-1(EPERM)、-16(EBUSY)、-22(EINVAL)、-12(ENOMEM)在BAR操作中的含义

在PCIe驱动开发中，BAR（Base Address Register）空间映射与访问是设备初始化的核心步骤。内核API（如 pci_ioremap_bar、pci_request_region）在失败时返回负的错误码，这些错误码直接反映了操作失败的根本原因。本章将系统梳理BAR操作中最常见的四个错误码：-1 (EPERM)、-16 (EBUSY)、-22 (EINVAL)、-12 (ENOMEM)，并解析其在内核上下文中的具体含义。

3.1 错误码总览与对比

下表列出了四个错误码的数值、宏定义、标准含义以及在BAR操作中的典型触发场景：

3.2 错误码触发机制详解

3.2.1 -1 (EPERM)：权限拒绝

触发条件：当驱动尝试执行一个不被当前硬件状态或系统安全策略允许的操作时，内核返回 EPERM。在BAR操作中，常见于以下场景：

• 只读BAR写操作：某些BAR（如只读的扩展ROM BAR）被硬件标记为只读，驱动尝试通过 pci_write_config_dword 写入新基址时触发。
• 安全固件锁定：在UEFI安全启动或IOMMU隔离环境下，固件可能锁定BAR空间，阻止操作系统重新映射。
• 特权级别不足：用户空间程序通过 /sys/bus/pci/devices/.../resource 访问BAR时，若未以root权限运行，也可能收到 EPERM。

// 典型错误触发代码示例：尝试写入只读BAR
u32 bar_val;
pci_read_config_dword(pdev, PCI_BASE_ADDRESS_0, &bar_val);
// 假设BAR0是只读的，以下写入会返回 -EPERM
pci_write_config_dword(pdev, PCI_BASE_ADDRESS_0, bar_val | 0x1);

3.2.2 -16 (EBUSY)：资源忙

触发条件：这是BAR操作中最常见的错误码之一，表示请求的资源已被其他实体占用。内核通过 pci_request_region 或 pci_request_selected_regions 进行资源预留检查。

• 驱动冲突：另一个驱动（如VGA仲裁器、音频驱动）已经占用了相同的MMIO或I/O端口范围。
• 内核子系统占用：ACPI、PCIe热插拔或VFIO模块可能提前占用了BAR区域。
• 重复请求：同一个驱动在未释放的情况下再次调用 pci_request_region。

// 检查BAR0是否被占用的典型调试代码
if (pci_request_region(pdev, 0, "my_driver_bar0")) {
    dev_err(&pdev->dev, "BAR0 is busy, check /proc/iomem\n");
    return -EBUSY;
}

3.2.3 -22 (EINVAL)：无效参数

触发条件：传递给内核API的参数不合法。在BAR操作中，EINVAL 通常指向驱动代码中的逻辑错误。

• BAR索引越界：设备只有6个BAR（索引0-5），传入索引6或负数。
• 映射大小为零：调用 pci_ioremap_bar 时，BAR的 resource_size 返回0（通常表示BAR未启用）。
• 对齐错误：手动计算映射地址时未按BAR要求的对齐粒度（32位BAR按16字节对齐，64位BAR按8字节对齐）。
• PCI配置空间读取失败：设备处于D3cold状态，无法读取BAR寄存器。

// 无效参数示例：BAR索引越界
void __iomem *bar5 = pci_ioremap_bar(pdev, 5); // 如果设备只有4个BAR，返回 -EINVAL
if (IS_ERR(bar5)) {
    dev_err(&pdev->dev, "Invalid BAR index: %ld\n", PTR_ERR(bar5));
}

3.2.4 -12 (ENOMEM)：内存不足

触发条件：内核无法分配请求的内存资源。这通常不是物理内存耗尽，而是与地址空间连续性或映射窗口大小有关。

• 虚拟地址空间耗尽：在32位系统上，vmalloc区域有限，映射大BAR（如256MB）可能失败。
• DMA缓冲区分配失败：使用 dma_alloc_coherent 为BAR操作分配一致性内存时，如果连续内存不足，返回 ENOMEM。
• ioremap映射窗口不足：内核的ioremap区域（通常为固定大小）被占满，无法创建新的映射。

// ENOMEM典型场景：映射大BAR失败
void __iomem *bar_mem = pci_ioremap_bar(pdev, 0);
if (!bar_mem) {
    // 注意：pci_ioremap_bar 返回 NULL 表示 ENOMEM，而非 ERR_PTR
    dev_err(&pdev->dev, "ioremap failed for BAR0 (ENOMEM)\n");
    return -ENOMEM;
}

3.3 错误码与调试路径关系图

下图展示了从错误码到调试方向的快速映射关系，帮助你在收到错误时选择正确的排查路径：

3.4 错误码优先级与快速排查清单

在实际调试中，错误码的出现往往不是孤立的。以下清单按优先级排序，帮助你在收到错误时快速定位：

1. 检查 dmesg 输出：搜索 BAR、pci、resource 关键字，确认错误码对应的完整日志行。
2. 验证BAR有效性：使用 lspci -vvv -s 01:00.0 查看BAR的地址、大小和Flags，排除 EINVAL 问题。
3. 检查资源占用：执行 cat /proc/iomem | grep -A 1 "01:00.0"，确认BAR区域是否被正确预留，排除 EBUSY。
4. 评估系统资源：使用 free -m 和 cat /proc/meminfo 检查内存压力，排除 ENOMEM。
5. 确认硬件状态：检查设备是否处于D0状态，以及固件是否锁定BAR，排除 EPERM。