Scroll to navigation

OSHMEM_INFO(1) Open MPI OSHMEM_INFO(1)

NAME

oshmem_info - Display information about the Open MPI installation

SYNOPSIS

oshmem_info [options]

DESCRIPTION

oshmem_info provides detailed information about the Open MPI/SHMEM installation. It can be useful for at least three common scenarios:

1. Checking local configuration and seeing how Open MPI/SHMEM was installed.

2. Submitting bug reports / help requests to the Open MPI/SHMEM community (see http://www.open-mpi.org/community/help/)

3. Seeing a list of installed Open MPI/SHMEM plugins and querying what MCA parameters they support.

OPTIONS

oshmem_info accepts the following options:

Show all configuration options and MCA parameters
Show architecture Open MPI/SHMEM was compiled on
Show configuration options
Pass global MCA parameters that are applicable to all contexts.
Shows help / usage message
Show the hostname that Open MPI/SHMEM was configured and built on
Show internal MCA parameters (not meant to be modified by users)
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 LEVEL section for more information.
Pass context-specific MCA parameters; they are considered global if --gmca is not used and only one context is specified.
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").
When used in conjunction with other parameters, the output is displayed in a machine-parsable format --parseable Synonym for --parsable
Show paths that Open MPI/SHMEM was configured with. Accepts the following parameters: prefix, bindir, libdir, incdir, pkglibdir, sysconfdir.
When used in conjunction with other parameters, the output is displayed in 'prettyprint' format (default)
Show only variables from selected components.
Show version of Open MPI/SHMEM.

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 MPI implementors
8
Detailed information for MPI implementors
9
All remaining information for MPI implementors

EXAMPLES

Show the default output of options and listing of installed components in a human-readable / prettyprint format.
oshmem_info --parsable
Show the default output of options and listing of installed components in a machine-parsable format.
oshmem_info --param btl openib
Show the MCA parameters of the "openib" BTL component in a human-readable / prettyprint format.
oshmem_info --param btl openib --parsable
Show the MCA parameters of the "openib" BTL component in a machine-parsable format.
oshmem_info --path bindir
Show the "bindir" that Open MPI was configured with.
oshmem_info --version ompi full --parsable
Show the full version numbers of Open MPI/SHMEM (including the ORTE and OPAL version numbers) in a machine-readable format.
oshmem_info --version btl major
Show the major version number of all BTL components in a prettyprint format.
oshmem_info --version btl:tcp minor
Show the minor version number of the TCP BTL component in a prettyprint format.
oshmem_info --all
Show all information about the Open MPI/SHMEM installation, including all components that can be found, the MCA parameters that they support, versions of Open MPI/SHMEM and the components, etc.

AUTHORS

The Open MPI/SHMEM maintainers -- see http://www.openmpi.org/ or the file AUTHORS.

This manual page was originally contributed by Dirk Eddelbuettel <edd@debian.org>, one of the Debian GNU/Linux maintainers for Open MPI, and may be used by others.

September 30, 2023 4.1.6