17.1.8. pquery — OpenPMIx 5.0.8 documentation

# 17.1.8. pquery

pquery — query information from the host environment

## 17.1.8.1. SYNOPSIS

`pquery [options] <KEY1>,<KEY2>,...`

## 17.1.8.2. DESCRIPTION

`pquery` requests the host environment for values associated with the provided keys

## 17.1.8.3. OPTIONS

`pquery` 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.

- `--pmixmca <arg0> <arg1>`: Set MCA parameter value

- `--uri <arg0>`: Specify the URI of the server to which we are to connect, or the name of the file (specified as file:filename) that contains that info

- `--namespace <arg0>`: Namespace of the daemon to which we should connect

- `--pid <arg0>`: PID of the daemon to which we should connect (int => PID or file:<file> for file containing the PID

- `--system-server-first`: First look for a system server and connect to it if found

- `--system-server`: Connect to a system-level server

- `--tmpdir <arg0>`: Set the root for the session directory tree

- `--wait-to-connect <arg0>`: Delay specified number of seconds before trying to connect

- `--num-connect-retries <arg0>`: Max number of times to try to connect

Keys passed to pquery may optionally include one or more qualifiers, with the individual qualifiers delimited by semi-colons. For example:

    $ pquery "PMIX_STORAGE_XFER_SIZE[PMIX_STORAGE_ID=lustre1,lustre2;PMIX_STORAGE_PATH=foo]""

## 17.1.8.4. EXIT STATUS

Returns 0 for success, or a non-zero value otherwise. Values returned by the query are printed to stdout.

## 17.1.8.5. EXAMPLES

Examples of using this command.

See also

openpmix(5)