Logo

Linux 内核

6.13.0-rc6

快速搜索

目录

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

本页

  • 显示源文件

Devlink 参数¶

devlink 为驱动程序提供了一种暴露底层设备功能参数的能力。 由于 devlink 可以在设备级别运行,因此它可以用于提供可能影响单个设备上多个端口的配置。

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

配置模式¶

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

可能的配置模式¶

名称

描述

runtime

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

driverinit

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

permanent

写入设备的非易失性存储器。 需要硬复位才能生效。

重新加载¶

为了使 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 也被编程到其父网络设备的 Function rx 过滤器中。 此参数限制了每个设备以太网端口接收流量的单播 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 强力驱动 | 页面源文件