devlink-dev - devlink device configuration

       Jiri Pirko <jiri@mellanox.com>

iproute2                                           14 Mar 2016                                    DEVLINK-DEV(8)

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

           Format is:
             BUS_NAME/BUS_ADDRESS

   devlinkdeveswitchshow-displaydevlinkdeviceeswitchattributesdevlinkdeveswitchset-setsdevlinkdeviceeswitchattributesmode { 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

   devlinkdevparamset-setnewvaluetodevlinkdeviceconfigurationparameternamePARAMETER
              Specify parameter name to set.

       valueVALUE
              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.

   devlinkdevparamshow-displaydevlinkdevicesupportedconfigurationparametersattributesnamePARAMETER Specify parameter name to show.  If this argument is omitted all parameters  supported  by
       devlink devices are listed.

   devlinkdevreload-performhotreloadofthedriver.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.

       limitno_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.

   devlinkdevinfo-displaydeviceinformation.
       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.

   devlinkdevflash-writedevice'snon-volatilememory.DEV - specifies the devlink device to write to.

       filePATH - 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.

       componentNAME - 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 devlinkdevinfo and may be driver-dependent.

   devlinkdevselftestsshow-showssupportedselftestsondevlinkdevice.DEV - specifies the devlink device.  If this argument is omitted all selftests for  devlink  devices  are
       listed.

   devlinkdevselftestsrun-runsselftestsondevlinkdevice.DEV - specifies the devlink device to execute selftests.

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

       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.

       devlink-dev - devlink device configuration

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

devlink [ OPTIONS ] dev  { COMMAND | help }

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

       devlinkdevshow [ DEV ]

       devlinkdevhelpdevlinkdeveswitchsetDEV [ mode { legacy | switchdev } ] [ inline-mode { none | link | network |
               transport } ] [ encap-mode { none | basic } ]

       devlinkdeveswitchshowDEVdevlinkdevparamsetDEVnamePARAMETERvalueVALUEcmode { runtime | driverinit | permanent }

       devlinkdevparamshow [ DEVnamePARAMETER ]

       devlinkdevreloadDEV [ netns { PID | NAME | ID } ] [ action { driver_reinit | fw_activate } ] [ limitno_reset ]

       devlinkdevinfo [ DEV ]

       devlinkdevflashDEVfilePATH [ targetID ]

       devlinkdevselftestsshow [ DEV ]

       devlinkdevselftestsrunDEV [ idID...  ]