Scroll to navigation

PQUERY(1) OpenPMIx PQUERY(1)

pquery - query information from the host environment

SYNOPSIS

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

DESCRIPTION

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

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]""


EXIT STATUS

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

EXAMPLES

Examples of using this command.

See also:

openpmix(5) <#man5-openpmix>


Copyright

2014-2026, OpenPMIx Community

July 6, 2026