1HWLOC-ASSEMBLER(1)                   hwloc                  HWLOC-ASSEMBLER(1)
2
3
4

NAME

6       hwloc-assembler - Assemble multiple XML topologies
7

SYNOPSIS

9       hwloc-assembler   [options]   output.xml  [--name  <name1>]  input1.xml
10       [--name <name2>] input2.xml ...
11

OPTIONS

13       -n --name <name>
14              Set <name> in the AssemblerName info attribute of the next input
15              topology  root  to  ease  identification within the final global
16              topology.
17
18       -f --force
19              Ignore errors while reading input files.
20
21       -v --verbose
22              Verbose messages.
23

DESCRIPTION

25       hwloc-assembler combines the  input  XML  topologies  and  exports  the
26       resulting  global topologies to a new XML file.  All inputs are insert‐
27       ing as children of the global root object.
28
29       Each input topology root  is  annotated  with  info  attributes  before
30       insertion.   AssemblerIndex  is  set  to  the  index within the list of
31       inputs.  AssemblerName is set to the name given with --name if any.
32
33       hwloc-assembler-remote offers a frontend for  assembling  remote  nodes
34       topologies without having to manually gather and transfer each of them.
35

EXAMPLES

37       To assemble two nodes topologies:
38
39           $  hwloc-assembler  output.xml  --name host1 host1.xml --name host2
40       host2.xml
41

RETURN VALUE

43       Upon successful execution, hwloc-assembler returns 0.
44
45       hwloc-assembler will return nonzero if any kind of error  occurs,  such
46       as (but not limited to) failure to parse the command line.
47

SEE ALSO

49       hwloc(7), lstopo(1), hwloc-assembler-remote(1)
50
51
52
53
541.11.8                           Sep 06, 2017               HWLOC-ASSEMBLER(1)