[bogus section]

This section is not used by PRTE code.  But we have to put a RST
section title in this file somewhere, or Sphinx gets unhappy.  So we
put it in a section that is ignored by PRTE code.


Hello, world
============

[usage]

%s (%s) %s

Usage: %s [OPTION]...

The following list of command line options are available. Note that
more detailed help for any option can be obtained by adding that
option to the help request as "--help <option>".

+----------------------+-----------------------------------------------+
|                      | General Options                               |
+----------------------+-----------------------------------------------+
| Option               | Description                                   |
|======================|===============================================|
| "-h" | "--help"      | This help message                             |
+----------------------+-----------------------------------------------+
| "-h" | "--help       | Help for the specified option                 |
| <arg0>"              |                                               |
+----------------------+-----------------------------------------------+
| "-v" | "--verbose"   | Enable typical debug options                  |
+----------------------+-----------------------------------------------+
| "-V" | "--version"   | Print version and exit                        |
+----------------------+-----------------------------------------------+

+----------------------+-----------------------------------------------+
|                      | Debug Options                                 |
+----------------------+-----------------------------------------------+
| Option               | Description                                   |
|======================|===============================================|
| "--debug"            | Top-level PRTE debug switch (default:         |
|                      | "false") This option will be deprecated, use  |
|                      | "--debug-devel" instead.                      |
+----------------------+-----------------------------------------------+
| "--debug-daemons-    | Enable debugging of any PRTE daemons used by  |
| file"                | this application, storing output in files     |
+----------------------+-----------------------------------------------+
| "--leave-session-    | Do not daemonize the "prted"                  |
| attached"            |                                               |
+----------------------+-----------------------------------------------+
| "--test-suicide      | Suicide instead of clean abort after          |
| <arg0>"              | specified delay                               |
+----------------------+-----------------------------------------------+

+----------------------+-----------------------------------------------+
|                      | DVM Options                                   |
+----------------------+-----------------------------------------------+
| Option               | Description                                   |
|======================|===============================================|
| "--pmixmca <key>     | Pass context-specific PMIx MCA parameters;    |
| <value>"             | they are considered global if only one        |
|                      | context is specified ("key" is the parameter  |
|                      | name; "value" is the parameter value)         |
+----------------------+-----------------------------------------------+
| "--prtemca <key>     | Pass context-specific PRTE MCA parameters;    |
| <value>"             | they are considered global if "--gmca" is not |
|                      | used and only one context is specified ("key" |
|                      | is the parameter name; "value" is the         |
|                      | parameter value)                              |
+----------------------+-----------------------------------------------+
| "--dvm-master-uri    | Specify the URI of the DVM master, or the     |
| <uri>"               | name of the file (specified as                |
|                      | "file:filename") that contains that info      |
+----------------------+-----------------------------------------------+
| "--parent-uri <uri>" | Specify the URI of the prted acting as the    |
|                      | parent of this prted in a tree-based spawn    |
|                      | operation                                     |
+----------------------+-----------------------------------------------+
| "--tree-spawn"       | A tree-based spawn operation is in progress   |
+----------------------+-----------------------------------------------+
| "--bootstrap"        | Self-construct the DVM based on a             |
|                      | configuration file                            |
+----------------------+-----------------------------------------------+

+----------------------+-----------------------------------------------+
|                      | Specific Options                              |
+----------------------+-----------------------------------------------+
| Option               | Description                                   |
|======================|===============================================|
| "--set-sid"          | Direct the DVM daemons to separate from the   |
|                      | current session                               |
+----------------------+-----------------------------------------------+
| "--system-server"    | Start the DVM as the system server            |
+----------------------+-----------------------------------------------+
| "--pubsub-server     | Contact information for external PRRTE        |
| <uri>"               | publish/lookup data server                    |
+----------------------+-----------------------------------------------+

Report bugs to %s

[version]

%s (%s) %s

Report bugs to %s

[dvm-master-uri]

Specify the URI of the DVM master, or the name of the file (specified
as "file:filename") that contains that info

[test-suicide]

Test DVM cleanup upon daemon failure by having one daemon suicide
after delay

[system-server]

Start the daemon as the system server on its node

[set-sid]

Direct the daemon to separate from the current session

[prtemca]

Pass a PRRTE MCA parameter.

Syntax: "--prtemca <key> <value>", where "key" is the parameter name
and "value" is the parameter value.

[pmixmca]

Pass a PMIx MCA parameter

Syntax: "--pmixmca <key> <value>", where "key" is the parameter name
and "value" is the parameter value.

[leave-session-attached]

Do not discard stdout/stderr of remote PRRTE daemons. The primary use
for this option is to ensure that the daemon output streams (i.e.,
stdout and stderr) remain open after launch, thus allowing the user to
see any daemon-generated error messages. Otherwise, the daemon will
"daemonize" itself upon launch, thereby closing its output streams.

[parent-uri]

Specify the URI of the prted acting as the parent of this prted in a
tree-based spawn operation

[tree-spawn]

A tree-based spawn operation is in progress

[pubsub-server]

Contact information for external PRRTE publish/lookup data server