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

.\" .\" *                                                                   *

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

.\" .\" *                                                                   *

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

.\" .\" *                                                                   *

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

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

.SH NAME

opagetvf

.PP

Used for scripting application use of vFabrics, such as for mpirun parameters. You can query by VF Name, VF Index, Service ID, MGID, PKey, or SL. Fetches the Virtual Fabric info in a delimited format. Returns exactly one matching VF. When multiple VFs match the query, it prefers non-default VFs in which the calling server is a full member. If multiple choices remain, it returns the one with the lowest VF Index. Uses the same algorithm as the Distributed SA Plug-in (DSAP).

.PP

The tool can be used with additional scripts to help set PKey, SL, MTU, and Rate when running MPI jobs. Internally, this tool is based on the opasaquery -o vfinfocsv command. For more information, see

\fIopasaquery\fR

.

.SH Syntax

opagetvf [-h  \fIhfi\fR] [-p  \fIport\fR] [-e] [-d  \fIvfname\fR | -S  \fIserviceId\fR | -m  \fImcgid\fR |

.br

-i  \fIvfIndex\fR | -k  \fIpkey\fR | -L  \fIsl\fR]

.SH Options

.TP 10

--help

Produces full help text.

.TP 10

-h \fIhfi\fR

Specifies the HFI to send by. Default is first HFI.

.TP 10

-p \fIport\fR

Specifies the port to send by. Default is first active port.

.TP 10

-e

Outputs MTU and rate as enum values.

.TP 10

-d \fIvfname\fR

Queries by VirtualFabric Name.

.TP 10

-S \fIserviceId\fR

Queries by Application ServiceId.

.TP 10

-m \fIgid\fR

Queries by Application Multicast GID.

.TP 10

-i \fIvfindex\fR

Queries by VirtualFabric Index.

.TP 10

-k \fIpkey\fR

Queries by VirtualFabric PKey.

.TP 10

-L \fISL\fR

Queries by VirtualFabric SL.

.SH Examples

opagetvf -d \[aq]Compute\[aq]

.br

opagetvf -h 2 -p 2 -d \[aq]Compute\[aq]

.SH Sample Outputs

.PP

The output is of the form: name:index:pkey:sl:mtu:rate:optionflag::mcastSl as shown in the following example.

.PP

Option flag (bitmask) values include:

.IP \(bu

0x00 Indicates no bits are set. Specifically, no QoS, no Security, and no flow control disabled (which means flow control is enabled).

.IP \(bu

0x01 Security

.IP \(bu

0x02 QoS

.IP \(bu

0x04 Flow Control Disable

.PP

.br

# opagetvf -d Default

.br

Default:0:0xffff:0:unlimited:unlimited:0x0::

.br