devlink-port(8) — Linux manual page

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

DEVLINK-PORT(8)                   Linux                  DEVLINK-PORT(8)

NAME         top

       devlink-port - devlink port configuration

SYNOPSIS         top

       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 ] [
               pfnum PFNUMBER ] [ sfnum SFNUMBER ] [ controller CNUM ]

       devlink port del DEV/PORT_INDEX

       devlink port function set DEV/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 set DEV/PORT_INDEX name PARAMETER value VALUE
               cmode { runtime | driverinit | permanent }

       devlink dev param show [ DEV/PORT_INDEX name PARAMETER ]

       devlink port help

DESCRIPTION         top

   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 }
              set port type

              eth - Ethernet

              ib - Infiniband

              auto - autoselect

   devlink port split - split devlink port into more
       DEV/PORT_INDEX - specifies the devlink port to operate on.

       count COUNT
              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 }
              set port flavour

              pcipf - PCI PF port

              pcisf - PCI SF port

       pfnum PFNUMBER
              Specifies PCI pfnumber to use on which a SF device to
              create

       sfnum SFNUMBER
              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.

       controller CNUM
              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_addr ADDR
              Hardware address of the function to set. This is a
              Ethernet MAC address when port type is Ethernet.

       state { active | inactive }
              New state of the function to change to.

              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.

       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 port param show - display devlink port supported
       configuration parameters attributes
       DEV/PORT_INDEX - specifies the devlink port to operate on.

       name PARAMETER 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         top

       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 roce enable
           This will enable the RoCE functionality of the function.

       devlink port function set pci/0000:01:00.0/1 migratable enable
           This will enable the migratable functionality of the
           function.

       devlink port function set pci/0000:01:00.0/1 ipsec_crypto enable
           This will enable the IPsec crypto offload functionality of
           the function.

       devlink port function set pci/0000:01:00.0/1 ipsec_packet enable
           This will enable the IPsec packet offload functionality of
           the function.

       devlink port function set pci/0000:01:00.0/1 max_io_eqs 4
           This will set the maximum number of IO event queues of the
           function to 4.

       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.

       devlink port add pci/0000:06:00.0 flavour pcisf pfnum 0 sfnum 88
       controller 1
           Add a devlink port of flavour PCI SF on controller 1 which
           has PCI PF of 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 the
           function usage is completed, deactivate 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.

SEE ALSO         top

       devlink(8), devlink-dev(8), devlink-sb(8), devlink-monitor(8),
       devlink-health(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
       2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2024-06-11.)  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-PORT(8)

Pages that refer to this page: devlink(8)devlink-dev(8)devlink-health(8)devlink-lc(8)devlink-monitor(8)devlink-rate(8)devlink-region(8)devlink-resource(8)devlink-sb(8)