OSHMEM_INFO(1)

๐Ÿ’– NAME ๐Ÿ’–

hiii bestie, welcome to the Open MPI manual โ€” this is page OSHMEM_INFO(1), and it's all about...

oshmem_info โ€” Display information about the OpenSHMEM installation โœจ

like literally that's the whole job and she ate ๐Ÿ’…


๐ŸŒธ SYNOPSIS ๐ŸŒธ

oshmem_info [options]

๐Ÿฆ‹ DESCRIPTION ๐Ÿฆ‹

okay so oshmem_info gives u the detailed information about ur OpenSHMEM installation. it's lowkey useful for at least three iconic scenarios:

  1. checking ur 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). no cap, there's a whole vibe system for this.

๐Ÿ‘‘ OPTIONS ๐Ÿ‘‘

oshmem_info accepts the following options:

  • -a, --all โ€” show all configuration options and MCA parameters. everything. the full tea ๐Ÿ”ฅ
  • --arch โ€” show the 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 the 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 โ€” hands off bestie, fr fr ๐Ÿ™ˆ)
  • --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 is a 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 ๐Ÿท๏ธ

๐ŸŒˆ 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 OpenSHMEM implementors ๐Ÿ› ๏ธ
  8. detailed information for OpenSHMEM implementors ๐Ÿงฐ
  9. all remaining information for OpenSHMEM implementors ๐Ÿง 

๐Ÿ“ EXAMPLES ๐Ÿ“

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. ๐Ÿ’ฅ


2003-2026, The Open MPI Community


and that's the whole page bestie, we're done!! ๐Ÿซถ๐Ÿ’– this one came from Open MPI, dated Sep 10, 2026, and it lives at OSHMEM_INFO(1) โ€” slay, goodbye, periodt โœจ๐ŸŽ€๐Ÿฆ‹

๐Ÿ“ฆ where this page comes from