opagetvf(1)

🌸 opagetvf — the vFabric tea-spiller (from the IFSFFCLIRG man pages, bestie) 🌸

💖 NAME 💖

opagetvf — ok so this is your little scripting bestie for using vFabrics from applications, like when you need mpirun parameters and you're just like "give me the deets pls".

You can query by VF Name, VF Index, Service ID, MGID, PKey, or SL. It fetches the Virtual Fabric info in a delimited format. It returns exactly one matching VF — no chaos, one VF only, periodt.

When multiple VFs match your query, it prefers non-default VFs in which the calling server is a full member. And if multiple choices are still standing after that? It hands you the one with the lowest VF Index. It uses the same algorithm as the Distributed SA Plug-in (DSAP) — so it's not doing its own lil thing, it's matching that vibe exactly.

This tool can also 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 info, go see opasaquery. 🫶

✨ Syntax ✨

opagetvf [-h  hfi] [-p  port] [-e] [-d  vfname | -S  serviceId | -m  mcgid |

-i  vfIndex | -k  pkey | -L  sl]

🎀 Options 🎀

• --help — produces the full help text. Your "wait what does this do again" button. 💅
• -h hfi — specifies the HFI to send by. Default is the first HFI.
• -p port — specifies the port to send by. Default is the first active port.
• -e — outputs MTU and rate as enum values. Not the cute human-readable ones, the enum ones. ⭐
• -d vfname — queries by VirtualFabric Name.
• -S serviceId — queries by Application ServiceId.
• -m gid — queries by Application Multicast GID.
• -i vfindex — queries by VirtualFabric Index.
• -k pkey — queries by VirtualFabric PKey.
• -L SL — queries by VirtualFabric SL.

🌈 Examples 🌈

opagetvf -d 'Compute'

opagetvf -h 2 -p 2 -d 'Compute'

🦋 Sample Outputs 🦋

The output is of the form:

name:index:pkey:sl:mtu:rate:optionflag::mcastSl

...as shown in the following example. 👑

Option flag (bitmask) values include:

• 0x00 — indicates no bits are set. Specifically: no QoS, no Security, and no flow control disabled (which means flow control is enabled). Lowkey the chill one. 🍓
• 0x01 — Security
• 0x02 — QoS
• 0x04 — Flow Control Disable

# opagetvf -d Default

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

🫶 That's the whole page bestie, every flag accounted for, no cap.

Copyright(C) 2015-2019 — Intel Corporation. Sending you off with all the love, this was opagetvf(1) from the IFSFFCLIRG man pages. Slay, and happy scripting. 💜✨