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

.\" .\" *                                                                   *

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

.\" .\" *                                                                   *

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

.\" .\" *                                                                   *

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

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

.SH NAME

opaportinfo

.PP

\fB(Host or Switch)\fR

Displays configuration and state of a specified Intel(R) Omni-Path Host Fabric Interface (HFI) port on the local host or a remote switch.

.SH Syntax

opaportinfo [-l  \fIlid\fR  [-m  \fIdest\(ulport\fR]] [-h  \fIhfi\fR] [-p  \fIport\fR] [-v]

.SH Options

.TP 10

-l \fIlid\fR

Specifies the destination LID. Default is local port.

.TP 10

-m \fIdest\(ulport\fR

Specifies the destination port. Default is port with given LID. Useful to access switch ports.

.TP 10

-h \fIhfi\fR

Specifies the HFI to send through/to. Default is first HFI.

.TP 10

-p \fIport\fR

Specifies the port to send through/to. Default is first port.

.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

opaportinfo -p 1

.br

opaportinfo -p 2 -h 2 -l 5 -m 18

.SH Description

.PP

To access switch ports using this command, the -l and -m options must be given. The -l option specifies the LID of switch port 0 (the logical management port for the switch) and -m specifies the actual switch port to access.