Scroll to navigation

MSTCONFIG(1) MSTCONFIG(1)

NAME

mstconfig - set or query non-volatile configurable options for Mellanox HCAs

SYNOPSIS

mstconfig [Options] <Commands> [Parameters]

OPTIONS

-d|--dev <device>
: Perform operation for a specified MST device.
-b|--db <filename>
: Use a specific database file.
-f|--file <conf_file>
: raw configuration file.
-h|--help
: Display help message.
-v|--version
: Display version info.
-e|--enable_verbosity
: Show default and current configurations.
-y|--yes
: Answer yes in prompt.
-a|--all_attrs
: Show all attributes in the XML template

COMMANDS:

clear_semaphore
: clear the tool semaphore.
i[show_confs]
: display information about all configurations.
q[uery]
: query supported configurations.
r[eset]
: reset all configurations to their default value.
s[et]
: set configurations to a specific device.
set_raw
: set raw configuration file.(only Connect-IB/Connect-X4/LX.)
backup
: backup configurations to a file.(only Connect-IB/Connect-X4/LX.). Use set_raw command to restore file.
gen_tlvs_file
: Generate List of all TLVs. TLVs output file name must be specified. (*)
g[en_xml_template]
: Generate XML template. TLVs input file name and XML output file name must be specified. (*)
xml2raw
: Generate Raw file from XML file. XML input file name and raw output file name must be specified. (*)
raw2xml
: Generate XML file from Raw file. raw input file name and XML output file name must be specified. (*)

(*) These commands do not require MST device

To show supported configurations by device type, run show_confs command

Examples:
To query configurations
: mstconfig -d 04:00.0 query
To set configuration
: mstconfig -d 04:00.0 set SRIOV_EN=1 NUM_OF_VFS=16 WOL_MAGIC_EN_P1=1
To set raw configuration
: mstconfig -d 05:00.0 -f conf_file set_raw
To reset configuration
: mstconfig -d 04:00.0 reset

Supported devices: 4th Generation devices: ConnectX3, ConnectX3-Pro (FW 2.31.5000 and above). 5th Generation devices: ConnectIB, ConnectX4, ConnectX4-LX, ConnectX5.

Note: query device to view supported configurations by Firmware.

4.6.0 10 January 2017