NAME

       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.

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

       # 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.