devlink-port - Man Page

devlink port configuration


devlink [ OPTIONS ] port { COMMAND | help }

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

devlink port set DEV/PORT_INDEX [ type { eth | ib | auto } ]

devlink port split DEV/PORT_INDEX count COUNT

devlink port unsplit DEV/PORT_INDEX

devlink port show [ DEV/PORT_INDEX ]

devlink port health { show | recover | diagnose | dump | set }

devlink port add [ DEV | DEV/PORT_INDEX ] [ flavour FLAVOUR ] [ pcipf PFNUMBER ] { pcisf SFNUMBER }

devlink port del DEV/PORT_INDEX

devlink port function set DEV/PORT_INDEX { hw_addr ADDR } { state STATE }

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

devlink dev param show [ DEV/PORT_INDEX name PARAMETER ]

devlink port help



devlink port show

Shows the state of all devlink ports on the system.

devlink port show pci/0000:01:00.0/1

Shows the state of specified devlink port.

devlink port set pci/0000:01:00.0/1 type eth

Set type of specified devlink port to Ethernet.

devlink port split pci/0000:01:00.0/1 count 4

Split the specified devlink port into four ports.

devlink port unsplit pci/0000:01:00.0/1

Unplit the specified previously split devlink port.

devlink port health show

Shows status and configuration of all supported reporters registered on all devlink ports.

devlink port health show pci/0000:01:00.0/1 reporter tx

Shows status and configuration of tx reporter registered on pci/0000:01:00.0/1 devlink port.

devlink port add pci/0000:06:00.0 flavour pcisf pfnum 0 sfnum 88

Add a devlink port of flavour PCI SF on PCI PF having number 0 with SF number 88. To make use of the function an example sequence is to add a port, configure the function attribute and activate the function. Once function usage is completed, inactivate the function and finally delete the port. When there is desire to reuse the port without deletion, it can be reconfigured and activated again when function is in inactive state and function's operational state is detached.

devlink port del pci/0000:06:00.0/1

Delete previously created devlink port. It is recommended to first deactivate the function if the function supports state management.

devlink port function set pci/0000:01:00.0/1 hw_addr 00:00:00:11:22:33

Configure hardware address of the PCI function represented by devlink port. If the port supports change in function state, hardware address must be configured before activating the function.

devlink port function set pci/0000:01:00.0/1 state active

Activate the function. This will initiate the function enumeration and driver loading.

devlink port function set pci/0000:01:00.0/1 state inactive

Deactivate the function. This will initiate the function teardown which results in driver unload and device removal.

devlink port function set pci/0000:01:00.0/1 hw_addr 00:00:00:11:22:33 state active

Configure hardware address and also active the function. When a function is activated together with other configuration in a single command, all the configuration is applied first before changing the state to active.

devlink dev param show

Shows (dumps) all the port parameters across all the devices registered in the devlink.

devlink dev param set pci/0000:01:00.0/1 name internal_error_reset value true cmode runtime

Sets the parameter internal_error_reset of specified devlink port (#1) to true.

See Also

devlink(8), devlink-dev(8), devlink-sb(8), devlink-monitor(8), devlink-health(8),


Jiri Pirko <>

Referenced By

devlink(8), devlink-dev(8), devlink-health(8), devlink-monitor(8), devlink-region(8), devlink-resource(8), devlink-sb(8).

14 Mar 2016 iproute2 Linux