.\" .\" *********************************************************************
.\" .\" * *
.\" .\" * 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.