mpirun (Open MPI) 2.1.1 Usage: mpirun [OPTION]... [PROGRAM]... Start the given program using Open RTE -allow-run-as-root|--allow-run-as-root Allow execution as root (STRONGLY DISCOURAGED) -am Aggregate MCA parameter set file list --app Provide an appfile; ignore all other command line options --bind-to 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 Number of processes to run -cf|--cartofile Provide a cartography file -cpu-set|--cpu-set Comma-separated list of ranges specifying logical cpus allocated to this job [default: none] -cpus-per-proc|--cpus-per-proc Number of cpus to use for each process [default=1] -cpus-per-rank|--cpus-per-rank 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 Sequence of debuggers to search for when "--debug" is used -default-hostfile|--default-hostfile 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 -dvm|--dvm Create a persistent distributed virtual machine (DVM) -enable-recovery|--enable-recovery Enable recovery from process failure [Default = disabled] -get-stack-traces|--get-stack-traces Get stack traces of all application procs on timeout -gmca|--gmca 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 List of hosts to invoke processes on -H|-host|--host 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 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 Command used to start processes on remote nodes (default: orted) -leave-session-attached|--leave-session-attached Enable debugging of OpenRTE -machinefile|--machinefile Provide a hostfile --map-by Mapping Policy [slot | hwthread | core | socket (default) | numa | board | node] -max-restarts|--max-restarts Max number of times to restart a failed process -max-vm-size|--max-vm-size Number of processes to run -mca|--mca 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 Launch n processes per node on all allocated nodes (synonym for npernode) -n|--n 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 Launch n processes per node on all allocated nodes -npersocket|--npersocket Launch n processes per socket on all allocated nodes -ompi-server|--ompi-server Specify the URI of the publish/lookup server, or the name of the file (specified as file:filename) that contains that info -output-filename|--output-filename 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 PATH to be used to look for executables to start processes -pernode|--pernode Launch one process per available node -personality|--personality Programming model/language being used (default="ompi") --ppr Comma-separated list of number of processes on a given resource type [default: none] --prefix Prefix where Open MPI is installed on remote nodes --preload-files 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 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 Report events to a tool listening at the specified URI -report-pid|--report-pid Printout pid on stdout [-], stderr [+], or a file [anything else] -report-state-on-timeout|--report-state-on-timeout Report all job and process states upon timeout -report-uri|--report-uri Printout URI on stdout [-], stderr [+], or a file [anything else] -rf|--rankfile Provide a rankfile file -s|--preload-binary Preload the binary on the remote machine before starting the remote process. -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 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 Specify procs to receive stdin [rank, all, none] (default: 0, indicating rank 0) -tag-output|--tag-output Tag all output with [job,rank] -timeout|--timeout Timeout the job after the specified number of seconds -timestamp-output|--timestamp-output Timestamp all application process output -tune Application profile options file list -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 -wd|--wd Synonym for --wdir -wdir|--wdir Set the working directory of the started processes -x 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 Provide all output in XML format to the specified file -xterm|--xterm Create a new xterm window and display output from the specified ranks there Report bugs to http://www.open-mpi.org/community/help/