mpiexec --version (return code: 0)
mpiexec (OpenRTE) 1.10.2
Report bugs to http://www.open-mpi.org/community/help/
mpiexec --help (return code: 0)
mpiexec (OpenRTE) 1.10.2
Usage: mpiexec [OPTION]... [PROGRAM]...
Start the given program using Open RTE
-allow-run-as-root|--allow-run-as-root
Allow execution as root (STRONGLY DISCOURAGED)
-am <arg0> Aggregate MCA parameter set file list
--app <arg0> Provide an appfile; ignore all other command line
options
--bind-to <arg0> Policy for binding processes. Allowed values: none,
hwthread, core, l1cache, l2cache, l3cache, socket,
numa, board ("none" is the default when
oversubscribed, "core" is the default when np<=2,
and "socket" is the default when np>2). Allowed
qualifiers: overload-allowed, if-supported
-bind-to-core|--bind-to-core
Bind processes to cores
-bind-to-socket|--bind-to-socket
Bind processes to sockets
-bycore|--bycore Whether to map and rank processes round-robin by
core
-bynode|--bynode Whether to map and rank processes round-robin by
node
-byslot|--byslot Whether to map and rank processes round-robin by
slot
-c|-np|--np <arg0> Number of processes to run
-cf|--cartofile <arg0>
Provide a cartography file
-cpu-set|--cpu-set <arg0>
Comma-separated list of ranges specifying logical
cpus allocated to this job [default: none]
-cpus-per-proc|--cpus-per-proc <arg0>
Number of cpus to use for each process [default=1]
-cpus-per-rank|--cpus-per-rank <arg0>
Synonym for cpus-per-proc
-d|-debug-devel|--debug-devel
Enable debugging of OpenRTE
-debug|--debug Invoke the user-level debugger indicated by the
orte_base_user_debugger MCA parameter
-debug-daemons|--debug-daemons
Enable debugging of any OpenRTE daemons used by
this application
-debug-daemons-file|--debug-daemons-file
Enable debugging of any OpenRTE daemons used by
this application, storing output in files
-debugger|--debugger <arg0>
Sequence of debuggers to search for when "--debug"
is used
-default-hostfile|--default-hostfile <arg0>
Provide a default hostfile
-disable-recovery|--disable-recovery
Disable recovery (resets all recovery options to
off)
-display-allocation|--display-allocation
Display the allocation being used by this job
-display-devel-allocation|--display-devel-allocation
Display a detailed list (mostly intended for
developers) of the allocation being used by this
job
-display-devel-map|--display-devel-map
Display a detailed process map (mostly intended for
developers) just before launch
-display-diffable-map|--display-diffable-map
Display a diffable process map (mostly intended for
developers) just before launch
-display-map|--display-map
Display the process map just before launch
-display-topo|--display-topo
Display the topology as part of the process map
(mostly intended for developers) just before
launch
-do-not-launch|--do-not-launch
Perform all necessary operations to prepare to
launch the application, but do not actually launch
it
-do-not-resolve|--do-not-resolve
Do not attempt to resolve interfaces
-enable-recovery|--enable-recovery
Enable recovery from process failure [Default =
disabled]
-gmca|--gmca <arg0> <arg1>
Pass global MCA parameters that are applicable to
all contexts (arg0 is the parameter name; arg1 is
the parameter value)
-h|--help This help message
-H|-host|--host <arg0> List of hosts to invoke processes on
-H|-host|--host <arg0> List of hosts to invoke processes on
--hetero-apps Indicates that multiple app_contexts are being
provided that are a mix of 32/64 bit binaries
--hetero-nodes Nodes in cluster may differ in topology, so send
the topology back from each node [Default = false]
-hostfile|--hostfile <arg0>
Provide a hostfile
-index-argv-by-rank|--index-argv-by-rank
Uniquely index argv[0] for each process using its
rank
-launch-agent|--launch-agent <arg0>
Command used to start processes on remote nodes
(default: orted)
-leave-session-attached|--leave-session-attached
Enable debugging of OpenRTE
-machinefile|--machinefile <arg0>
Provide a hostfile
--map-by <arg0> Mapping Policy [slot | hwthread | core | socket
(default) | numa | board | node]
-max-restarts|--max-restarts <arg0>
Max number of times to restart a failed process
-max-vm-size|--max-vm-size <arg0>
Number of processes to run
-mca|--mca <arg0> <arg1>
Pass context-specific MCA parameters; they are
considered global if --gmca is not used and only
one context is specified (arg0 is the parameter
name; arg1 is the parameter value)
-N <arg0> Launch n processes per node on all allocated nodes
(synonym for npernode)
-n|--n <arg0> Number of processes to run
-nolocal|--nolocal Do not run any MPI applications on the local node
-nooversubscribe|--nooversubscribe
Nodes are not to be oversubscribed, even if the
system supports such operation
--noprefix Disable automatic --prefix behavior
-novm|--novm Execute without creating an allocation-spanning
virtual machine (only start daemons on nodes
hosting application procs)
-npernode|--npernode <arg0>
Launch n processes per node on all allocated nodes
-npersocket|--npersocket <arg0>
Launch n processes per socket on all allocated
nodes
-ompi-server|--ompi-server <arg0>
Specify the URI of the Open MPI server, or the name
of the file (specified as file:filename) that
contains that info
-output-filename|--output-filename <arg0>
Redirect output from application processes into
filename.rank
-output-proctable|--output-proctable
Output the debugger proctable after launch
-oversubscribe|--oversubscribe
Nodes are allowed to be oversubscribed, even on a
managed system, and overloading of processing
elements
-path|--path <arg0> PATH to be used to look for executables to start
processes
-pernode|--pernode Launch one process per available node
--ppr <arg0> Comma-separated list of number of processes on a
given resource type [default: none]
--prefix <arg0> Prefix where Open MPI is installed on remote nodes
--preload-files <arg0>
Preload the comma separated list of files to the
remote machines current working directory before
starting the remote process.
-q|--quiet Suppress helpful messages
--rank-by <arg0> Ranking Policy [slot (default) | hwthread | core |
socket | numa | board | node]
-report-bindings|--report-bindings
Whether to report process bindings to stderr
-report-child-jobs-separately|--report-child-jobs-separately
Return the exit status of the primary job only
-report-events|--report-events <arg0>
Report events to a tool listening at the specified
URI
-report-pid|--report-pid <arg0>
Printout pid on stdout [-], stderr [+], or a file
[anything else]
-report-uri|--report-uri <arg0>
Printout URI on stdout [-], stderr [+], or a file
[anything else]
-rf|--rankfile <arg0>
Provide a rankfile file
-s|--preload-binary Preload the binary on the remote machine before
starting the remote process.
-server-wait-time|--server-wait-time <arg0>
Time in seconds to wait for ompi-server (default:
10 sec)
-set-cwd-to-session-dir|--set-cwd-to-session-dir
Set the working directory of the started processes
to their session directory
-show-progress|--show-progress
Output a brief periodic report on launch progress
-slot-list|--slot-list <arg0>
List of processor IDs to bind processes to
[default=NULL]
-staged|--staged Used staged execution if inadequate resources are
present (cannot support MPI jobs)
-stdin|--stdin <arg0>
Specify procs to receive stdin [rank, all, none]
(default: 0, indicating rank 0)
-tag-output|--tag-output
Tag all output with [job,rank]
-timestamp-output|--timestamp-output
Timestamp all application process output
-tv|--tv Deprecated backwards compatibility flag; synonym
for "--debug"
-use-hwthread-cpus|--use-hwthread-cpus
Use hardware threads as independent cpus
-use-regexp|--use-regexp
Use regular expressions for launch
-v|--verbose Be verbose
-V|--version Print version and exit
-wait-for-server|--wait-for-server
If ompi-server is not already running, wait until
it is detected (default: false)
-wd|--wd <arg0> Synonym for --wdir
-wdir|--wdir <arg0> Set the working directory of the started processes
-x <arg0> Export an environment variable, optionally
specifying a value (e.g., "-x foo" exports the
environment variable foo and takes its value from
the current environment; "-x foo=bar" exports the
environment variable name foo and sets its value to
"bar" in the started processes)
-xml|--xml Provide all output in XML format
-xml-file|--xml-file <arg0>
Provide all output in XML format to the specified
file
-xterm|--xterm <arg0>
Create a new xterm window and display output from
the specified ranks there
Report bugs to http://www.open-mpi.org/community/help/