Using mlxconifg with PCI Device in Bus Device Function (BDF) Format
In order to access device in BDF format via configuration cycles, use "pciconf-" as prefix to the device.
Using mlxconfig to Set IB/ETH Parameters
In order to set IB/ETH parameters through mlxconfig, use the following command line:
Example: Configuring both ports as InfiniBand:
Using mlxconfig to Set SR-IOV Parameters
In order to set SR-IOV parameters through mlxconfig, use the following command line:
Example: Turning on SR-IOV and enabling 8 Virtual Functions per Physical Function:
Using mlxconfig to Set Preboot Settings
For a full description of the preboot configurable parameters refer to Supported Configurations and their Parameters under "Preboot Settings".
Example: Enable boot option ROM on port 1, set boot retries to 3 and set the boot protocol to PXE (on ConnectX-3 Pro cards only).
Example: Configure VLAN ID to 3 on port 2
Using mlxconfig to Split a Port in a Remotely Managed Switch
The break-out cable is a unique NVIDIA capability, where a single physical quad-lane QSFP port is divided into 2 dual-lane ports. It maximizes the flexibility of the end user to use the NVIDIA switch with a combination of dual-lane and quad-lane interfaces according to the specific requirements of its network. All system ports may be split into 2-lane ports. Splitting a port changes the notation of that port from x/y to x/y/z with “x/y” indicating the previous notation of the port prior to the split and “z” indicating the number of the resulting sub-physical port (1,2). Each sub-physical port is then handled as an individual port. For example, splitting port 5 into 2 lanes gives the following new ports: 1/5/1 & 1/5/2.
To enable the port split, the following actions are required:
Step 1. Set the Split Mode in a Remotely Managed Switch.
To create a query for the Split Mode parameter using mlxconfig:
Step 2. Split a Port in a Remotely Managed Switch.
To split a specific port for one or more ports of (1-64) using mlxconfig:
Please note that although the command, is “set SPLIT_PORT[33..64]”, it splits a specific port for one or more ports of the higher ports (33-40).
Please note that the first port is set as 1, e.g., , [1..64].
How to turn on the split port for the first port only:
How to turn on the split port for the first 32 ports (range of ports):
How to turn on the split port for the last 8 ports:
How to turn off the split port for port 40:
How to query the split port for the first 32 ports:
Step 3. Reboot the switch.
To disable the port split, the following actions are required:
Step 1. Disable the Split Ports in a Remotely Managed Switch:
To unsplit a specific port for one or more ports (1-32) using mlxconfig:
Step 2. Disable the Split Mode in a Remotely Managed Switch.
mlxconfig Raw Configuration Files
mlxconfig allows applying raw configuration file for a pre-set configuration. Raw configuration files are intended for advanced users. This document does not cover the generation of such files.
Set the raw configuration file:
Never apply files from an unreliable source.