Go to main content

man pages section 1M: System Administration Commands

Exit Print View

Updated: July 2017
 
 

mstdump (1M)

Name

mstdump - dumps Mellanox ConnectX family Host Channel Adapter (HCA) device internal configuration registers

Synopsis

mstdump [-full] <device> [-v[ersion]] [-h[elp]]

Description

The mstdump utility dumps Mellanox HCA device internal configuration registers in STDOUT. This tool is used to collect special internal register information for hardware troubleshooting purposes. Only users with the root privileges are allowed to execute this command. It only works on these supported devices: ConnectX, ConnectX-2, and ConnectX-3.

<device> is the device path name to the :devctl minor node of the HCA device. It can be obtained from fwflash command output for the HCA.

Options

The following options are supported:

–full

dumps out all the internal registers

–h[elp]

show the usage message.

–v[ersion]

show the version info.

Examples

Example 1 Usage of mstdump command
root@myhost:$ /usr/sbin/mstdump unsupport_device
Unable to open device unsupport_device. Exiting.

root@myhost:$ /usr/sbin/fwflash -l -c IB
List of available devices:
Device[0] /devices/pci@0,0/pci10de,377@f/pci15b3,90@0:devctl
Driver mcxnex
class [IB]
   GUID: System Image - 0010e0000143bf93
         Node Image   - 0010e0000143bf90
         Port 1       - 0010e0000143bf91
         Port 2       - 0010e0000143bf92
         Mac 1        - 00000010e043bf91
         Mac 2        - 00000010e043bf92
   Firmware revision  : 2.11.1280
   Product            : Part number could not be read
   PSID               : ORC1090120019
   Description        : ORACLE DUAL PORT QDR INFINIBAND ADAPTER M3

root@myhost:$ /usr/sbin/mstdump /devices/pci@0,0/pci10de,377@f
/pci15b3,90@0:devctl > /usr/tmp/hca-dump.txt

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/io/infiniband/mlnx-tools
Stability
Volatile