mstconfig - Man Page

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.

See Also

mstflint(1)

Info

March 2020 mstflint