oshmem_info - Display information about the OpenSHMEM installation
oshmem_info [options]
oshmem_info
provides detailed information about the OpenSHMEM
installation. It can be useful for at least three common scenarios:
- Checking local configuration and seeing how OpenSHMEM was installed.
- Submitting bug reports / help requests to the OpenSHMEM community (see :doc:`Getting help </getting-help>`).
- 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 :ref:`LEVELS
<man1-oshmem_info-levels>` section for more information).
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 :ref:`LEVELS <man1-oshmem_info-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 keywordall
, 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.
- Basic information of interest to users
- Detailed information of interest to users
- All remaining information of interest to users
- Basic information required for tuning
- Detailed information required for tuning
- All remaining information required for tuning
- Basic information for OpenSHMEM implementors
- Detailed information for OpenSHMEM implementors
- All remaining information for OpenSHMEM implementors
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.