Provides
opagetvf_func and
opagetvf2_func shell functions that query the
parameters of a vFabric. Also exports values that indicate the PKEY, SL, MTU,
and RATE associated with the vFabric. The typical usage of this tool is to
include it in a shell script as:
. /usr/sbin/opagetvf_env
A usage example is provided in:
/usr/src/opa/mpi_apps/openmpi.params
Note:
opagetvf_func and
opagetvf2_func have a similar usage. The difference is
whether the MTU and RATE are returned as absolute values or enum values,
respectively.
Function Syntax
opagetvf_func "arguments to opagetvf" pkey_env_var_name sl_env_var_name
[mtu_env_var_name [rate_env_var_name]]
or
opagetvf2_func "arguments to opagetvf" pkey_env_var_name
sl_env_var_name [mtu_env_var_name [rate_env_var_name]]
Function Options
- "arguments to opagetvf"
- Specifies a set of arguments to pass to
opagetvf to select a virtual fabric.
See
opagetvf
for more information.
- pkey_env_var_name
- Specifies the environment variable to fill in with pkey for the
selected virtual fabric. The variable given will be exported with the hex
numeric value for the pkey.
If a variable name of "" is provided, pkey is not saved.
- sl_env_var_name
- Specifies the environment variable to fill in with service level
(sl) for the selected virtual fabric. The variable given will be exported with
the numeric value for the sl.
If a variable name of "" is provided, sl is not saved.
- mtu_env_var_name
- Specifies the environment variable to fill in with maximum MTU
for the selected virtual fabric. The variable given will be exported with the
value for the MTU.
If a variable name of "" is provided, MTU is not saved.
For
opagetvf_func, MTU is returned as an absolute
value of 2048, 4096, 8192, or 10240.
For
opagetvf2_func, MTU is returned as an enumerated
value of 4, 5, 6, or 7 corresponding to the absolute values above,
respectively.
If the selected virtual fabric does not have a limitation
specified for MTU, the variable will be unaltered.
- rate_env_var_name
- Specifies the environment variable to fill in with maximum static
rate for the selected virtual fabric. The variable given will be exported with
the value for the rate.
If a variable name of "" is provided, rate is not saved.
For
opagetvf_func, rate is returned as an absolute
value of 25g, 50g, 75g or 100g.
For
opagetvf2_func, rate is returned as an
enumerated value of 15, 12, 9, or 16 corresponding to the absolute values
above, respectively.
If the selected virtual fabric does not have a limitation
specified for rate, the variable will be unaltered.
Function Example
. /usr/sbin/opagetvf_env
# ensure values are empty in case they are not specified for the virtual fabric
MTU=
RATE=
opagetvf_func "-d 'Compute'" PKEY SERVICE_LEVEL MTU RATE
echo "The Compute Virtual Fabric has pkey: $PKEY SL:$SERVICE_LEVEL MTU: $MTU
rate:$RATE"
Note: Additional examples
may be found in
/usr/src/opa/mpi_apps/openmpi.params and
/usr/src/opa/mpi_apps/mvapich2.params. Those
scripts use
opagetvf_func and
opagetvf2_func to get virtual fabric parameters and
then pass them into
openmpi and
mvapich2, respectively.