Examples of mstconfig Usage

To query the device’s configuration, use the following command line:

Copy
Copied!
            

# mstconfig -d <device> query

ConnectX-3 Example:

Copy
Copied!
            

# mstconfig -d 41:00.0 q   Device type: ConnectX-3 PCI device: 41:00.0 41:00.0 Device 1: ----------- Configurations: Next Boot SRIOV_EN True(1) NUM_OF_VFS 16 WOL_MAGIC_EN_P1 False(0) WOL_MAGIC_EN_P2 False(0)

Warning

N/A means that the device default configuration is set.

Warning

For Array type parameters, the query command will not show a value for it. It will only show you the word "Array" and the range of the array.

  • For example: HOST_CHAINING_DESCRIPTORS Array[0..7]

  • To query the fifth element in the array, run: mstconfig -d <device> query HOST_CHAINING_DESCRIPTORS[5]

  • To specify a range: mstconfig -d <device> query HOST_CHAINING_DESCRIPTORS[3..7]

  • To set the fifth element in the array, run: mstconfig -d <device> set HOST_CHAINING_DESCRIPTORS[5]=3

  • Or you can set value for more than one element: mstconfig -d <device> set HOST_CHAINING_DESCRIPTORS[3..7]=3

ConnectX-4 Lx Example:

Copy
Copied!
            

# mstconfig -d 41:00.0 --enable_verbosity q   Device #1: ---------- Device type: ConnectX4LX PCI device: 41:00.0     Configurations: Default Current Next Boot * NUM_OF_VFS 8 5 5 SRIOV_EN True(1) True(1) True(1) The '*' shows parameters with next value different from default/current value.

To set the device configuration, use the following command line:

Copy
Copied!
            

# mstconfig -d <device> set [Parameters....]

Example:

Copy
Copied!
            

# mstconfig -d 41:00.0 set WOL_MAGIC_EN_P2=1 NUM_OF_VFS=24 Device type: ConnectX-3 PCI device: 41:00.0 Configurations: Next Boot New NUM_OF_VFS 16 24 WOL_MAGIC_EN_P2 False(0) True(1)   Apply new Configuration?(y/n) [n]: y Applying... Done!   -I- Please reboot the system to load new configurations.

To reset the device configuration to default, use the following command line:

Copy
Copied!
            

# mstconfig -d <device> reset

Example:

Copy
Copied!
            

# mstconfig -d 41:00.0 reset Reset configuration for device 41:00.0? ? (y/n) [n] : y Applying... Done!     -I- Please power-cycle device to load new configurations. >mstconfig 41:00.0 query     Device 1: ---------- Device type: ConnectX-3 PCI Device: 41:00.0 Configurations: Next Boot SRIOV_EN True(1) NUM_OF_VFS 8 WOL_MAGIC_EN_P1 False(0) WOL_MAGIC_EN_P2 False(0)

© Copyright 2023, NVIDIA. Last updated on Feb 5, 2024.