| type { eth | ib | auto } | eth - Ethernet ib - Infiniband auto - autoselect |
| countCOUNT | number of ports to split to. |
| flavour { pcipf | pcisf } | pcipf - PCI PF port pcisf - PCI SF port |
| pfnumPFNUMBER | Specifies PCI pfnumber to use on which a SF device to create |
| sfnumSFNUMBER | Specifies sfnumber to assign to the device of the SF. This field is optional for those devices which supports auto assignment of the SF number. |
| controllerCNUM | Specifies controller number for which the SF port is created. This field is optional. It is used only when SF port is created for the external controller. |
| hw_addrADDR | Hardware address of the function to set. This is a Ethernet MAC address when port type is Ethernet. |
| state { active | inactive } | active - Once configuration of the function is done, activate the function. inactive - To inactivate the function and its device(s), set to inactive. |
| roce { enable | disable } | Set the RoCE capability of the function. |
| migratable { enable | disable } | Set the migratable capability of the function. |
| ipsec_crypto { enable | disable } | Set the IPsec crypto offload capability of the function. Controls XFRM state crypto operation (Encrypt/Decrypt) offload. |
| ipsec_packet { enable | disable } | Set the IPsec packet offload capability of the function. Controls XFRM state and policy offload (Encrypt/Decrypt operation and IPsec encapsulation). |
| max_io_eqs EQS | Set the maximum number of IO event queues of the function. |
| namePARAMETER | Specify parameter name to set. |
| valueVALUE | New value to set. |
| cmode { runtime | driverinit | permanent } | 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. |
NAME
devlink-port - devlink port configuration
SYNOPSIS
devlink [ OPTIONS ] port { COMMAND | help }
OPTIONS := { -V[ersion] | -n[no-nice-names] }
devlink port setDEV/PORT_INDEX [ type { eth | ib | auto } ]
devlink port splitDEV/PORT_INDEXcountCOUNT
devlink port unsplitDEV/PORT_INDEX
devlink port show [ DEV/PORT_INDEX ]
devlink port health { show | recover | diagnose | dump | set }
devlink port add { DEV | DEV/PORT_INDEX } [ flavourFLAVOUR ] [ pfnumPFNUMBER ] [ sfnumSFNUMBER ] [ controllerCNUM ]
devlink port delDEV/PORT_INDEX
devlink port function setDEV/PORT_INDEX [ hw_addr ADDR ] [ state { active | inactive } ] [ roce { enable | disable } ] [ migratable { enable | disable } ] [ ipsec_crypto { enable | disable } ] [ ipsec_packet { enable | disable } ] [ max_io_eqs EQS ]
devlink port function rate { show | set | add | del | help }
devlink dev param setDEV/PORT_INDEXnamePARAMETERvalueVALUEcmode { runtime | driverinit | permanent }
devlink dev param show [ DEV/PORT_INDEXnamePARAMETER ]
devlink port help
DESCRIPTION
devlink port set - change devlink port attributes
DEV/PORT_INDEX - specifies the devlink port to operate on.
Format is: BUS_NAME/BUS_ADDRESS/PORT_INDEX
- type { eth | ib | auto }
eth - Ethernet
ib - Infiniband
auto - autoselect
devlink port split - split devlink port into more
DEV/PORT_INDEX - specifies the devlink port to operate on.
- countCOUNT
number of ports to split to.
devlink port unsplit - unsplit previously split devlink port
Could be performed on any split port of the same split group.
DEV/PORT_INDEX - specifies the devlink port to operate on.
devlink port show - display devlink port attributes
DEV/PORT_INDEX - specifies the devlink port to show. If this argument is omitted all ports are listed.
devlink port health - devlink health reporting and recovery
Is an alias for devlink-health(8).
devlink port add - add a devlink port
DEV - specifies the devlink device to operate on. or
DEV/PORT_INDEX - specifies the devlink port index to use for the requested new port. This is optional. When omitted, driver allocates unique port index.
- flavour { pcipf | pcisf }
pcipf - PCI PF port
pcisf - PCI SF port
- pfnumPFNUMBER
Specifies PCI pfnumber to use on which a SF device to create
- sfnumSFNUMBER
Specifies sfnumber to assign to the device of the SF. This field is optional for those devices which supports auto assignment of the SF number.
- controllerCNUM
Specifies controller number for which the SF port is created. This field is optional. It is used only when SF port is created for the external controller.
devlink port function set - Set the port function attribute(s).
DEV/PORT_INDEX - specifies the devlink port to operate on.
- hw_addrADDR
Hardware address of the function to set. This is a Ethernet MAC address when port type is Ethernet.
- state { active | inactive }
active - Once configuration of the function is done, activate the function.
inactive - To inactivate the function and its device(s), set to inactive.
- roce { enable | disable }
Set the RoCE capability of the function.
- migratable { enable | disable }
Set the migratable capability of the function.
- ipsec_crypto { enable | disable }
Set the IPsec crypto offload capability of the function. Controls XFRM state crypto operation (Encrypt/Decrypt) offload.
- ipsec_packet { enable | disable }
Set the IPsec packet offload capability of the function. Controls XFRM state and policy offload (Encrypt/Decrypt operation and IPsec encapsulation).
- max_io_eqs EQS
Set the maximum number of IO event queues of the function.
devlink port del - delete a devlink port
DEV/PORT_INDEX - specifies the devlink port to delete.
devlink port param set - set new value to devlink port configuration parameter
DEV/PORT_INDEX - specifies the devlink port to operate on.
- namePARAMETER
Specify parameter name to set.
- valueVALUE
New value to set.
- cmode { runtime | driverinit | permanent }
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 port param show - display devlink port supported configuration parameters attributes
DEV/PORT_INDEX - specifies the devlink port to operate on.
namePARAMETER Specify parameter name to show. If this argument, as well as port index, are omitted - all parameters supported by devlink device ports are listed.
devlink port function rate - manage devlink rate objects
Is an alias for devlink-rate(8).
EXAMPLES
devlink port show
devlink port show pci/0000:01:00.0/1
devlink port set pci/0000:01:00.0/1 type eth
devlink port split pci/0000:01:00.0/1 count 4
devlink port unsplit pci/0000:01:00.0/1
devlink port health show
devlink port health show pci/0000:01:00.0/1 reporter tx
devlink port add pci/0000:06:00.0 flavour pcisf pfnum 0 sfnum 88
devlink port del pci/0000:06:00.0/1
devlink port function set pci/0000:01:00.0/1 hw_addr 00:00:00:11:22:33
devlink port function set pci/0000:01:00.0/1 state active
devlink port function set pci/0000:01:00.0/1 state inactive
devlink port function set pci/0000:01:00.0/1 roce enable
devlink port function set pci/0000:01:00.0/1 migratable enable
devlink port function set pci/0000:01:00.0/1 ipsec_crypto enable
devlink port function set pci/0000:01:00.0/1 ipsec_packet enable
devlink port function set pci/0000:01:00.0/1 max_io_eqs 4
devlink port function set pci/0000:01:00.0/1 hw_addr 00:00:00:11:22:33 state active
devlink dev param show
devlink dev param set pci/0000:01:00.0/1 name internal_error_reset value true cmode runtime
devlink port add pci/0000:06:00.0 flavour pcisf pfnum 0 sfnum 88 controller 1
SEE ALSO
devlink(8), devlink-dev(8), devlink-sb(8), devlink-monitor(8), devlink-health(8),
AUTHOR
Jiri Pirko <[email protected]>