SYNOPSIS

       oshmem_info [options]

DESCRIPTION

       oshmem_info provides detailed information about the OpenSHMEM installation. It can be useful for at least
       three common scenarios:

       1. Checking local configuration and seeing how OpenSHMEM was installed.

       2. Submitting bug reports / help requests to the OpenSHMEM community (see Getting help).

       3. Seeing a list of installed OpenSHMEM plugins and querying what MCA parameters they support.

       NOTE:
          oshmem_info  defaults  to only showing a few MCA parameters by default (i.e., level 1 parameters). Use
          the --level option to enable showing more options (see the LEVELS section for more information).

OPTIONS

       oshmem_info accepts the following options:

       • -a, --all: Show all configuration options and MCA parameters

       • --arch: Show architecture OpenSHMEM was compiled on

       • -c, --config: Show configuration options

       • -gmca, --gmca <param> <value>*: Pass global MCA parameters that are applicable to all contexts.

       • -h, --help*: Shows help / usage message

       • --hostname: Show the hostname that OpenSHMEM was configured and built on

       • --internal: Show internal MCA parameters (not meant to be modified by users)

       • --level: Show only variables with at most this level (1-9). The default is 1 unless --all is  specified
         without --level in which case the default is 9. See the LEVELS section for more information.

       • -mca, --mca <param> <value>: Pass context-specific MCA parameters; they are considered global if --gmca
         is not used and only one context is specified.

       • --param  <type>  <component>:  Show MCA parameters. The first parameter is the type of the component to
         display; the second parameter is the specific  component  to  display  (or  the  keyword  all,  meaning
         “display all components of this type”).

       • --parsable:   When   used  in  conjunction  with  other  parameters,  the  output  is  displayed  in  a
         machine-parsable format --parseable Synonym for --parsable.

       • --path <type>: Show paths that OpenSHMEM was configured with. Accepts the following parameters: prefix,
         bindir, libdir, incdir, pkglibdir, sysconfdir.

       • --pretty: When used in conjunction with other parameters, the output is displayed in prettyprint format
         (default)

       • --selected-only: Show only variables from selected components.

       • -V, --version*: Show version of OpenSHMEM.

LEVELS

       1. Basic information of interest to users

       2. Detailed information of interest to users

       3. All remaining information of interest to users

       4. Basic information required for tuning

       5. Detailed information required for tuning

       6. All remaining information required for tuning

       7. Basic information for OpenSHMEM implementors

       8. Detailed information for OpenSHMEM implementors

       9. All remaining information for OpenSHMEM implementors

EXAMPLES

          shell$ oshmem_info

       Show the default output of options and listing of installed components in a human-readable /  prettyprint
       format.

          shell$ oshmem_info --parsable

       Show the default output of options and listing of installed components in a machine-parsable format.

          shell$ oshmem_info --param btl openib

       Show the MCA parameters of the “openib” BTL component in a human-readable / prettyprint format.

          shell$ oshmem_info --param btl openib --parsable

       Show the MCA parameters of the “openib” BTL component in a machine-parsable format.

          shell$ oshmem_info --path bindir

       Show the “bindir” that OpenSHMEM was configured with.

          shell$ oshmem_info --version ompi full --parsable

       Show  the  full  version  numbers  of  OpenSHMEM  (including  the  ORTE  and  OPAL  version numbers) in a
       machine-readable format.

          shell$ oshmem_info --version btl major

       Show the major version number of all BTL components in a prettyprint format.

          shell$ oshmem_info --version btl:tcp minor

       Show the minor version number of the TCP BTL component in a prettyprint format.

          shell$ oshmem_info --all

       Show all information about the OpenSHMEM installation, including all components that can  be  found,  the
       MCA parameters that they support, versions of OpenSHMEM and the components, etc.

COPYRIGHT

       2003-2025, The Open MPI Community

                                                  Jun 07, 2025                                    OSHMEM_INFO(1)