RXE_CFG(8)                 System Manager's Manual                RXE_CFG(8)

NAME         top

       rxe_cfg - rxe configuration tool for RXE (Soft RoCE)

SYNOPSIS         top

       rxe_cfg [status]
       rxe_cfg start [-p proto]
       rxe_cfg stop
       rxe_cfg persistent
       rxe_cfg add [-n] ethN
       rxe_cfg remove [-n] ethN|rxeN
       rxe_cfg crc enable|disable
       rxe_cfg mtu [-f] [rxeN] mtu_size

DESCRIPTION         top

       rxe_cfg is the configuration tool for the RXE software implementation
       of the RoCE protocol.

       The RXE kernel modules are loaded, configured, reconfigured and
       unloaded via the various rxe_cfg command options, documented below.

PARAMETERS         top

       proto  Ethertype field. Default value is 0x8915. This value must be
              changed to use RXE on Mellanox ConnectX adapters.

       ethN   Network device name as listed in /sys/class/net. Only Ethernet
              devices are supported; ie. eth0 or eth0.1234 for VLANs.

       rxeN   RXE device name as listed in /sys/class/infiniband/. Examples
              are rxe0 or rxe1.

              RoCE mtu. For RoCE the mtu represents the payload excluding
              headers and has the possible values: 256, 512, 1024, 2048 and

COMMANDS         top

              The status command prints a table of information on available
              Ethernet devices and configured RXE instances.  The status
              display is the default if no options are provided.

       start [-p proto]
              The start command loads the RXE modules and configures any
              persistent instances.  If the -p proto option is included, the
              RXE modules will be configured to use Ethertype = proto.
              (This allows testing RXE on devices, like Mellanox ConnectX,
              that already support the default RoCE Ethertype in hardware.)

       stop   The stop command unconfigures all RXE instances and attempts
              to unload the kernel modules.

              The persistent command prints the list of Ethernet devices for
              which a RXE instance is persistently configured.

       add [-n] ethN
              The add command will configure a RXE instance on Ethernet
              device ethN (e.g. eth0).  The RXE modules must have already
              been loaded via rxe_cfg start.

              The default behavior is to add ethN to a file of persistent
              configurations and the same RXE device will be configured the
              next time that rxe_cfg start is run.  If the -n option is
              included the device is not added to the persistence file.

       remove [-n] ethN|rxeN
              The remove command will remove the specified RXE instance.
              The parameter must match a currently active ethN or rxeN name.

              If the -n option is included the RXE device will be removed
              but not removed from the persistent state. So it will be
              recreated the next time that rxe_cfg start is run.

       mtu [-f] [rxeN] mtu_size
              The mtu command will set the RoCE MTU of all RXE devices to
              mtu_size, provided that the underlying Ethernet MTU is
              sufficiently large.  If the Ethernet MTU is not large enough,
              RXE will use the largest MTU that fits; the driver remembers
              the requested RoCE MTU and will increase the currently active
              MTU if the Ethernet MTU is later changed up to the requested

              If the -f option is included the underlying Ethernet MTUs will
              be increased if necessary to the minimum size to accommodate a
              RoCE MTU of size.

              If a rxeN instance is specified then only that instance will
              be affected by the command.

       crc enable|disable
              The crc command will enable or disable RoCE ICRC calculation.
              Valid ICRCs are be required to communicate hardware RoCE NICs,
              but when a RXE instance is communicating with another RXE
              instance the performance will be better with the CRC disabled.

              This option is global to all RXE instances.

FILES         top

              RXE configuration file. Contains the list of persistent RXE
              instances.  All persistent RXE instances can be removed by
              deleting this file (note this will take effect on the next
              "rxe_cfg start" -- to remove actively configured instances,
              you must "rxe_cfg stop").

SEE ALSO         top


AUTHORS         top

       Written by John Groves, Frank Zago and Bob Pearson at System Fabric

COLOPHON         top

       This page is part of the rdma-core (RDMA Core Userspace Libraries and
       Daemons) project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug report
       for this manual page, send it to  This
       page was obtained from the project's upstream Git repository
       ⟨⟩ on 2019-07-28.  (At
       that time, the date of the most recent commit that was found in the
       repository was 2019-07-25.)  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

1.0.0                            2011-06-29                       RXE_CFG(8)

Pages that refer to this page: rxe(7)