hwloc-distrib - Build a number of cpu masks distributed on the system
SYNOPSIS
topodistrib
[options] <integer>
OPTIONS
--single
Singlify each output to a single CPU.
-v
Verbose messages.
--xml <path>
Read topology from XML file <path> (instead of discovering the
topology on the local machine). If <path> is "-", the standard input
is used. XML support must have been compiled in to hwloc for this
option to be usable.
--synthetic <specification>
Simulate a fake hierarchy (instead of discovering the topology on the
local machine). If <specification> is "node:2 pu:3", the topology will
contain two NUMA nodes with 3 processing units in each of them.
--version
Report version and exit.
DESCRIPTION
hwloc-distrib generates a series of CPU masks in an attempt to
distribute a set of processes around multiple processors in a single
server. These masks can be used with hwloc-bind(1).
NOTE:
It is highly recommended that you read the hwloc(7) overview page
before reading this man page. Most of the concepts described in
hwloc(7) directly apply to the hwloc-bind utility.
EXAMPLES
hwloc-distrib's operation is best described through several examples.
If 4 processes have to be distributed across a machine, their CPU masks
may be obtained with: