8.9. Deprecated options — PMIx Reference Run Time Environment 3.0.12 documentation

# 8.9. Deprecated options

These deprecated options will be removed in a future release.

Deprecated Option | Replacement | Description
--- | --- | ---
`--bind-to-core` | `--bind-to core` | Bind processes to cores
`--bind-to-socket` | `--bind-to package` | Bind processes to processor sockets
`--bycore` | `--map-by core` | Map processes by core
`--bynode` | `--map-by node` | Launch processes one per node, cycling by node in a round-robin fashion. This spreads processes evenly among nodes and assigns ranks in a round-robin, “by node” manner.
`--byslot` | `--map-by slot` | Map and rank processes round-robin by slot
`--cpus-per-proc <#perproc>` | –map-by <obj>:PE=<#perproc>` | Bind each process to the specified number of CPUs
`--cpus-per-rank <#perrank>` | `--map-by <obj>:PE=<#perrank>` | Alias for `--cpus-per-proc`
`--display-allocation` | `--display ALLOC` | Display the detected resource allocation
`-display-devel-map` | `--display MAP-DEVEL` | Display a detailed process map (mostly intended for developers) just before launch.
`--display-map` | `--display MAP` | Display a table showing the mapped location of each process prior to launch.
`--display-topo` | `--display TOPO` | Display the topology as part of the process map (mostly intended for developers) just before launch.
`--do-not-launch` | `--map-by :DONOTLAUNCH` | Perform all necessary operations to prepare to launch the application, but do not actually launch it (usually used to test mapping patterns).
`--do-not-resolve` | `--map-by :DONOTRESOLVE` | Do not attempt to resolve interfaces — usually used to determine proposed process placement/binding prior to obtaining an allocation.
`-N <num>` | `--map-by prr:<num>:node` | Launch `num` processes per node on all allocated nodes
`--nolocal` | `--map-by :NOLOCAL` | Do not run any copies of the launched application on the same node as `prun` is running. This option will override listing the `localhost` with `--host` or any other host-specifying mechanism.
`--nooversubscribe` | `--map-by :NOOVERSUBSCRIBE` | Do not oversubscribe any nodes; error (without starting any processes) if the requested number of processes would cause oversubscription. This option implicitly sets “max_slots” equal to the “slots” value for each node. (Enabled by default).
`--npernode <#pernode>` | `--map-by ppr:<#pernode>:node` | On each node, launch this many processes
`--npersocket <#persocket>` | `--map-by ppr:<#perpackage>:package` | On each node, launch this many processes times the number of processor sockets on the node. The `--npersocket` option also turns on the `--bind-to socket` option. The term `socket` has been globally replaced with `package`.
`--oversubscribe` | `--map-by :OVERSUBSCRIBE` | Nodes are allowed to be oversubscribed, even on a managed system, and overloading of processing elements.
`--pernode` | `--map-by ppr:1:node` | On each node, launch one process
`--ppr` | –map-by ppr:<list>` | Comma-separated list of number of processes on a given resource type [default: `none`].
`--rankfile <FILENAME>` | `--map-by rankfile:FILE=<FILENAME>` | Use a rankfile for mapping/ranking/binding
`--report-bindings` | `--display BINDINGS` | Report any bindings for launched processes
`--tag-output` | `--output TAG` | Tag all output with `[job,rank]`
`--timestamp-output` | `--output TIMESTAMP` | Timestamp all application process output
`--use-hwthread-cpus` | `--map-by :HWTCPUS` | Use hardware threads as independent CPUs
`--xml` | `--output XML` | Provide all output in XML format