HWLOC-ANNOTATE(1)                    hwloc                   HWLOC-ANNOTATE(1)

<?><?><?> (NAME)
       hwloc-annotate - <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?><?> XML

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       hwloc-annotate [options] <input.xml> <output.xml> -- <location1>
       <location2> ... -- <mode> <annotation>

       hwloc-annotate [options] <input.xml> <output.xml> <location> <mode>
       <annotation>

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

<?><?><?><?><?><?><?><?> (OPTIONS)
       --ri      <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?> (info) <?><?><?><?><?> <?><?>
                 <?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
                 <?><?><?><?> <?><?><?><?>.  <?><?><?> <?><?><?><?><?>
                 <?><?><?> <?><?> <?><?><?><?> <<info>> <?><?><?><?><?><?><?>
                 <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?> info <?><?><?>
                 <?><?><?><?> <?><?><?><?><?><?> info <?><?><?><?><?> <?><?>
                 <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       --ci      <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
                 <?><?><?><?><?> <?><?><?> <?><?><?> <?><?>
                 <?><?><?><?><?><?><?><?><?><?><?>.  <?><?><?> <?><?> <?><?>
                 <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
                 <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?> mode <?><?><?><?> <?><?><?>
                 none <?><?><?><?><?> <?><?><?>.

       --cu      <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?> (userdata) <?><?><?><?><?> <?><?>
                 <?><?><?><?><?> <?><?><?>.  <?><?><?> <?><?> <?><?>
                 <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> mode
                 <?><?><?><?> <?><?><?> none <?><?><?><?><?> <?><?><?>.

       --cd      <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
                 (distances) <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>.
                 <?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
                 mode <?><?><?><?> <?><?><?> none <?><?><?><?><?> <?><?><?>.

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

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

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> hwloc-annotate <?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?> <?><?><?><?> XML <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> XML <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>.

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

       info <name> <value>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?> name <?>
              <?><?><?><?><?> <?><?> value <?><?><?>.

       subtype <subtype>
              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> (subtype) <?><?><?> <?><?><?><?><?>
              <?><?><?><?> subtype <?><?><?><?>.  <?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>.

       size <size>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> (cache)
              <?><?> <?><?><?> NUMA <?><?> <?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> kB<?> KiB<?> MB<?>
              MiB<?> GB<?> GiB <?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       misc <name>
              <?><?><?> <?><?> <?><?><?> Misc <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?>.

       memattr <name> <flags>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?> name <?>
              <?><?><?><?><?><?><?><?> <?><?> flags <?><?><?>.  <?><?>
              <?><?><?> <?><?><?><?> location <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
              hwloc_memattr_register() <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.  <?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> 1 (<?><?> higher) <?><?> <?><?><?> <?><?><?><?>
              <?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?>.

       memattr <name> <initiator> <value>
              <?><?><?><?><?> <?><?><?><?><?> (<?><?> <?><?><?> name) <?><?>
              <?><?> <?><?><?><?><?><?> initiator (<?><?><?> <?><?> CPU-set)
              <?><?><?><?> <?><?><?> NUMA <?><?><?> location <?><?><?>
              <?><?><?><?><?> value <?><?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> initiator <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>:
              Capacity<?> Locality<?> Bandwidth <?> Latency.  <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?>:

                  $ lstopo --memattrs -i input.xml


       cpukind <cpuset> <efficiency> <flags> [<infoname> <infovalue>]
              <?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              PU<?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> cpuset
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.
              <?><?> <?><?><?> <?><?><?><?> location <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?><?><?> efficiency <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> -1 <?><?><?><?>.

              <?><?><?><?><?> flags <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
              0 <?><?><?><?>.

              <?><?><?> infoname <?> infovalue <?><?><?><?> <?><?><?> <?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.

              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
              hwloc_cpukinds_register() <?><?><?><?><?><?> <?><?><?><?>.


       distances <filename> [<flags>]
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <filename> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
              <?><?><?><?> <?><?><?><?><?><?><?> flags (0 <?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?>) <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> hwloc_distances_set() <?><?><?><?><?><?>
              <?><?><?><?>.  <?><?> <?><?><?> <?><?><?><?> location
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> (kind) <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?> <?><?> hwloc/distances.h <?><?><?><?><?> <?><?><?>
              <?><?><?>.  <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?>.
              <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?>.  <?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
              <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?> x*y <?><?> x*y*z <?><?><?><?>
              <?><?><?>.  <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> name=
              <?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?>.


       distances-transform <name> links
              <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <name> <?><?>
              <?><?> <?><?><?><?><?><?><?> (links) <?><?><?><?><?>
              <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> HWLOC_DISTANCES_TRANSFORM_LINKS <?><?>
              <?><?> hwloc/distances.h <?><?><?><?><?><?>.

       distances-transform <name> merge-switch-ports
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> NVLinkBandwidth <?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              NVIDIA <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              HWLOC_DISTANCES_TRANSFORM_MERGE_SWITCH_PORTS <?><?> <?><?>
              hwloc/distances.h <?><?><?><?><?><?>.

       distances-transform <name> transitive-closure
              <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> (transitive-closure)
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?>.  <?><?><?> <?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              NVLinkBandwidth <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> NVIDIA <?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> GPU <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?> GPU<?><?> <?> <?><?><?><?><?><?><?><?><?>
              <?><?><?> NVSwitch.  <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>
              HWLOC_DISTANCES_TRANSFORM_TRANSITIVE_CLOSURE <?><?> <?><?>
              hwloc/distances.h <?><?><?><?><?><?>.

       distances-transform <name> remove-obj <obj>
              <?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
              <name> <?><?><?> <?><?><?><?><?><?>.

       distances-transform <name> replace-objs <oldtype> <newtype>
              <?><?><?><?><?> <?><?> <?><?><?> <oldtype> <?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
              <name> <?><?> <?><?><?><?><?> <?><?> <?><?><?> <newtype> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> (locality)
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?> <oldtype>
              <?><?> <newtype> <?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> "NVML" <?><?> "OpenCL".  <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              hwloc_get_obj_with_same_locality() <?><?> <?><?> hwloc/helper.h
              <?><?><?><?><?><?>.

              <?><?><?> <newtype> <?><?><?><?><?> <?><?> "NULL"
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>..TP
              none <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?>.

       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> (topology)<?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.  <?><?><?>
       <?><?><?><?> <?><?><?><?> location <?><?><?><?> <?><?><?><?><?><?>
       (<?><?><?> <<<?><?><?><?><?><?><?>>> <?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?>).  <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> --
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.
       <?><?><?><?><?><?><?><?> <?><?> <?><?> hwloc(7) <?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (location tuples)
       <?><?><?><?> <?><?><?>.  <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?>: <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> hwloc-info <?><?><?><?><?> <?><?><?>.

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

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

       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> info <?><?> <?><?><?><?>
       <?><?><?><?><?> Core <?> PU:

           $ hwloc-annotate input.xml output.xml -- Core:all PU:all -- info
       infoname infovalue

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

           $ hwloc-annotate input.xml output.xml Core:all info infoname
       infovalue

       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> info <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (OS
       device) <?><?><?><?><?> <?> <?> <?>:

           $ hwloc-annotate input.xml output.xml os:2-3 info infoname
       infovalue

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

           $ hwloc-annotate topo.xml topo.xml package:all info lstopoStyle
       "Background=#00ff00;Text=#ff0000"
           $ lstopo -i topo.xml

       <?><?><?><?><?><?> <?><?> <?><?><?> Misc <?><?> <?><?><?> <<foobar>>
       <?><?><?> <?><?><?> <?><?><?><?> (root) <?><?><?><?><?><?><?><?><?><?>
       <?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> XML
       <?><?><?><?><?>:

           $ hwloc-annotate file.xml file.xml root misc foobar


<?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       (Examples with memory attributes)
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> Latency <?><?>
       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> PU<?><?><?>
       <?><?><?><?><?><?> package <?><?> <?><?><?><?><?><?> <?><?><?> NUMA:

           $ hwloc-annotate topo.xml topo.xml numanode:0 memattr Latency
       $(hwloc-calc package:0) 123

       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       MyApplicationPerformance (<?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>) <?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       CPU-set <?><?> <?><?><?><?><?> 0x11 <?><?> <?><?><?> NUMA
       <?><?><?><?><?> <?> <?><?><?> <?><?><?><?>:

           $ hwloc-annotate topo.xml topo.xml ignored memattr
       MyApplicationPerformance need_init,higher
           $ hwloc-annotate topo.xml topo.xml numanode:2 memattr
       MyApplicationPerformance 0x11 2345

       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       NUMA <?><?><?><?><?> <?> <?><?> <?><?><?> DDR <?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?> NUMA <?><?><?><?><?> <?> <?><?> <?><?><?>
       HBM <?><?><?>:

           $ hwloc-annotate topo.xml topo.xml numa:0 subtype DDR
           $ hwloc-annotate topo.xml topo.xml numa:1 subtype HBM


<?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       (Examples with CPU kinds)
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> PU 0-3 <?> PU 4-7 <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?>:

           $ hwloc-annotate topo.xml topo.xml dummy cpukind 0x0f 0 0 CoreType
       Small
           $ hwloc-annotate topo.xml topo.xml dummy cpukind 0xf0 1 0 CoreType
       Big


       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> NUMA <?><?>
       Package<?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> NUMALatency<?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> (locality) <?><?><?><?><?><?>
       <?><?><?><?><?>:

           $ hwloc-annotate topo.xml topo.xml -- dummy -- distances-transform
       NUMALatency replace-objs numanode packages

       <?><?><?> <?><?><?> NUMA <?><?><?><?><?> <?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> NUMALatency:

           $ hwloc-annotate topo.xml topo.xml -- dummy -- distances-transform
       NUMALatency remove-obj numa:3

       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> NVSwitch <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> NVLinkBandwidth:

           $ hwloc-annotate topo.xml topo.xml -- dummy -- distances-transform
       NVLinkBandwidth merge-switch-ports

       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> (transitive
       closure) <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> GPU<?><?> <?><?> <?><?><?><?>
       NVSwitch<?><?> <?><?> <?><?><?><?><?><?> NVLinkBandwidth:

           $ hwloc-annotate topo.xml topo.xml -- dummy -- distances-transform
       NVLinkBandwidth transitive-closure


<?><?><?><?><?> <?><?><?><?><?><?><?> (RETURN VALUE)
       <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> hwloc-annotate
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?><?> <?><?><?><?><?><?><?> 0 <?><?><?>.

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

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       hwloc(7), lstopo(1), hwloc-info(1)


2.14.0                           June 8, 2026                HWLOC-ANNOTATE(1)