.\" .\" *********************************************************************
.\" .\" * *
.\" .\" * Copyright 2015-2019, Intel Corporation *
.\" .\" * *
.\" .\" * All Rights Reserved. *
.\" .\" * *
.\" .\" *********************************************************************
.TH opapmaquery 1 "Intel Corporation" "Copyright(C) 2015\-2019" "IFSFFCLIRG (Man Page)"
.SH NAME
opapmaquery
.PP
\fB(All)\fR
Performs individual PMA queries against a specific LID. It is very useful in displaying port runtime information.
.SH Syntax
opapmaquery [-v] [-s \fIsl\fR] [-l \fIlid\fR] [-h \fIhfi\fR] [-p \fIport\fR] [-o \fIotype\fR]
.br
[-m \fIport\fR]
[-n \fImask\fR] [-e \fImask\fR] [-w \fImask\fR]
.SH Options
.TP 10
--help
Produces full help text.
.TP 10
-v
Specifies the verbose output. Can be specified more than once for additional openib debugging and libibumad debugging.
.TP 10
-s \fIsl\fR
Specifies different service level. Default is SM SL.
.TP 10
-l \fIlid\fR
Specifies the destination LID. Default is local port.
.TP 10
-h/--hfi \fIhfi\fR
Specifies the HFI, numbered 1..n. Using 0 specifies that the -p \fIport\fR port is a system-wide port number. Default is 0.
.TP 10
-p/--port \fIport\fR
Specifies the port, numbered 1..n. Using 0 specifies the first active port. Default is 0.
.TP 10
-o \fIotype\fR
Specifies the output type. Default is getportstatus. Refer to
\fIotype options vary by report\fR
for supported options.
.IP
Valid output types are:
.RS
.TP 10
.sp
classportinfo
Specifies the class of port info.
.RE
.RS
.TP 10
.sp
getportstatus
Specifies the list of port counters. Supported options:
.IP
.br
[-m port] [-w vl mask]
.br
.RE
.RS
.TP 10
.sp
clearportstatus
Clears the port counters. Supported options:
.IP
.br
[-n port mask] [-e counter mask] [-w vl mask]
.br
.RE
.RS
.TP 10
.sp
getdatacounters
Specifies the list of data counters. Supported options:
.IP
.br
[-n port mask] [-w vl mask]
.br
.RE
.RS
.TP 10
.sp
geterrorcounters
Specifies the list of error counters. Supported options:
.IP
.br
[-n port mask] [-w vl mask]
.br
.RE
.RS
.TP 10
.sp
geterrorinfo
Specifies the list of error info. Supported options:
.IP
.br
[-n port mask]
.br
.RE
.RS
.TP 10
.sp
clearerrorinfo
Clears the error info. Supported options:
.IP
.br
[-n port mask] [-e counter mask]
.br
.RE
.SH -h and -p options permit a variety of selections:
.TP 10
-h 0
First active port in system (Default).
.TP 10
-h 0 -p 0
First active port in system.
.TP 10
-h \fIx\fR
First active port on HFI \fIx\fR.
.TP 10
-h \fIx\fR \fI\fR-p 0
First active port on HFI \fIx\fR.
.TP 10
-h 0 -p \fIy\fR
Port \fIy\fR within system (no matter which ports are active).
.TP 10
-h \fIx\fR \fI\fR-p \fIy\fR
HFI \fIx\fR, port \fIy\fR.
.SH \fIotype\fR options vary by report
.TP 10
-m \fIport\fR
Specifies the port in destination device to query/clear. Required when using -l option for all but -o classportinfo.
.TP 10
-n \fImask\fR
Specifies the port mask, in hexadecimal. Bits represent ports 63-0. For example: 0x2 for port 1, 0x6 for ports 1, 2.
.TP 10
-e \fImask\fR
Specifies the counter/error select mask, in hexadecimal. The following lists "Mask - Bit - Location for Counters". Where applicable, location "for Error Info" is presented. Default is all bits set (0xffffffe0).
.RS
.IP \(bu
0x80000000 - 31 - Transmit Data (XmitData)
For Error Info: Receive Error Info
.IP \(bu
0x40000000 - 30 - Receive Data (RcvData)
For Error Info: Excessive Buffer Overrun
.IP \(bu
0x20000000 - 29 - Transmit Packets (XmitPkts)
For Error Info: Transmit Const Error Info
.IP \(bu
0x10000000 - 28 - Receive Packets (RcvPkts)
For Error Info: Receive Const Error Info
.IP \(bu
0x08000000 - 27 - Multicast Transmit Packets (MulticastXmitPkts)
For Error Info: Receive Switch Relay Error Info
.IP \(bu
0x04000000 - 26 - Multicast Receive Packets (MulticastRcvPkts)
For Error Info: Uncorrectable Error Info
.IP \(bu
0x02000000 - 25 - Transmit Wait (XmitWait)
For Error Info: FM Configuration Error Info
.IP \(bu
0x01000000 - 24 - Congestion Discards (CongDiscards)
.IP \(bu
0x00800000 - 23 - Receive FECN (RcvFECN)
.IP \(bu
0x00400000 - 22 - Receive BECN (RcvBECN)
.IP \(bu
0x00200000 - 21 - Transmit Time Congestion (XmitTimeCong)
.IP \(bu
0x00100000 - 20 - Transmit Time Wasted BW (XmitWastedBW)
.IP \(bu
0x00080000 - 19 - Transmit Time Wait Data (XmitWaitData)
.IP \(bu
0x00040000 - 18 - Receive Bubble (RcvBubble)
.IP \(bu
0x00020000 - 17 - Mark FECN (MarkFECN)
.IP \(bu
0x00010000 - 16 - Receive Constraint Errors (RcvConstraintErrors)
.IP \(bu
0x00008000 - 15 - Receive Switch Relay (RcvSwitchRelayErrors)
.IP \(bu
0x00004000 - 14 - Transmit Discards (XmitDiscards)
.IP \(bu
0x00002000 - 13 - Transmit Constraint Errors (XmitConstraintErrors)
.IP \(bu
0x00001000 - 12 - Receive Remote Physical Errors (RcvRemotePhysicalErrors)
.IP \(bu
0x00000800 - 11 - Local Link Integrity (LocalLinkIntegrityErrors)
.IP \(bu
0x00000400 - 10 - Receive Errors (RcvErrors)
.IP \(bu
0x00000200 - 9 - Excessive Buffer Overrun (ExcessiveBufferOverruns)
.IP \(bu
0x00000100 - 8 - FM Configuration Errors (FMConfigErrors)
.IP \(bu
0x00000080 - 7 - Link Error Recovery (LinkErrorRecovery)
.IP \(bu
0x00000040 - 6 - Link Error Downed (LinkDowned)
.IP \(bu
0x00000020 - 5 - Uncorrectable Errors (UncorrectableErrors)
.RE
.TP 10
-w \fImask\fR
Specifies the 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.
.SH Examples
opapmaquery -o classportinfo
.br
.br
opapmaquery -o getportstatus
.br
# get data and error counts, local port
.br
.br
opapmaquery -o getdatacounters -n 0x2
.br
# get data counts, local port 1
.br
.br
opapmaquery -o geterrorcounters -n 0x2
.br
# get error counts, local port 1
.br
.br
opapmaquery -o clearportstatus -n 0x2
.br
# clear all counters local port 1
.br
.br
opapmaquery -o geterrorinfo -n 0x2
.br
# get error info for local port 1
.br
.br
opapmaquery -o clearerrorinfo -n 0x2
.br
# clear all error info, local port 1
.br
opapmaquery -o getdatacounters -l 6 -n 0x7e -w 0x1
.br
# for device at LID 6, get data counters on ports 1-6, inclusive of VL 0 data
.br
.br
opapmaquery -o clearportstatus -l 6 -n 0x2 -e 0x1ffff
.br
# for device at LID 6, on port 1, clear only error counters
.br
.br
opapmaquery -o clearerrorinfo -l 6 -n 0x2 -e 0x04000000
.br
# for device at LID 6, on ports 1, clear uncorrectable error info