opagetvf_env
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.
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]]
- "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.
# 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.