Logo

Linux 内核

6.16.0-rc4

快速搜索

目录

  • 开发流程
  • 提交补丁
  • 行为准则
  • 维护者手册
  • 所有开发流程文档
  • 核心 API
  • 驱动 API
  • 子系统
    • 核心子系统
    • 人机接口
    • 网络接口
      • 网络
      • NetLabel
      • InfiniBand
      • ISDN
      • MHI
    • 存储接口
    • 其他子系统
  • 锁定
  • 许可规则
  • 编写文档
  • 开发工具
  • 测试指南
  • 开发指南
  • 追踪
  • 故障注入
  • 热补丁
  • Rust
  • 管理
  • 构建系统
  • 报告问题
  • 用户空间工具
  • 用户空间 API
  • 固件
  • 固件与设备树
  • CPU 架构
  • 未分类文档
  • 翻译

本页

  • 显示源

Devlink 参数¶

devlink 提供驱动程序暴露低级设备功能参数的能力。由于 devlink 可以在设备级操作,因此它可用于提供可能影响单个设备上多个端口的配置。

本文档描述了多个驱动程序支持的通用参数。每个驱动程序也可以自由添加自己的参数。每个驱动程序都必须记录其支持的特定参数,无论是通用参数还是非通用参数。

配置模式¶

参数可以在不同的配置模式下设置。

可能的配置模式¶

名称

描述

运行时

在驱动程序运行时设置,并立即生效。无需重置。

驱动初始化

在驱动程序初始化时应用。需要用户使用 devlink reload 命令重启驱动程序。

永久

写入设备的非易失性内存。需要硬重置才能生效。

重新加载¶

为了使 driverinit 参数生效,驱动程序必须支持通过 devlink-reload 命令进行重新加载。此命令将请求重新加载设备驱动程序。

通用配置参数¶

以下是驱动程序可以添加的通用配置参数列表。建议使用通用参数,而不是每个驱动程序都创建自己的名称。

通用参数列表¶

名称

类型

描述

enable_sriov

布尔

在设备中启用单根 I/O 虚拟化 (SRIOV)。

ignore_ari

布尔

忽略替代路由 ID 解释 (ARI) 功能。如果启用,即使平台已启用支持,适配器也会忽略 ARI 功能。设备将创建与平台不支持 ARI 时相同数量的分区。

msix_vec_per_pf_max

u32

提供设备可以创建的最大 MSI-X 中断数。该值在设备中的所有物理功能 (PF) 中都相同。

msix_vec_per_pf_min

u32

提供设备初始化所需的最小 MSI-X 中断数。该值在设备中的所有物理功能 (PF) 中都相同。

fw_load_policy

u8

控制设备的固件加载策略。
  • DEVLINK_PARAM_FW_LOAD_POLICY_VALUE_DRIVER (0) 加载驱动程序首选的固件版本。

  • DEVLINK_PARAM_FW_LOAD_POLICY_VALUE_FLASH (1) 加载当前存储在闪存中的固件。

  • DEVLINK_PARAM_FW_LOAD_POLICY_VALUE_DISK (2) 加载当前主机磁盘上可用的固件。

reset_dev_on_drv_probe

u8

控制设备在驱动程序探测时的重置策略。
  • DEVLINK_PARAM_RESET_DEV_ON_DRV_PROBE_VALUE_UNKNOWN (0) 未知或无效值。

  • DEVLINK_PARAM_RESET_DEV_ON_DRV_PROBE_VALUE_ALWAYS (1) 始终在驱动程序探测时重置设备。

  • DEVLINK_PARAM_RESET_DEV_ON_DRV_PROBE_VALUE_NEVER (2) 从不在驱动程序探测时重置设备。

  • DEVLINK_PARAM_RESET_DEV_ON_DRV_PROBE_VALUE_DISK (3) 仅当在文件系统中找到固件时才重置设备。

enable_roce

布尔

在设备中启用 RoCE 流量处理。

enable_eth

布尔

启用后,设备驱动程序将实例化 devlink 设备的以太网特定辅助设备。

enable_rdma

布尔

启用后,设备驱动程序将实例化 devlink 设备的 RDMA 特定辅助设备。

enable_vnet

布尔

启用后,设备驱动程序将实例化 devlink 设备的 VDPA 网络特定辅助设备。

enable_iwarp

布尔

在设备中启用 iWARP 流量处理。

internal_err_reset

布尔

启用后,设备驱动程序将在内部错误时重置设备。

max_macs

u32

通常,macvlan、vlan 网络设备的 MAC 地址也编程在其父网络设备的函数接收过滤器中。此参数限制了每个以太网端口接收来自设备的单播 MAC 地址过滤器的最大数量。

region_snapshot_enable

布尔

启用 devlink-region 快照的捕获。

enable_remote_dev_reset

布尔

启用远程主机重置设备。清除后,设备驱动程序将 NACK 任何其他主机重置设备的尝试。此参数对于设备由不同主机共享的设置(例如多主机设置)非常有用。

io_eq_size

u32

控制 I/O 完成 EQ 的大小。

event_eq_size

u32

控制异步控制事件 EQ 的大小。

©内核开发社区。 | 由 Sphinx 5.3.0 和 Alabaster 0.7.16 提供技术支持 | 页面源