---
name: "hwloc-assembler"
section: "1"
platform: "linux"
package: "hwloc"
version: "1.11.12-3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/hwloc-assembler"
---

# hwloc-assembler(1)

Assemble multiple XML topologies

## 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)](/hwloc/7.md), [lstopo(1)](/lstopo/1.md), [hwloc-assembler-remote(1)](/hwloc-assembler-remote/1.md)