mstconfig1
Set or query non-volatile configurable options for mellanox hcas
Overview
-
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
-d04:00.0 query
- To set configuration
-
mstconfig
-d04:00.0 set SRIOV_EN=1 NUM_OF_VFS=16 WOL_MAGIC_EN_P1=1
- To set raw configuration
-
mstconfig
-d05:00.0-fconf_file set_raw
- To reset configuration
-
mstconfig
-d04: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.
History
- Debian 13 (Trixie): the text shown here
- Debian 12 (Bookworm)
- Debian 11 (Bullseye)
- Debian 10 (Buster)
- Debian 9 (Stretch)