.\" .\" *********************************************************************

.\" .\" *                                                                   *

.\" .\" *             Copyright 2015-2019, Intel Corporation                *

.\" .\" *                                                                   *

.\" .\" *                       All Rights Reserved.                        *

.\" .\" *                                                                   *

.\" .\" *********************************************************************

.TH opainfo 1 "Intel Corporation" "Copyright(C) 2015\-2019" "IFSFFCLIRG (Man Page)"

.SH NAME

opainfo

.PP

Provides summary information for local HFI port(s).

.SH Syntax

opainfo [-h  \fIhfi\fR] [-p  \fIport\fR] [-o  \fItype\fR] [-g] [-d  \fIdetail\fR]

[-s pm\(ulsl]

.br

[-v [-v]...]

.SH Options

.TP 10

--help

Produces full help text.

.TP 10

-h \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 \fIport\fR

Specifies the port, numbered 1 to n. Using 0 specifies the first active port across all HFIs/ports. Default is 1 which indicates all ports. If selected, the tool returns information on all available ports if p is not defined.

.TP 10

-o \fItype\fR

Specifies the output type and can appear more than once.

.TP 10

.BR

.PP

.B NOTE:

Behavior without -o gives a brief summary of portinfo, counters and cableinfo.

.RS

.TP 10

.sp

info

Outputs detailed portinfo.

.RE

.RS

.TP 10

.sp

stats

Outputs detailed port counters.

.RE

.TP 10

-g

Output is displayed in line-by-line format. Default is summary format.

.TP 10

-d \fIdetail\fR

Output detail level. Range is 0 - 2. CableInfo only. Default is 0.

.TP 10

.BR

.PP

.B NOTE:

-d option is ignored when used with -o type.

.RS

.TP 10

.sp

0

Minimal crucial information (for example, cable length, vendor)

.RE

.RS

.TP 10

.sp

1

Brief summary

.RE

.RS

.TP 10

.sp

2

Extended brief summary

.RE

.TP 10

-s \fIpm\(ulsl\fR

Specifies different Service Level for PMA traffic.

.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 Debug Options

.TP 10

-v

Specifies the verbose output. Additional invocations (-v -v ...) turn on debugging, openib debugging, and libibumad debugging.

.SH Examples

opainfo

.br

  hfi1\(ul0:1 PortGID:0xfe80000000000000:001175010165b19c

.br

  PortState:     Active

.br

  LinkSpeed Act: 25Gb En: 25Gb

.br

  LinkWidth Act: 4 En: 4

.br

  LinkWidthDnGrd ActTx: 4 Rx: 4 En: 3,4

.br

  LCRC Act: 14-bit En: 14-bit,16-bit,48-bit Mgmt: True

.br

  LID: 0x00000001-0x00000001 SM LID: 0x00000002 SL: 0

.br

  QSFP: PassiveCu, 1m FCI Electronics P/N 10131941-2010LF Rev 5

.br

  Xmit Data:           22581581 MB Pkts:           5100825193

.br

  Recv Data:           18725619 MB Pkts:           4024569756

.br

  Link Quality: 5 (Excellent)