NAME
mstconfig - set or query non-volatile configurable options for Mellanox HCAs
DESCRIPTION
-
NAME
-
mstconfig
-
SYNOPSIS
-
mstconfig [Options] <Commands> [Parameters]
-
DESCRIPTION:
-
Allows the user to change some of the device configurations without having to create and burn a new firmware.
-
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
- -p|--private_key
-
pem file for private key
- -u|--key_uuid
-
keypair uuid
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. (*)
- xml2bin
-
Generate Bin file from XML file. XML input file name and bin output file name must be specified. (*)
- create_conf
-
Generate Configuration file from XML file. XML input file name and bin output file name must be specified. (*)
- apply
-
Apply a Configuration file. bin input 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.