The Linux Kernel
5.6.0
  • The Linux kernel user’s and administrator’s guide
  • Kernel Build System
  • The Linux kernel firmware guide
  • The Linux kernel user-space API guide
  • Working with the kernel development community
  • Development tools for the kernel
  • How to write kernel documentation
  • Kernel Hacking Guides
  • Linux Tracing Technologies
  • Kernel Maintainer Handbook
  • fault-injection
  • Kernel Livepatching
  • The Linux driver implementer’s API guide
  • Core API Documentation
  • locking
  • Accounting
  • Block
  • cdrom
  • Integrated Drive Electronics (IDE)
  • Frame Buffer
  • fpga
  • Human Interface Devices (HID)
  • I2C/SMBus Subsystem
  • Industrial I/O
  • ISDN
  • InfiniBand
  • LEDs
  • Linux Media Subsystem Documentation
  • NetLabel
  • Linux Networking Documentation
    • netdev FAQ
    • AF_XDP
    • batman-adv
    • SocketCAN - Controller Area Network
    • The UCAN Protocol
    • Vendor Device Drivers
    • Distributed Switch Architecture
    • Linux Devlink Documentation
      • Interface documentation
        • Devlink DPIPE
        • Devlink Health
        • Devlink Info
        • Devlink Params
        • Devlink Region
        • Devlink Resource
        • Devlink Trap
      • Driver-specific documentation
    • Netlink interface for ethtool
    • IEEE 802.15.4 Developer’s Guide
    • J1939 Documentation
    • Linux Networking and Network Devices APIs
    • Z8530 Programming Guide
    • MSG_ZEROCOPY
    • FAILOVER
    • NET_FAILOVER
    • PHY Abstraction Layer
    • phylink
    • IP-Aliasing
    • Ethernet Bridging
    • SNMP counter
    • Checksum Offloads
    • Segmentation Offloads
    • Scaling in the Linux Networking Stack
    • Kernel TLS
    • Kernel TLS offload
    • Linux NFC subsystem
  • pcmcia
  • Power Management
  • TCM Virtual Device
  • timers
  • Serial Peripheral Interface (SPI)
  • 1-Wire Subsystem
  • Linux Watchdog Support
  • Linux Virtualization Support
  • The Linux Input Documentation
  • Linux Hardware Monitoring
  • Linux GPU Driver Developer’s Guide
  • Security Documentation
  • Linux Sound Subsystem Documentation
  • Linux Kernel Crypto API
  • Filesystems in the Linux kernel
  • Linux Memory Management Documentation
  • BPF Documentation
  • USB support
  • Linux PCI Bus Subsystem
  • Assorted Miscellaneous Devices Documentation
  • Intel Many Integrated Core (MIC) architecture
  • Linux Scheduler
  • Assembler Annotations
  • ARM Architecture
  • ARM64 Architecture
  • IA-64 Architecture
  • m68k Architecture
  • MIPS-specific Documentation
  • Linux on the Nios II architecture
  • OpenRISC Architecture
  • PA-RISC Architecture
  • powerpc
  • RISC-V architecture
  • s390 Architecture
  • SuperH Interfaces Guide
  • Sparc Architecture
  • x86-specific Documentation
  • Xtensa Architecture
  • ext4 Data Structures and Algorithms
  • Translations
The Linux Kernel
  • Docs »
  • Linux Networking Documentation »
  • Linux Devlink Documentation »
  • Devlink Info
  • View page source

Devlink Info¶

The devlink-info mechanism enables device drivers to report device information in a generic fashion. It is extensible, and enables exporting even device or driver specific information.

devlink supports representing the following types of versions

List of version types¶
Type Description
fixed Represents fixed versions, which cannot change. For example, component identifiers or the board version reported in the PCI VPD.
running Represents the version of the currently running component. For example the running version of firmware. These versions generally only update after a reboot.
stored Represents the version of a component as stored, such as after a flash update. Stored values should update to reflect changes in the flash even if a reboot has not yet occurred.

Generic Versions¶

It is expected that drivers use the following generic names for exporting version information. Other information may be exposed using driver-specific names, but these should be documented in the driver-specific file.

board.id¶

Unique identifier of the board design.

board.rev¶

Board design revision.

asic.id¶

ASIC design identifier.

asic.rev¶

ASIC design revision.

board.manufacture¶

An identifier of the company or the facility which produced the part.

fw¶

Overall firmware version, often representing the collection of fw.mgmt, fw.app, etc.

fw.mgmt¶

Control unit firmware version. This firmware is responsible for house keeping tasks, PHY control etc. but not the packet-by-packet data path operation.

fw.app¶

Data path microcode controlling high-speed packet processing.

fw.undi¶

UNDI software, may include the UEFI driver, firmware or both.

fw.ncsi¶

Version of the software responsible for supporting/handling the Network Controller Sideband Interface.

fw.psid¶

Unique identifier of the firmware parameter set.

fw.roce¶

RoCE firmware version which is responsible for handling roce management.

Next Previous

© Copyright The kernel development community

Built with Sphinx using a theme provided by Read the Docs.