xenial (1) hwloc-assembler.1.gz

NAME

       hwloc-assembler - Assemble multiple XML topologies

SYNOPSIS

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

OPTIONS

       -n --name <name>
              Set  <name>  in  the  AssemblerName  info  attribute  of  the  next  input  topology  root to ease
              identification within the final global topology.

       -f --force
              Ignore errors while reading input files.

       -v --verbose
              Verbose messages.

DESCRIPTION

       hwloc-assembler combines the input XML topologies and exports the resulting global topologies  to  a  new
       XML file.  All inputs are inserting as children of the global root object.

       Each  input  topology  root is annotated with info attributes before insertion.  AssemblerIndex is set to
       the index within the list of inputs.  AssemblerName is set to the name given with --name if any.

       hwloc-assembler-remote offers a frontend  for  assembling  remote  nodes  topologies  without  having  to
       manually gather and transfer each of them.

EXAMPLES

       To assemble two nodes topologies:

           $ hwloc-assembler output.xml --name host1 host1.xml --name host2 host2.xml

RETURN VALUE

       Upon successful execution, hwloc-assembler returns 0.

       hwloc-assembler  will return nonzero if any kind of error occurs, such as (but not limited to) failure to
       parse the command line.

SEE ALSO

       hwloc(7), lstopo(1), hwloc-assembler-remote(1)