oshmem_info - Display information about the OpenSHMEM
installation
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).
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.
- 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
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.
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.
2003-2024, The Open MPI Community