HWLOC-GATHER-TOPOLOGY(1)             hwloc            HWLOC-GATHER-TOPOLOGY(1)

<?><?><?> (NAME)
       hwloc-gather-topology - <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?>
       x86 <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?> XML
       <?><?><?><?><?> lstopo <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> (<?><?><?><?><?><?><?><?> <?><?><?><?><?><?>)

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       hwloc-gather-topology [options] <path>

<?><?><?><?><?><?><?><?> (OPTIONS)
       --io   <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> I/O <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       --dmi  <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> DMI/SMBIOS <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> (root)
              <?><?><?> <?> <?><?><?><?><?> <?><?><?><?> dmi-sysfs
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>.

       --dt   <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> Device-Tree <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> hwloc <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?> /sys <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

       --no-cpuid
              <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> (dump)
              <?><?><?><?><?> <?><?> CPUID <?><?> x86 <?><?>
              <?><?><?><?><?><?><?> <?><?> hwloc-gather-cpuid
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       --keep <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>.

       --version
              <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>.

       -h --help
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
              <?><?><?><?>.

<?><?><?><?><?><?><?> (DESCRIPTION)
       hwloc-gather-topology <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?> (<path>.tar.bz2)<?> <?><?><?><?><?> lstopo <?><?>
       <?><?> (<path>.output) <?> <?><?><?><?><?> XML <?><?><?><?><?> lstopo
       <?><?> <?><?> (<path>.xml) <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> /proc/cpuinfo <?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> /sys/devices/system/node/ <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?>.  <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> tar<?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> --input <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> hwloc <?><?><?>.
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> HWLOC_FSROOT<?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?> hwloc
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?> XML
       <?><?><?><?><?> lstopo <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> hwloc <?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?>.

       hwloc-gather-topology <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?><?><?>: hwloc-gather-topology <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?> tar <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?>: <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?>: <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> hwloc(7)
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> (<?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?>)<?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?>:

           $ hwloc-gather-topology /tmp/myhost

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       /tmp/myhost.tar.bz2<?> <?><?><?><?><?> lstopo <?><?> <?><?>
       <?><?><?><?> /tmp/myhost.output <?> <?><?><?><?><?> XML <?><?><?><?><?>
       lstopo <?><?> <?><?> <?><?><?><?> /tmp/myhost.xml <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> <?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> hwloc <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> hwloc<?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> myhost.tar.bz2 <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>:

           $ tar jxvf /tmp/myhost.tar.bz2

       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> myhost <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.  <?><?><?> <?><?>
       <?><?><?><?><?> --input myhost<?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> hwloc <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>:

            $ lstopo --input ./myhost

       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>:

            $ lstopo --input /path/to/remote/host/extracted/topology/

       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> hwloc <?><?><?><?><?>
       <?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>:

            $ hwloc-distrib --input myhost --single 8

       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?>:

            $ hwloc-calc --input myhost --po --li -I pu $(hwloc-distrib
       --input myhost --single 8)

       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
       --input <?><?> <?><?><?><?><?><?> <?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> HWLOC_FSROOT <?><?><?><?><?><?><?> <?><?><?>:

            $ HWLOC_FSROOT=myhost hwloc-calc --po --li -I pu $(hwloc-distrib
       --single 8)

       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> hwloc-gather-topology <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>.

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> hwloc-gather-topology <?><?>
       <?><?> <?><?><?><?> 0 <?><?><?><?> <?><?><?><?><?> <?><?>.

       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> (<?><?><?> <?><?> <?><?><?><?><?> <?><?>)
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> hwloc-gather-topology
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       hwloc(7), lstopo(1), hwloc-gather-cpuid(1), hwloc-calc(1), hwloc-
       distrib(1)


2.14.0                           June 8, 2026         HWLOC-GATHER-TOPOLOGY(1)