1
2opagetvf(1)            Master map: IFSFFCLIRG (Man Page)           opagetvf(1)
3
4
5

NAME

7       opagetvf
8
9
10
11       Used  for  scripting  application  use  of vFabrics, such as for mpirun
12       parameters. You can query by VF Name, VF Index, Service ID, MGID, PKey,
13       or  SL.  Fetches the Virtual Fabric info in a delimited format. Returns
14       exactly one matching VF. When multiple VFs match the query, it  prefers
15       non-default VFs in which the calling server is a full member. If multi‐
16       ple choices remain, it returns the one with the lowest VF  Index.  Uses
17       the same algorithm as the Distributed SA Plug-in (DSAP).
18
19       The tool can be used with additional scripts to help set PKey, SL, MTU,
20       and Rate when running MPI jobs. Internally, this tool is based  on  the
21       opasaquery -o vfinfocsv command. For more information, see opasaquery
22

Syntax

24       opagetvf [-h hfi] [-p port] [-e] [-d vfname| -S serviceId| -m mcgid|
25       -i vfIndex| -k pkey| -L sl]
26

Options

28       --help    Produces full help text.
29
30       -h hfi    Specifies the HFI to send by. Default is first HFI.
31
32       -p port   Specifies the port to send by. Default is first active port.
33
34       -e        Outputs MTU and rate as enum values.
35
36       -d vfname Queries by VirtualFabric Name.
37
38       -S serviceId
39                 Queries by Application ServiceId.
40
41       -m gid    Queries by Application Multicast GID.
42
43       -i vfindex
44                 Queries by VirtualFabric Index.
45
46       -k pkey   Queries by VirtualFabric PKey.
47
48       -L SL     Queries by VirtualFabric SL.
49

Examples

51       opagetvf -d 'Compute'
52       opagetvf -h 2 -p 2 -d 'Compute'
53

Sample Outputs

55       The   output   is   of  the  form:  name:index:pkey:sl:mtu:rate:option‐
56       flag::mcastSl as shown in the following example.
57
58       Option flag (bitmask) values include:
59
60       ·      0x00 Indicates no bits are set. Specifically, no QoS,  no  Secu‐
61              rity,  and no flow control disabled (which means flow control is
62              enabled).
63
64       ·      0x01 Security
65
66       ·      0x02 QoS
67
68       ·      0x04 Flow Control Disable
69
70       # opagetvf -d Default
71       Default:0:0xffff:0:unlimited:unlimited:0x0::
72
73
74
75
76Copyright(C) 2015-2018         Intel Corporation                   opagetvf(1)
Impressum