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: