17.1.1. pmix_info

pmix_info — Display information about the PMIx installation

17.1.1.1. SYNOPSIS

pmix_info [options]

17.1.1.2. DESCRIPTION

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

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

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

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

17.1.1.3. OPTIONS

pmix_info accepts the following options:

  • -h | --help <arg0>: Show help message. If the optional argument is not provided, then a generalized help message similar to the information provided here is returned. If an argument is provided, then a more detailed help message for that specific command line option is returned.

  • -v | --verbose: Enable debug output.

  • -V | --version: Print version and exit.

  • -a | --all: Show all configuration options and MCA parameters.

  • --arch: Show architecture on which PMIx was compiled.

  • -c | --config: Show configuration options

  • --hostname: Show the hostname on which PMIx was configured and built.

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

  • --param <arg0>:<arg1>,<arg2>: Show MCA parameters. The first parameter is the framework (or the keyword “all”); the second parameter is a comma-delimited list of specific component names (if only <arg0> is given, then all components will be reported).

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

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

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

  • --parseable: Synonym for --parsable

  • --show-failed: Show the components that failed to load along with the reason why they failed

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

17.1.1.4. EXIT STATUS

Returns 0 if successful, non-zero if an error is encountered

17.1.1.5. EXAMPLES

Examples of using this command.

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

pmix_info

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

pmix_info --parsable

Show the MCA parameters of the “opa” PNET component in a human-readable / prettyprint format:

pmix_info --param pnet opa

Show the “bindir” that PMIx was configured with:

pmix_info --path bindir

Show the version of PMIx version numbers in a prettyprint format:

pmix_info --version

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

pmix_info --all

See also

openpmix(5)