(All) Performs individual PMA queries against a specific LID. It is very useful in displaying port runtime information.
opapmaquery [-v] [-s sl] [-l lid] [-h hfi] [-p port] [-o otype] [-m port] [-n mask] [-e mask] [-w mask]
Verbose output. Can be specified more than once for additional openib debugging and libibumad debugging.
Specifies different service level. Default is 0.
Destination LID. Default is local port.
HFI, numbered 1..n. Using 0 specifies that the -p port port is a system-wide port number. Default is 0.
Port, numbered 1..n. If -h hfi is 0, then port is a system-wide port number. Default is first active port.
Output type. Default is getportstatus.
Valid output types are:
List of port info records.
List of port status records.
[-m port] [-w vl mask]
Clears the port status.
[-n port mask] [-e counter mask] [-w vl mask]
List of data counters.
[-n port mask] [-w vl mask]
List of error counters.
[-n port mask] [-w vl mask]
List of error info.
[-n port mask]
Clears the error info.
[-n port mask] [-e counter mask]
First active port in system (default).
First active port in system.
First active port on HFI x.
First active port on HFI x.
Port y within system (no matter which ports are active).
HFI x, port y.
Port in destination device to query/clear. Required when using -l option for all but -o classportinfo.
Port mask, in hexadecimal. Bits represent ports 63-0. For example: 0x2 for port 1, 0x6 for ports 1, 2.
Counter/error select mask, in hexadecimal. Bit positions are in the following list. Default is all bits set (0xffffffe0).
For Counters: Xmit Data
For Error Info: Rcv Error Info
For Counters: Rcv Data
For Error Info: Excessive Buffer Overrun
For Counters: Xmit Pkts
For Error Info: Xmit Const Error Info
For Counters: Rcv Pkts
For Error Info: Rcv Const Error Info
For Counters: Multicast Xmit Pkts
For Error Info: Rcv Switch Relay Error Info
For Counters: Multicast Rcv Pkts
For Error Info: Uncorrectable Error Info
For Counters: Xmit Wait
For Error Info: FM Config Error Info
For Counters: Congestion Discards
For Counters: Rcv FECN
For Counters: Rcv BECN
For Counters: Xmit Time Cong.
For Counters: Xmit Time Wasted BW
For Counters: Xmit Time Wait Data
For Counters: Rcv Bubble
For Counters: Mark FECN
For Counters: Rcv Constraint Errors
For Counters: Rcv Switch Relay
For Counters: Xmit Discards
For Counters: Xmt Constraint Errors
For Counters: Rcv Rmt Phys. Errors
For Counters: Local Link Integrity
For Counters: Rcv Errors
For Counters: Exc. Buffer Overrun
For Counters: FM Config Errors
For Counters: Link Error Recovery
For Counters: Link Error Downed
For Counters: Uncorrectable Errors
Virtual Lane Select Mask, in hexadecimal. Bits represent VL number 31-0. For example, 0x1 for VL 0, 0x3 for VL 0,1. Default is none.
opapmaquery -o classportinfo # get PMA classportinfo opapmaquery -o getportstatus # get data and error counts, local port opapmaquery -o getdatacounters -n 0x2 # get data counts, local port 1 opapmaquery -o geterrorcounters -n 0x2 # get error counts, local port 1 opapmaquery -o clearportstatus -n 0x2 # clear all counters local port 1 opapmaquery -o geterrorinfo -n 0x2 # get error info for local port 1 opapmaquery -o clearerrorinfo -n 0x2 # clear all error info, local port 1
Additional Examples
For device at LID 6, get data counters on ports 1-6, inclusive of VL 0 data:
opapmaquery -o getdatacounters -l 6 -n 0x7e -w 0x1
For device at LID 6, on port 1, clear only error counters:
opapmaquery -o clearportstatus -l 6 -n 0x2 -e 0x1ffff
For device at LID 6, on ports 1, clear uncorrectable error info:
opapmaquery -o clearerrorinfo -l 6 -n 0x2 -e 0x04000000