.\" Man page generated from reStructuredText.
.
.TH "PQUERY" "1" "Jul 22, 2024" "" "OpenPMIx"
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.sp
pquery — query information from the host environment
.SH SYNOPSIS
.sp
\fBpquery [options] <KEY1>,<KEY2>,...\fP
.SH DESCRIPTION
.sp
\fBpquery\fP requests the host environment for values associated
with the provided keys
.SH OPTIONS
.sp
\fBpquery\fP accepts the following options:
.INDENT 0.0
.IP \(bu 2
\fB\-h\fP | \fB\-\-help <arg0>\fP: 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.
.IP \(bu 2
\fB\-v\fP | \fB\-\-verbose\fP: Enable debug output.
.IP \(bu 2
\fB\-V\fP | \fB\-\-version\fP: Print version and exit.
.IP \(bu 2
\fB\-\-pmixmca <arg0> <arg1>\fP: Set MCA parameter value
.IP \(bu 2
\fB\-\-uri <arg0>\fP: Specify the URI of the server to which we are to connect, or
the name of the file (specified as \fI\%file:filename\fP) that contains that info
.IP \(bu 2
\fB\-\-namespace <arg0>\fP: Namespace of the daemon to which we should connect
.IP \(bu 2
\fB\-\-pid <arg0>\fP: PID of the daemon to which we should connect (int => PID or file:<file>
for file containing the PID
.IP \(bu 2
\fB\-\-system\-server\-first\fP: First look for a system server and connect to it if found
.IP \(bu 2
\fB\-\-system\-server\fP: Connect to a system\-level server
.IP \(bu 2
\fB\-\-tmpdir <arg0>\fP: Set the root for the session directory tree
.IP \(bu 2
\fB\-\-wait\-to\-connect <arg0>\fP: Delay specified number of seconds before trying to connect
.IP \(bu 2
\fB\-\-num\-connect\-retries <arg0>\fP: Max number of times to try to connect
.UNINDENT
.sp
Keys passed to pquery may optionally include one or more qualifiers, with the
individual qualifiers delimited by semi\-colons. For example:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ pquery "PMIX_STORAGE_XFER_SIZE[PMIX_STORAGE_ID=lustre1,lustre2;PMIX_STORAGE_PATH=foo]""
.ft P
.fi
.UNINDENT
.UNINDENT
.SH EXIT STATUS
.sp
Returns 0 for success, or a non\-zero value otherwise. Values returned by the query
are printed to stdout.
.SH EXAMPLES
.sp
Examples of using this command.
.sp
\fBSEE ALSO:\fP
.INDENT 0.0
.INDENT 3.5
\fI\%openpmix(5)\fP
.UNINDENT
.UNINDENT
.SH COPYRIGHT
2014-2024, The OpenPMIx Community
.\" Generated by docutils manpage writer.
.