and export the resulting topology to another XML file.
The input and output files may be the same.
.
+.PP
The annotation may be string info attributes.
This is specified by the \fImode\fR:
+.
.TP
.B info <name> <value>
Specifies a new string info attribute whose name is \fIname\fR and
resulting global topologies to a new XML file.
All inputs are inserting as children of the global root object.
.
+.PP
Each input topology root is annotated with info attributes
before insertion.
\fIAssemblerIndex\fR is set to the index within the list of inputs.
\fIAssemblerName\fR is set to the name given with \fB--name\fR if any.
.
+.PP
hwloc-assembler-remote offers a frontend for assembling remote nodes
topologies without having to manually gather and transfer each of them.
.
successful execution, hwloc-bind simply sets bindings and then execs
the executable over itself.
.
+.PP
If binding fails, or if the binding set is empty, and \fB\-\-force\fR
was not given, hwloc-bind returns with an error instead of launching
the executable.
hwloc-diff computes the difference between two XML topologies
and stores the result into <output.xml> if any, or dumps it
to stdout otherwise.
+.
.PP
The output difference may later be applied to another topology
with hwloc-patch.
+.
.PP
.B NOTE:
It is highly recommended that you read the hwloc(7) overview page
level specified by option \fB\-\-to\fR, or until only one element remains),
splitting the number of elements at each encountered hierarchy level not ignored
by options \fB\-\-ignore\fR.
-
+.
+.PP
This can e.g. be used to distribute a set of processes hierarchically according
to the topology of a machine. These masks can be used with hwloc-bind(1).
.
certain attribute lines.
When no object is specified, hwloc-info prints a summary of the topology.
.
+.PP
Objects may be specified as location tuples, as explained in hwloc(7).
However hexadecimal bitmasks are not accepted since they may correspond
to multiple objects.
hwloc-patch loads the difference between two topologies from a XML file
(or from the standard input) and applies it to an
existing topology, generating a new, modified one.
+.
.PP
If <output.xml> is given, the new, modified topology is stored in that
new file. Otherwise, <topology.xml> is modified in place.
+.
.PP
If - is used instead of <diff.xml>, the topology difference is read from
the standard input.
+.
.PP
The XML difference may have been computed earlier with hwloc-diff.
+.
.PP
.B NOTE:
It is highly recommended that you read the hwloc(7) overview page