Nvidia MSTFLINT Operator's manual

Exported on Apr/28/2022 11:57 AM







MSTFLINT Package -Firmware Burning and
Diagnostics Tools Documentation v4.20.0



2
Table of Contents
Overview ........................................................................................ 5
Intended Audience...................................................................................5
Document Revision History .........................................................................5
Release Notes................................................................................... 6
Release Notes Update History......................................................................6
General Information .................................................................................6
Package Tools ..................................................................................... 6
Dependencies..................................................................................... 7
mstflint Supported Operating Systems and Platforms...................................... 8
Supported Flash Types......................................................................... 11
Supported Interface Cards (NICs)............................................................ 12
Supported Switch Systems Software ........................................................ 12
Changes and New Features....................................................................... 13
mstflint Bug Fixes in this Version................................................................ 14
mstflint Known Issues ............................................................................. 14
Introduction....................................................................................17
Supported Operating Systems.................................................................... 17
Access to Hardware Devices...................................................................... 17
Compilation and Installation ..................................................................... 18
Firmware Generation, Configuration, and Update Tools................................19
mstfwmanager – Firmware Update and Query Tool........................................... 19
mstfwmanager Synopsis....................................................................... 19
Querying the Device ........................................................................... 20
Archived Images Content ..................................................................... 21
mstarchive – Binary Files Compression Tool.................................................... 22
mstarchive Synopsis ........................................................................... 22
mstconfig – Changing Device Configuration Tool .............................................. 23
Tool Requirements ............................................................................. 23
mstconfig Synopsis............................................................................. 23
Examples of mstconfig Usage ................................................................ 24
Using mstconfig ................................................................................ 26
mstconfig Commands.......................................................................... 28

3
mstconfig Supported Configurations and Parameters .................................... 30
mstflint – Firmware Burning Tool ................................................................ 31
Switches Options............................................................................... 31
Command Parameters ......................................................................... 34
mstflint: Burning a Firmware Image ........................................................ 35
mstflint: Managing an Expansion ROM Image .............................................. 41
mstflint: Performing Checksum Calculation on Image/Device.......................... 41
mstflint: Querying the Firmware Image .................................................... 42
mstflint: Setting GUIDs and MACs ........................................................... 43
mstflint: Verifying the Firmware Image .................................................... 47
mstflint: Setting the VSD ..................................................................... 48
mstflint: Disabling/Enabling Access to the Hardware .................................... 49
mstflint: Flash Operations.................................................................... 50
mstflint: Comparing the Binary Image...................................................... 52
mstflint: Firmware Timestamping for Multi-Host Environment ......................... 52
mstflint Limitations ........................................................................... 54
mstflint: Secure Host.......................................................................... 54
mstflint: Secure Firmware Update .......................................................... 56
mstfwreset – Loading Firmware on 5th Generation Devices Tool........................... 60
Tool Requirements ............................................................................. 60
mstfwreset Synopsis ........................................................................... 60
Reset Levels and Types........................................................................ 61
mstfwreset for Multi-Host NICs .............................................................. 61
mstfwreset for Socket-Direct NICs .......................................................... 62
mstfwreset for SmartNICs .................................................................... 62
Examples of mstfwreset Usage .............................................................. 62
mstfwreset Limitations ....................................................................... 63
mstcongestion – Tool for Setting Congestion Mode and Action.............................. 63
Tool Requirements ............................................................................. 64
mstcongestion Synopsis ....................................................................... 64
mstprivhost - NIC Configuration by the Host Restriction Tool............................... 64
mstprivhost Synopsis .......................................................................... 64
Disabling/Enabling Access to the Hardware ................................................... 65
4th Generation Devices ....................................................................... 65

4
5th Generation Devices ....................................................................... 66
Debug Utilities.................................................................................68
mstfwtrace Utility ................................................................................. 68
mstfwtrace Usage.............................................................................. 68
mstregdump Utility ................................................................................ 69
mstdregump Usage ............................................................................ 69
mstreg Utility....................................................................................... 70
mstreg Usage ................................................................................... 70
mstlink Utility ...................................................................................... 72
mstlink Usage................................................................................... 72
Margin Scan Tool ............................................................................... 78
Rx-to-Tx Loopback Mode Activation......................................................... 79
Tool Usage with NIC vs. Switch (-p Flag) ................................................... 79
mstresourcedump Utility ......................................................................... 80
mstresourcedump Usage...................................................................... 81
mstresourceparse Utility.......................................................................... 83
mstresourceparse Usage ...................................................................... 83
Troubleshooting ...............................................................................86
General Related Issues ............................................................................ 86
mstconfig Related Issues.......................................................................... 86
Installation Related Issues ........................................................................ 87
Firmware Burning Related Issues ................................................................ 87
Secure Firmware Related Issues ................................................................. 89
Appendixes.....................................................................................91
mstflint - Updating Firmware Using ethtool/devlink and .mfa2 File ...................... 91
mstflint User Manual Revision History .....................................................93
Release Notes Revision History .............................................................96
mstflint Release Notes Change Log History .................................................... 96
mstflint Bug Fixes History .......................................................................114


5
•
•
Overview
The NVIDIA®Firmware Tools (mstflint) package is a set of firmware management and debug tools for
NVIDIA devices. The document describes mstflint features, tools content and configuration.
The documentation here relates to:
Release Notes
User Manual
Intended Audience
This manual is intended for system administrators responsible for managing and debugging
firmwareforNVIDIAdevices.
Document Revision History
A list of the changes made to the user manual are provided inDocument Revision History.

6
Release Notes
These are the release notes for mstflint. mstflint supports Linux operating system. Please see the
supported platform table for further details.
The tools functionality is identical in all operating systems unless otherwise noted.
Release Notes Update History
Revision Date Description
4.20.0 April 30, 2022 Initial release of this Release Notes version, This
version introduces Changes and New Features and
Bug Fixes.
General Information
Package Tools
The following is a list of the available tools in the package, together with a brief description of each
tool. The tools apply to single switch systems or adapter cards.
The mstflint tools do not provide cluster wide functionality.
Category Tool Description Operati
ng
System
Firmware
Update and
Configuratio
n
mstflin
t
This tool burns a firmware binary image or an expansion ROM image to the
Flash of a network adapter/switch device. It includes query functions to
the burnt firmware image and to the binary image file.
Linux
FreeBSD
mstco
nfig
Allows the user to change some of the device configurations without
having to create and burn a new firmware.
Linux
FreeBSD
mstfw
manag
er
The mstwmanager is a firmware update and query utility. It provides a
simple 'single click' firmware update functionality.
Note: The same tool with embedded firmware binaries is released
separately and is named mlxup.
Linux
FreeBSD
mstarc
hive
The mstarchive tool allows the user to create a file with the mfa2
extension. The new file contains several binary files of a given firmware
for different adapter cards.
Linux
FreeBSD
Debug and
Diagnostics
Utilities
mstreg
dump
Dumps device internal configuration data. Linux
FreeBSD
mstmc
ra
Reads/writes a single word from/to a device configuration register space Linux
FreeBSD

7
Category Tool Description Operati
ng
System
mstvp
d
Reads PCI device VPD Linux
FreeBSD
mstfwr
eset
Load Firmware after firmware update on ISFU capable devices.(5th
generation devices)
Linux
FreeBSD
mstfwt
race
Extracts and prints trace messages generated by the firmware of 5th
generation devices. This tool supports secure firmware flow only.
Linux
FreeBSD
mstreg Exposes supported access registers, and allows users to obtain information
regarding the registers fields and attributes, and to set and get data with
specific register.
Linux
FreeBSD
mstlin
k
Displays and configures port related data at the physical layer. Linux
FreeBSD
mstres
ourced
ump
Extracts and prints data segments generated by the firmware. Linux
mstres
ourcep
arse
Parses and prints data segments content. Linux
Detailed installation instructions along with complete descriptions of the various tools in the
package can be found in the Firmware Tools User Manual.
Dependencies
Flags Dependencies
Configure Flag Dependencies Additional Tools Installed
enalbe-dc zlib
enable-fw-mgr curl, zlib, lzma, boost_regex mstarchive, mstfwmanager
enable-adb-generic-tools expat, boost mstlink, mstreg
enable-xml2 libxml2, xml2
enable-inband infiniband-diags*
enable-cs Openssl >= 1.0.2K

8
mstflint Supported Operating Systems and Platforms
mstflint is supported on the following platforms:
Table Legend:
+ (Green) Supported and tested
** (Orange) Supported but not tested in MFT v4.20.0
Supported Operating Systems and Platforms
OS Platform Status
AliOS 7.2 aarch64 +
Alma 8.5 x86_64 **
Anolis 8.4 x86_64 **
BCLinux 7.5 x86_64 +
BCLinux 7.6 x86_64 +
BCLinux 8.1 x86_64 +
Centos Stream x86_64 **
Centos Stream PPC64LE **
Citrix server 8.2 x86_64 **
Cumulus 5.1 64 Bit **
Debian 10 x86_64 +
Debian 10.3 x86_64 +
Debian 10.5 x86_64 +
Debian 10.8 x86_64 **
Debian 10.9 x86_64 +
Debian 11 x86_64 **
Debian 11 ARM **
Debian 11.2 x86_64 **
Debian 11.2 ARM **
Debian 9.11 x86_64 +
Debian 9.9 x86_64 +
DVS [last_stable] 64 Bit **
EulerOSV2.0SP10 x86_64 **
EulerOSV2.0SP5 x86_64 +
EulerOSV2.0SP8 x86_64 **
EulerOSV2.0SP9 x86_64 +
Fedora 32 X86_64 +

9
OS Platform Status
Fedora 35 X86_64 **
FreeBSD 12-STABLE (12.2) x86_64 +
FreeBSD 13.0-STABLE x86_64 +
FreeBSD 14-CURRENT x86_64 +
KylinOS v10 SP2 x86_64 **
Mariner x86_64 **
MLNX-OS 64 Bit +
OEL 7.8 x86_64 +
OEL 7.9 x86_64 +
OEL 8.2 x86_64 +
OEL 8.3 x86_64 +
OpenEuler 20.3 x86_64 +
OpenEuler 20.3 SP1 x86_64 +
OpenEuler 20.3 SP3 x86_64 **
OpenSUSE 15.3 x86_64 **
Photon 3.0 x86_64 **
RHEL 7.2 x86_64 +
RHEL 7.3 x86_64 +
RHEL 7.4 x86_64 +
RHEL 7.4 PPC64 +
RHEL 7.4 PPC64LE +
RHEL 7.4 Alt ARM **
RHEL 7.5 PPC64 +
RHEL 7.5 PPC64LE (Power 9) +
RHEL 7.5 x86_64 +
RHEL 7.6 ARM +
RHEL 7.6 PPC64 +
RHEL 7.6 x86_64 +
RHEL 7.7 PPC64LE **
RHEL 7.7 x86_64 +
RHEL 7.7 PPC64 +
RHEL 7.8 x86_64 +
RHEL 7.8 PPC64 +
RHEL 7.8 PPC64LE +
RHEL 7.9 x86_64 **
RHEL 7.9 PPC64 **

10
OS Platform Status
RHEL 7.9 PPC64LE **
RHEL 8 ARM **
RHEL 8 PPC64LE **
RHEL 8 x86_64 +
RHEL 8.1 PPC64LE (Power 9) **
RHEL 8.1 x86_64 +
RHEL 8.1 ARM +
RHEL 8.2 x86_64 +
RHEL 8.2 PPC64LE +
RHEL 8.3 PPC64LE +
RHEL 8.3 x86_64 +
RHEL 8.4 x86_64 +
RHEL 8.4 PPC64LE +
RHEL 8.5 PPC64LE **
RHEL 8.5 x86_64 +
RHEL 8.6 x86_64 *
RHEL 8.6 PPC64LE **
RHEL 9.0 x86_64 **
RHEL 9.0 PPC64LE **
Rocky 8.5 x86_64 **
Sles12 SP2 PPC64LE **
Sles12 SP2 x86_64 +
Sles12 SP3 x86_64 +
Sles12 SP3 ppc64LE +
Sles12 SP4 ARM64 **
Sles12 SP4 PPC64LE **
Sles12 SP4 x86_64 +
Sles12 SP5 ARM64 **
Sles12 SP5 x86_64 +
Sles12 SP5 PPC64LE +
Sles15 SP1 PPC64LE **
Sles15 SP1 ARM64 **
Sles15 SP1 x86_64 +
Sles15 SP2 x86_64 +
Sles15 SP2 PPC64LE +
Sles15 SP3 PPC64LE +

11
OS Platform Status
Sles15 SP3 x86_64 +
Sles15 SP4 PPC64LE **
Sles15 SP4 x86_64 **
SONiC 64 Bit +
Ubuntu 14.04.06 x86_64 +
Ubuntu 16.04 x86_64 +
Ubuntu 16.04 PPC64LE +
Ubuntu 18.04 x86_64 +
Ubuntu 18.04 PPC64LE +
Ubuntu 18.04 ARM64 +
Ubuntu 20.04 PPC64LE +
Ubuntu 20.04 ARM64 +
Ubuntu 20.04 x86_64 +
Ubuntu 21.10 x86_64 +
Ubuntu 22.04 x86_64 **
UOS v20 1021e x86_64 **
UOS v20 1021e ARM **
UOS v20 1030 x86_64 +
Supported Flash Types
mstflint supports the following Flash types.
Vendor Flash Family Tested P/N
Winbond W25QxxBV W25Q32FVSSIG
W25Q32FVSSIGS
W25Q32FVSSIGT
W25Q128FVSIGS
W25Qxxx W25Q256JVBIMT
W25Q128JVSIQ
Macronicx MX25L16xxx MX25L12845GM2I-08G
MX25Lxxx MX25L25645GXDI-08G

12
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Vendor Flash Family Tested P/N
Micron N25Q0xxx MT25QL128ABA1ESE-0SIT
ISSI IS25LPxxx IS25LP128-JBLE SPA# U1323A
IS25WPxxx IS25WP256E-RHLE
Cypress S25FL256L S25FL256LDPBHV023
S25FL128SAGMFVG00
Gigadevice GD25LB256EBFRY
GD25B256DFIGR
Supported Interface Cards (NICs)
With respect to mstflint, NVIDIA IC devices are divided into two groups: Group I and Group II (4th
generation and 5th generation, respectively).The ICs are listed in the following table:
IC Group IC Device
Group II / 5th Generation Adapter Cards:
NVIDIA BlueField-2
NVIDIA BlueField
NVIDIA ConnectX-7
NVIDIA ConnectX-6 Lx
NVIDIA ConnectX-6 Dx
NVIDIA ConnectX-6
NVIDIA ConnectX-5
NVIDIA ConnectX-4 Lx
NVIDIA ConnectX-4
NVIDIA Connect-IB
Switch Systems:
NVIDIA Quantum-2
NVIDIA Quantum
NVIDIA Spectrum-2
NVIDIA Spectrum
NVIDIA Switch-IB 2
NVIDIA Switch-IB
Group I / 4th Generation Adapter Cards:
NVIDIA ConnectX-3
NVIDIA ConnectX-3 Pro
Switch Systems:
NVIDIA SwitchX-2
Supported Switch Systems Software
The following are theSupported Switch Systems Software.

13
Switch Software Version
MLNX-OS 3.9.2000 and above
SONIC
Changes and New Features
Component/ Tool Description Operating
System
Rev. 4.20.0
All Added support for NVIDIA ConnectX-7 adapter cards. All
mstflint mstflint cable/transceivers burning commands provide now
validation and extract version from the image files.
All
mtsconfig mlxconfig enables the users to apply token via MTUSB
connected device.
All
mstresourcedump Memory-Mode, data field is now transferred via memory
instead of the resource-dump register.
For further information, seemstresourcedump Utility
All
mstprivhost Added a new flag to query all hosts status from the
embedded Arm side for Multi-host systems.
For further information, seemstprivhost - NIC Configuration
by the Host Restriction Tool.
All
mstlink Added support for the PRBS test mode of Active/Optical
CMIS modules.
For further information, see the Module PRBS test mode
section.
All
mstlink Added support for additional configuration flags of the
module control parameters.
For further information, see the Module control parameters
section.
All
mstlink Modified the output of the PCIe link information, removed
the device status filed.
All
I2C Access Now the user can determine the I2C address to use for
debug tools based on DevID.
All
Flash Support Added additional Flash support for ConnectX-4 Lx and
ConnectX-5 adapter cards
All
Bug Fixes SeeBug Fixes. All

14
1.
2.
3.
4.
5.
mstflint Bug Fixes in this Version
For a list of old Bug Fixes, please see mstflint Bug Fixes History.
Internal
Ref.
Description
2834389 Description: Limited the SET operations on IB devices to registers of up to 240 bytes.
Keywords: mlxreg
Discovered in Version:4.18.0
Fixed in Release: 4.20.0
2274123 Description: mstfwreset is supported on SmartNic devices on Windows OS only if the device's
name format is "mt*_pciconf*" and not "**:**.*".
Keywords: mstfwreset
Discovered in Version:4.16.0
Fixed in Release: 4.20.0
2871042 Description: mstfwmanager default query on switches will take pci_cr0 instead of pciconf0,
which is expected to fail in secure-fw switches.
Keywords: mstfwmanager, pci_cr0, pciconf
Discovered in Version:4.18.0
Fixed in Release: 4.20.0
mstflint Known Issues
The following table provides a list of known issues and limitations of mstflint.For a list of old Known
Issues, please seeArchived Known Issuesfile.
Internal Ref.
No.
Issue
2829041 Description: Running mstlink on LID devices when the OpenSM is not enabled, can cause
the machine to hang.
Workaround: To resolve the issue, run the following:
opensm & (Press 'Enter')
mst restart;
mst ib add;
mst status;
Get the correct LID device from "InBand" devices

15
•
•
Internal Ref.
No.
Issue
Keywords: mstlink, LID, InBand, OpenSM
Discovered in Version: 4.20.0
2823492 Description:mstfwreset is not supported on DPU with GPU boards.
Workaround:N/A
Keywords:mstfwreset
Discovered in Version: 4.18.0
2715716 Description:mstfwreset is not supported on secure-boot host devices.
Workaround:N/A
Keywords:mstfwreset
Discovered in Version: 4.18.0
2752916 Description:The information of the IB/ETH protocols should not be stored on the same
CSV file. Doing so will result ina mismatch on thecolumns of CSV file.
Workaround:N/A
Keywords:mstlink
Discovered in Version: 4.18.0
2838222 Description:mlxfwreset is not supported on kernel3.10.0-1062.el7.x86_64 due to a
kernel bug that leads to 'rescan' PCI operation to take a few minutes.
Workaround:N/A
Keywords:mstfwreset
Discovered in Version: 4.18.0
2670833 Description:Burning firmware using DMA might fail on virtual FreeBSD machines.
Workaround:N/A
Keywords:Firmware burning, DMA, FreeBS, VM
Discovered in Version: 4.17.0
2484780 Description:Configuring TX/RX_rate to 200GbE in test mode fails.
Workaround:To work with the new speedsspecify the number of lanes as shown below:
100G_1X/200G_2X/400G_4X/800G_8X for NDR speeds
50G_1X/100G_2X/200G_4X/400G_4X for HDR speeds
Keywords:200GbE, Tx/Rx

16
Internal Ref.
No.
Issue
Discovered in Version: 4.17.0
2208845/2099263 Description:mstlink does not support test mode for 50GE-KR4 speed.
Workaround: N/A
Keywords:mstlink
Discovered in Version: 4.16.0
2001890 Description: The argparse module is installed by default in Python versions =>2.7 and
>=3.2. In case an older Python version is used, the argparse module is not installed by
default and therefore must be manually installed.
Workaround: N/A
Keywords: Python, argparse module
Discovered in Version:4.13.3-2
1923665 Description:Force Mode does not work when usingmstlinkin ConnectX-6 InfiniBand
adapter cards.
Workaround:N/A
Keywords:mstlink, Force Mode, ConnectX-6 IB
Discovered in Version:4.13.3-2
1431471 Description: In ConnectX-5 adapter cards, the time-stamp capability using mstflint, is
supported only on the device using the "-d" flag, and not on the binary using the "-i" flag.
Workaround: Use the “-d” flag to set the time-stamp.
Keywords: mstflint
Discovered in Version: 4.11.0
1442454 Description: Occasionally, when running mstfwreset over a Multi-Host device, the driver
remains down if the mstfwreset operation fails.
Workaround: N/A
Keywords: mstfwreset
Discovered in Version: 4.11.0

17
•
•
•
Introduction
The mstflint package is a set of firmware management and debug tools for NVIDIA®devices. mstflint
can be used for:
Generating a standard or customized NVIDIA firmware image
Querying for firmware information
Burning a firmware image to a single NVIDIA device
The list of the available tools in the package can be found in the .Release Notes v4.18.1 document.
Supported Operating Systems
Please refer to the release notes of your version for supported platforms and kernels.
Access to Hardware Devices
The table below lists the NVIDIA®devices supported by mstflint, the supporting tools, and the
access methods to these devices.
Device Type Product Name HW Access Method
PCI I2C In-Band
HCA (InfiniBand) NVIDIA Connect-IB V V V
VPI Network Adapter NVIDIA ConnectX®-3 V V V
NVIDIA ConnectX-3 Pro V V V
NVIDIA ConnectX-4 V V V
NVIDIA ConnectX-5 V V V
NVIDIA ConnectX-5 Ex V V V
NVIDIA ConnectX-6 V V V
Ethernet Adapter (NIC) NVIDIA ConnectX-3 EN V V
NVIDIA ConnectX-4 Lx V V
NVIDIA ConnectX-6 Dx V V
NVIDIA ConnectX-6 Lx V V
Switch NVIDIA SwitchX®-2 V2V V
NVIDIA Switch-IB®V1V V
NVIDIA Switch-IB2 V1V V

18
•
•
•
1.
2.
Device Type Product Name HW Access Method
PCI I2C In-Band
NVIDIA Spectrum™ V V
NVIDIA Spectrum-2 V V
NVIDIA Spectrum-3 V V
NVIDIA Quantum V V V
Note.V1 indicates managed switch products only.V2In-band capability is only available for mstflint
if mstflint is compiled with MLNX_OFED driver.mstflint tools access NVIDIA devices via the PCI
Express interface, via a USB to I2C adapter (P/N: MTUSB-1), or via vendor-specific MADs over the
InfiniBand fabric (In-Band).
All mstflint tools address the target hardware device using a PCI device. To list all available PCI
devices, use the “lspci” command.
To see the NVIDIA PCI devices, run “lspci | grep –I “Mellanox””.
Ex:
# lspci | grep -i "Mellanox"
15:00.0 Infiniband controller: Mellanox Technologies MT27700 Family [ConnectX-4]
1a:00.0 Ethernet controller: Mellanox Technologies MT27710 Family [ConnectX-4Lx]
1a:00.1 Ethernet controller: Mellanox Technologies MT27710 Family [ConnectX-4Lx]
Local PCI devices may also be accessed using device aliases. Supported aliases are:
PCI device “bus:dev.fn” (e.g. 03:00.0 (BDF format))
OFED RDMA device (e.g. mlx4_0)
Network interface with “net-” prefix, (e.g. net-eth2”)
Compilation and Installation
Compile mstflint.
./autogen.sh
./configure [OPTION]... [VAR=VALUE]...
make -j <N>
To check all the possible values of [OPTION]... [VAR=VALUE]..., run “./configure --help”.
Note: If using FreeBSD OS, use the "gmake" command instead of "make".
Install mstflint.
make install
In-Band device access requires the local IB port to be in the ACTIVE state and connected to
an IB fabric.


19
•
•
•
•
•
•
•
•
Firmware Generation, Configuration, and Update
Tools
This chapter contains the following sections:
mstfwmanager – Firmware Update and Query Tool
mstarchive – Binary Files Compression Tool
mstconfig – Changing Device Configuration Tool
mstflint – Firmware Burning Tool
mstfwreset – Loading Firmware on 5th Generation Devices Tool
mstcongestion – Tool for Setting Congestion Mode and Action
mstprivhost - NIC Configuration by the Host Restriction Tool
Disabling/Enabling Access to the Hardware
mstfwmanager – Firmware Update and Query Tool
The mstfwmanager is a firmware update and query utility which scans the system for available
NVIDIA devices (only mst PCI devices) and performs the necessary firmware updates.
For further information on firmware update, please refer toBooting HCA Devicein Livefish Mode.
mstfwmanager Synopsis
# [-d|--dev DeviceName] [-h|--help] [-v|--version] [--query] [--query-format Format] [-u|--update] [-i|--image-file
FileName] [-D|--image-dir DirectoryName] [-f|--force] [-y|--yes] [--no] [--clear-semaphore] [--exe-rel-path] [-l|--
list-content] [--archive-names] [--nofs] [--log] [-L|--log-file LogFileName] [--no-progress] [-o|--outfile
OutputFileName] [--online] [--online query-psid PSIDs] [--key key] [--download DirectoryName] [--download-default]
[--get-downloadopt OPT] [--download-device Device] [--download-os OS] [--download-type Type] [--ssl-certificate
Certificate] [--no_fw_ctrl]
where:
-d|--dev DeviceName Perform operation for specified mst device(s). Multiple devices can be
specified delimited by semicolons. A device list containing semicolons must
be quoted.
-h|--help  Show this message and exit.
-v|--version Show the executable version and exit.
--query  Query device(s) info
--query-format Format (Query|Onlinequery)outputformat,XML|Text-defaultText
-u|--update Update firmware image(s) on the device(s).
-i|--image-file FileName Specified image file to use.
-D|--image-dir DirectoryName Specified directory instead of default to locate image files.
-f|--force Force image update
-y|--yes Answer is yes in prompts
--no Answer is no in prompts
--clear-semaphore Force clear the flash semaphore on the device, No command isallowed when
this flag is used. NOTE: May result in system instability or flash corruption if
The examples throughout the document use pci “bus.dev.fn” format.


20
the device or another application is currently using the flash. Exercise
caution.
--exe-rel-path Use paths relative to the location of the executable
-l|--list-content List file/Directory content, used with --image-dir and --image-file flags
--archive-names   Display archive names in listing
--nofs Burn image in a non failsafe manner
--log Create log file
-L|--log-file LogFileName Use specified log file
--no_fw_ctrl  Do not use firmware Ctrl update
--no-progress Do not show progress
-o|--outfile OutputFileName Write to specified output file
--online  Fetch required FW images online from NVIDIA server
--online-query-psid PSIDs Query FW info, PSID(s) are comma separated
--key key Key for custom download/update
--download DirectoryName Download files from server to a specified directory
--download-default Use Default values for download
--get-download-opt OPT  Get download options for OS or Device Options are: OS, Device
--download-device Device   Use '--get-download-opt Device' option to view available devices fordevice
specific downloads
--download-os OS Only for self_extractor download: Use '--get-download-opt OS' option to view
available OS for sfx download
--download-type Type MFA | self_extractor - default All
--ssl-certificate Certificate SSL certificate for secure connection
Querying the Device
To query a specific device, use the following command line:
# mstfwmanager -d <device> --query
To query all the devices on the machine, use the following command line:
# mstfwmanager --query
Examples:
Query the device.
mstfwmanager -d 09:00.0 --query
Querying Mellanox devices firmware ...

Device #1:
----------
Device Type: ConnectX3
Part Number: MCX354A-FCA_A2-A4
Description: ConnectX-3VPI adapter card; dual-port QSFP; FDR IB (56Gb/s) and 40GigE; PCIe3.0x8 8GT/s; RoHS R6
PSID: MT_1020120019