devlink-dev(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | AUTHOR | COLOPHON

DEVLINK-DEV(8)                    Linux                   DEVLINK-DEV(8)

NAME         top

       devlink-dev - devlink device configuration

SYNOPSIS         top

       devlink [ OPTIONS ] dev  { COMMAND | help }

       OPTIONS := { -V[ersion] | -n[no-nice-names] }

       devlink dev show [ DEV ]

       devlink dev help

       devlink dev eswitch set DEV [ mode { legacy | switchdev } ] [
               inline-mode { none | link | network | transport } ] [
               encap-mode { none | basic } ]

       devlink dev eswitch show DEV

       devlink dev param set DEV name PARAMETER value VALUE cmode {
               runtime | driverinit | permanent }

       devlink dev param show [ DEV name PARAMETER ]

       devlink dev reload DEV [ netns { PID | NAME | ID } ] [ action {
               driver_reinit | fw_activate } ] [ limit no_reset ]

       devlink dev info [ DEV ]

       devlink dev flash DEV file PATH [ target ID ]

       devlink dev selftests show [ DEV ]

       devlink dev selftests run DEV [ id ID...  ]

DESCRIPTION         top

   devlink dev show - display devlink device attributes
       DEV - specifies the devlink device to show.  If this argument is
       omitted all devices are listed.

           Format is:
             BUS_NAME/BUS_ADDRESS

   devlink dev eswitch show - display devlink device eswitch attributes
   devlink dev eswitch set - sets devlink device eswitch attributes
       mode { legacy | switchdev }
              Set eswitch mode

              legacy - Legacy SRIOV

              switchdev - SRIOV switchdev offloads

       inline-mode { none | link | network | transport }
              Some HWs need the VF driver to put part of the packet
              headers on the TX descriptor so the e-switch can do proper
              matching and steering.

              none - None

              link - L2 mode

              network - L3 mode

              transport - L4 mode

       encap-mode { none | basic }
              Set eswitch encapsulation support

              none - Disable encapsulation support

              basic - Enable encapsulation support

   devlink dev param set - set new value to devlink device configuration
       parameter
       name PARAMETER
              Specify parameter name to set.

       value VALUE
              New value to set.

       cmode { runtime | driverinit | permanent }
              Configuration mode in which the new value is set.

              runtime - Set new value while driver is running. This
              configuration mode doesn't require any reset to apply the
              new value.

              driverinit - Set new value which will be applied during
              driver initialization. This configuration mode requires
              restart driver by devlink reload command to apply the new
              value.

              permanent - New value is written to device's non-volatile
              memory. This configuration mode requires hard reset to
              apply the new value.

   devlink dev param show - display devlink device supported
       configuration parameters attributes
       name PARAMETER Specify parameter name to show.  If this argument
       is omitted all parameters supported by devlink devices are
       listed.

   devlink dev reload - perform hot reload of the driver.
       DEV - Specifies the devlink device to reload.

       netns { PID | NAME | ID } - Specifies the network namespace to
       reload into, either by pid, name or id.

       action { driver_reinit | fw_activate } - Specifies the reload
       action required.  If this argument is omitted driver_reinit
       action will be used.  Note that even though user asks for a
       specific action, the driver implementation might require to
       perform another action alongside with it. For example, some
       driver do not support driver reinitialization being performed
       without fw activation. Therefore, the devlink reload command
       returns the list of actions which were actrually performed.

       driver_reinit - Driver entities re-initialization, applying
       devlink-param and devlink-resource values.

       fw_activate - Activates new firmware if such image is stored and
       pending activation. If no limitation specified this action may
       involve firmware reset. If no new image pending this action will
       reload current firmware image.

       limit no_reset - Specifies limitation on reload action.  If this
       argument is omitted limit is unspecified and the reload action is
       not limited. In such case driver implementation may include reset
       or downtime as needed to perform the actions.

       no_reset - No reset allowed, no down time allowed, no link flap
       and no configuration is lost.

   devlink dev info - display device information.
       Display device information provided by the driver. This command
       can be used to query versions of the hardware components or
       device components which can't be updated ( fixed ) as well as
       device firmware which can be updated. For firmware components
       running displays the versions of firmware currently loaded into
       the device, while stored reports the versions in device's flash.
       Running and stored versions may differ after flash has been
       updated, but before reboot.

       DEV - specifies the devlink device to show.  If this argument is
       omitted all devices are listed.

   devlink dev flash - write device's non-volatile memory.
       DEV - specifies the devlink device to write to.

       file PATH - Path to the file which will be written into device's
       flash. The path needs to be relative to one of the directories
       searched by the kernel firmware loader, such as /lib/firmware.

       component NAME - If device stores multiple firmware images in
       non-volatile memory, this parameter may be used to indicate which
       firmware image should be written.  The value of NAME should match
       the component names from devlink dev info and may be driver-
       dependent.

   devlink dev selftests show - shows supported selftests on devlink
       device.
       DEV - specifies the devlink device.  If this argument is omitted
       all selftests for devlink devices are listed.

   devlink dev selftests run - runs selftests on devlink device.
       DEV - specifies the devlink device to execute selftests.

       id ID...  - The value of ID(s) should match the selftests shown
       in devlink dev selftests show to execute selftests on the devlink
       device.  If this argument is omitted all selftests supported by
       devlink devices are executed.

EXAMPLES         top

       devlink dev show
           Shows the state of all devlink devices on the system.

       devlink dev show pci/0000:01:00.0
           Shows the state of specified devlink device.

       devlink dev eswitch show pci/0000:01:00.0
           Shows the eswitch mode of specified devlink device.

       devlink dev eswitch set pci/0000:01:00.0 mode switchdev
           Sets the eswitch mode of specified devlink device to
           switchdev.

       devlink dev param show pci/0000:01:00.0 name max_macs
           Shows the parameter max_macs attributes.

       devlink dev param set pci/0000:01:00.0 name internal_error_reset
       value true cmode runtime
           Sets the parameter internal_error_reset of specified devlink
           device to true.

       devlink dev reload pci/0000:01:00.0
           Performs hot reload of specified devlink device.

       devlink dev flash pci/0000:01:00.0 file firmware.bin
           Flashes the specified devlink device with provided firmware
           file name. If the driver supports it, user gets updates about
           the flash status. For example:
           Preparing to flash
           Flashing 100%
           Flashing done

       devlink dev selftests show pci/0000:01:00.0
           Shows the supported selftests by the devlink device.

       devlink dev selftests run pci/0000:01:00.0 id flash
           Perform a flash test on the devlink device.

SEE ALSO         top

       devlink(8), devlink-port(8), devlink-sb(8), devlink-monitor(8),

AUTHOR         top

       Jiri Pirko <jiri@mellanox.com>

COLOPHON         top

       This page is part of the iproute2 (utilities for controlling
       TCP/IP networking and traffic) project.  Information about the
       project can be found at 
       ⟨http://www.linuxfoundation.org/collaborate/workgroups/networking/iproute2⟩.
       If you have a bug report for this manual page, send it to
       netdev@vger.kernel.org, shemminger@osdl.org.  This page was
       obtained from the project's upstream Git repository
       ⟨https://git.kernel.org/pub/scm/network/iproute2/iproute2.git⟩ on
       2023-12-22.  (At that time, the date of the most recent commit
       that was found in the repository was 2023-12-20.)  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to man-pages@man7.org

iproute2                       14 Mar 2016                DEVLINK-DEV(8)

Pages that refer to this page: devlink(8)devlink-dpipe(8)devlink-health(8)devlink-lc(8)devlink-monitor(8)devlink-port(8)devlink-region(8)devlink-sb(8)devlink-trap(8)