---
name: "oshmem_info"
section: "1"
platform: "linux"
package: "openmpi"
version: "5.0.11-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/oshmem_info"
---

# oshmem\_info(1)

oshmem\_info - Display information about the OpenSHMEM installation

## SYNOPSIS

**oshmem\_info \[options\]**

## DESCRIPTION

**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).

## OPTIONS

**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.

## 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.

## COPYRIGHT

2003-2026, The Open MPI Community