Open MPI logo

ompi_info(1) man page (version 1.7.4)

  |   Home   |   Support   |   FAQ   |  

« Return to documentation listing

Table of Contents

Name

ompi_info - Display information about the Open MPI installation

Synopsis

ompi_info [options]

Description

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

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

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

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

Options

ompi_info accepts the following options:
-a|--all
Show all configuration options and MCA parameters
--arch
Show architecture Open MPI 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 Open MPI 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 LEVEL 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 Open MPI 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 Open MPI.

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

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

Authors

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

This manual page was originally contributed by Dirk Eddelbuettel <email-address-removed>, one of the Debian GNU/Linux maintainers for Open MPI, and may be used by others.


Table of Contents

« Return to documentation listing