HWLOC-DISTRIB(1)                     hwloc                    HWLOC-DISTRIB(1)

<?><?><?> (NAME)
       hwloc-distrib - <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> CPU
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       hwloc-distrib [options] <integer>

<?><?><?><?><?><?><?><?> (OPTIONS)
       --single
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
              <?><?> CPU <?><?><?><?>.

       --cpuset-output-format <hwloc|list|taskset> --cof <hwloc|list|taskset>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> CPU
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?>.  <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> hwloc
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?> list
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              2,4-5,8 .  <?><?><?> taskset <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> taskset
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              (<?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              --taskset <?><?><?><?><?><?>).

       -v --verbose
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?>.

       -i <path>, --input <path>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <path> <?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?>.

              <?><?><?> <path> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> XML
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> hwloc <?><?><?><?>.
              <?><?><?> <path> <?><?><?><?><?> <?><?> <<->> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?> XML <?><?><?><?><?><?><?> <?><?><?>.

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

              <?><?> x86<?> <?><path> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              cpuid <?><?><?><?> <?><?> <?><?> hwloc-gather-cpuid
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>.

              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> archivemount
              <?><?> <?><?><?><?><?> <?><?><?><?><?> <path> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> tarball
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> Linux <?><?> x86 <?><?><?><?>.

       -i <specification>, --input <specification>
              <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?>). <?><?><?>
              <specification> <?><?><?><?><?> <?><?> "node:2 pu:3"
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?> NUMA <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?>
              <?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?><?> (PU)
              <?><?><?><?> <?><?><?><?>.  <?><?><?><?><?> <specification>
              <?><?><?><?> <?><?> <?><?><?><?><?><?> PU <?><?><?> <?><?><?>.

       --if <format>, --input-format <format>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> xml<?>
              <?>fsroot<?> cpuid <?> synthetic.

       --ignore <type>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?> <type> <?><?> <?><?><?><?><?><?><?><?>.

       --from <type>
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?>.

              <?><type> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              NUMANode<?> <?>I/O <?><?> Misc <?><?><?><?>.

       --to <type>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.  <?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> (binding) <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
              package <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
              <?><?> <?><?><?><?><?>.

              <?><type> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              NUMANode<?> <?>I/O <?><?> Misc <?><?><?><?>.

       --at <type>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?> <?><?><?><?><?><?> --from <?> --to <?><?><?>.

       --reverse
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> CPU <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> (<?><?>
              <?><?><?> <?><?><?> <?><?><?>).

       --restrict <cpuset>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              cpuset <?><?><?><?><?><?><?><?>.  <?><?><?> <?><?><?>
              <?><?><?><?> <?><?> PU<?><?> <?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?>.

              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> PU<?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> NUMA <?><?> <?><?><?><?><?> <?><?><?>.

       --restrict nodeset=<nodeset>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              nodeset <?><?><?><?><?><?><?><?> (<?><?><?> <?><?><?><?><?>
              --restrict-flags <?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?>).  <?><?><?> <?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> NUMA <?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?>.

              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> NUMA <?><?>
              <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> PU<?><?> <?><?>
              <?><?><?><?><?> <?><?><?>.

       --restrict-flags <flags>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?> hwloc_topology_restrict()
              <?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              bynodeset,memless.  <?><?><?><?><?> <?><?><?><?><?><?><?> 0
              (<?><?> none) <?><?><?>.

       --disallowed
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?>.

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

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

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> hwloc-distrib <?><?> <?><?><?> <?><?><?><?> CPU
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> (<?><?> <?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?> --from <?><?><?><?> <?><?><?>) <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> (<?><?> <?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> --to <?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?>) <?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       --ignore <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?>. <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> hwloc-bind(1) <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?> CPU<?><?><?> <?><?><?><?><?><?><?> (<?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>)<?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> PU<?><?> <?><?><?><?> <?><?><?><?><?><?><?> (packages) <?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> (<?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>).  <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>.  <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> CPU <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> E-core <?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> P-core<?> <?><?><?><?> <?><?><?> N <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> E-core<?><?> <?> M
       <?><?><?> <?><?> <?><?><?> P-core<?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> M+N <?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

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

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?> hwloc-distrib <?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

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

           $ hwloc-distrib 4
           0x0000000f
           0x00000f00
           0x000000f0
           0x0000f000

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

           $ hwloc-distrib --restrict $(hwloc-calc package:1) 4
           0x00000010
           0x00000020
           0x00000040
           0x00000080

       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> CPU (<?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>):

           $ hwloc-distrib 4 --single
           0x00000001
           0x00000100
           0x00000010
           0x00001000

       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> hwloc-calc <?><?><?><?><?>
       <?><?><?>:

           $ hwloc-distrib 4 --single | hwloc-calc --oo -q -I pu
           PU:0
           PU:8
           PU:4
           PU:12

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?> dplace -c <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> mpirun
       <?><?><?><?><?> <?><?><?>:

           $ hwloc-distrib 4 --single | xargs hwloc-calc -I pu
           0,8,4,16

<?><?><?><?><?> <?><?><?><?><?><?><?> (RETURN VALUE)
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> hwloc-distrib <?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> CPU <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?>
       <?><?><?><?><?><?><?> 0 <?><?><?>.

       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> (<?><?><?> <?><?> <?><?><?><?><?> <?><?>) <?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> hwloc-distrib
       <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       hwloc(7)


2.14.0                           June 8, 2026                 HWLOC-DISTRIB(1)