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.  Each input topology root is
28       annotated with info attributes before insertion.  AssemblerIndex is set
29       to the index within the list of inputs.  AssemblerName is  set  to  the
30       name  given  with --name if any.  hwloc-assembler-remote offers a fron‐
31       tend for assembling remote nodes topologies without having to  manually
32       gather and transfer each of them.
33

EXAMPLES

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

RETURN VALUE

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

SEE ALSO

47       hwloc(7), lstopo(1), hwloc-assembler-remote(1)
48
49
50
51
521.5                              Jul 30, 2012               HWLOC-ASSEMBLER(1)