linux/Documentation/networking/devlink
Jacob Keller ff2e5c700e ice: add basic handler for devlink .info_get
The devlink .info_get callback allows the driver to report detailed
version information. The following devlink versions are reported with
this initial implementation:

 "fw.mgmt" -> The version of the firmware that controls PHY, link, etc
 "fw.mgmt.api" -> API version of interface exposed over the AdminQ
 "fw.mgmt.build" -> Unique build id of the source for the management fw
 "fw.undi" -> Version of the Option ROM containing the UEFI driver
 "fw.psid.api" -> Version of the NVM image format.
 "fw.bundle_id" -> Unique identifier for the combined flash image.
 "fw.app.name" -> The name of the active DDP package.
 "fw.app" -> The version of the active DDP package.

With this, devlink dev info can report at least as much information as
is reported by ETHTOOL_GDRVINFO.

Compare the output from ethtool vs from devlink:

  $ ethtool -i ens785s0
  driver: ice
  version: 0.8.1-k
  firmware-version: 0.80 0x80002ec0 1.2581.0
  expansion-rom-version:
  bus-info: 0000:3b:00.0
  supports-statistics: yes
  supports-test: yes
  supports-eeprom-access: yes
  supports-register-dump: yes
  supports-priv-flags: yes

  $ devlink dev info pci/0000:3b:00.0
  pci/0000:3b:00.0:
  driver ice
  serial number 00-01-ab-ff-ff-ca-05-68
  versions:
      running:
        fw.mgmt 2.1.7
        fw.mgmt.api 1.5
        fw.mgmt.build 0x305d955f
        fw.undi 1.2581.0
        fw.psid.api 0.80
        fw.bundle_id 0x80002ec0
        fw.app.name ICE OS Default Package
        fw.app 1.3.1.0

More pieces of information can be displayed, each version is kept
separate instead of munged together, and each version has an identifier
which comes with associated documentation.

Signed-off-by: Jacob Keller <jacob.e.keller@intel.com>
Acked-by: Jakub Kicinski <kuba@kernel.org>
Tested-by: Andrew Bowers <andrewx.bowers@intel.com>
Signed-off-by: Jeff Kirsher <jeffrey.t.kirsher@intel.com>
2020-03-21 01:00:32 -07:00
..
bnxt.rst devlink: document devlink info versions reported by bnxt_en driver 2020-01-27 11:33:29 +01:00
devlink-dpipe.rst devlink: introduce devlink-dpipe.rst documentation file 2020-01-10 17:07:00 -08:00
devlink-health.rst
devlink-info.rst devlink: promote "fw.bundle_id" to a generic info version 2020-03-21 00:57:16 -07:00
devlink-params.rst devlink: mention reloading in devlink-params.rst 2020-01-10 17:06:59 -08:00
devlink-region.rst devlink: remove trigger command from devlink-region.rst 2020-03-03 17:35:54 -08:00
devlink-resource.rst devlink: add a devlink-resource.rst documentation file 2020-01-10 17:07:00 -08:00
devlink-trap.rst devlink: add ACL generic packet traps 2020-02-24 11:55:06 -08:00
ice.rst ice: add basic handler for devlink .info_get 2020-03-21 01:00:32 -07:00
index.rst ice: add basic handler for devlink .info_get 2020-03-21 01:00:32 -07:00
ionic.rst devlink: add documentation for ionic device driver 2020-01-10 17:07:00 -08:00
mlx4.rst devlink: add a file documenting devlink regions 2020-01-10 17:07:00 -08:00
mlx5.rst net/mlx5e: Add devlink fdb_large_groups parameter 2020-02-27 16:40:19 -08:00
mlxsw.rst mlxsw: Add irif and erif disabled traps 2020-01-19 16:23:52 +01:00
mv88e6xxx.rst devlink: convert driver-specific files to reStructuredText 2020-01-10 17:06:59 -08:00
netdevsim.rst devlink: rename and expand devlink-trap-netdevsim.rst 2020-01-10 17:07:00 -08:00
nfp.rst devlink: document info versions for each driver 2020-01-10 17:06:59 -08:00
qed.rst devlink: fix typos in qed documentation 2020-01-15 23:14:31 +01:00
ti-cpsw-switch.rst devlink: convert driver-specific files to reStructuredText 2020-01-10 17:06:59 -08:00