1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
.. _man1-pquery:
pquery
=========
.. include_body
pquery |mdash| 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:
.. code::
$ 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.
.. seealso::
:ref:`openpmix(5) <man5-openpmix>`
|
