Networking NVIDIA Firmware Tools (MFT) Documentation

nvltssm Utility

The nvltssm tool is an LTSSM logger, specifically intended to show the LTSSM (Link Training and Status State Machine) log of a PCIe link. It works offline, on an mstdump output of the device, so it needs no access to the device. It is available on Linux, for NVIDIA ConnectX-8, ConnectX-9 and Vera devices.

A Vera mstdump output carries no device ID, so decoding it requires --device-type Vera. --port and --lport follow the ConnectX link numbering; on Vera, name the link with --pcore and --link.

nvltssm Usage

nvltssm --dump DUMP_FILE
        [--lport LPORT] [--device-type NAME]
        [-f FORMATTER] [-o OUT] [--version] [-h]

where:

--dump

Location of the mstdump output to decode

--lport

Local port of the PCIe link, as "mstlink --port_type PCIE --show_links" lists it

--device-type

Device the dump was taken from, e.g. "Vera", taken instead of reading the device ID out of the dump. Needed for a device whose dump carries no device ID

-f, --formatter

The output format: "report" for a column-aligned history table, oldest transition first, "legacy" for the text of the reference ltssm_tracer.py tool (default: report)

-o, --out

Location of the output file

--version

Shows the tool's version and exit

-h, --help

Show help message and exit

Examples:

  • Take an mstdump output of the device, then decode the LTSSM history of pcore 0, link 0:

    # mstdump /dev/mst/mt4131_pciconf0 > mt4131_pciconf0.dump
    # nvltssm --dump mt4131_pciconf0.dump
    LTSSM history of pcore 0, link 0
    Dump: mt4131_pciconf0.dump (ConnectX8)
    Ring: 128 slots, oldest first, next write slot 76, tick 1024 ns
    
    Slot  Speed Width State                                  Exit reason           Dwell
    ----  ----- ----- -------------------------------------- --------------------- ------------
          -- Perst deasserted --
       0  Gen0  x1    0xfe LTSSM_FW_EVENT_PERST_DEASSERTED   Framing Error         33.55 ms or more
       1  Gen1  x16   0x00 DETECT_RESET                      Framing Error         33.55 ms or more
    …
      75  Gen3  x16   0x1a RECOVERY_IDLE                     EIEOS                 0.00 ms
     CUR  Gen3  x16   0x1b L0                                -                     -
    
  • Decode the history of another link, named by its port number:

    # nvltssm --dump mt4131_pciconf0.dump --port 21
    
  • Decode a Vera mstdump output:

    # nvltssm --dump vera.dump --device-type Vera --pcore 0 --link 3
    
  • Write the legacy format to a file:

    # nvltssm --dump mt4131_pciconf0.dump -f legacy -o ltssm_legacy.txt
    

Last updated: