OS Manuals

/usr/bin/hwloc-info

Portable abstraction of hierarchical hardware architectures with CUDA support

From hwloc-cuda-12.8 2.15.0-r1 (enterprise-packages), captured 2026-11-09 by running hwloc-info --help (exit 0). permalink

Usage: hwloc-info [ options ] [ object | root | levels | topology | support ... ]

Output options:
  --objects             Report information about specific objects
  --topology            Report information the topology
  --support             Report information about supported features
  -v --verbose          Include additional details
  -q --quiet -s         Reduce the amount of details to show
  --get-attr <name>     Only show the attribute line with name <name>
  --ancestors           Display the chain of ancestor objects up to the root
  --ancestor <type>     Only display the ancestor of the given type
  --children            Display all children
  --descendants <type>  Only display descendants of the given type
  --local-memory        Only display the local memory nodes
  --local-memory-flags <x>   Change flags for selecting local memory nodes
  --best-memattr <attr> Only display the best target among the local nodes
  --default-nodes       Only display the default local nodes
  --first               Only report the first matching object
  -n                    Prefix each line with the index of the considered object
Object filtering options:
  --restrict [nodeset=]<bitmap>
                        Restrict the topology to some processors or NUMA nodes.
  --restrict binding    Restrict the topology to the current process binding
  --restrict-flags <n>  Set the flags to be used during restrict
  --filter <type>:<knd> Filter objects of the given type, or all.
     <knd> may be `all' (keep all), `none' (remove all), `structure' or `important'
  --no-icaches          Do not show instruction caches
  --no-io               Do not show any I/O device or bridge
  --no-bridges          Do not any I/O bridge except hostbridges
  --whole-io            Show all I/O devices and bridges
Input options:
  --input <XML file>
  -i <XML file>         Read topology from XML file <path>
  --input <directory>
  -i <directory>        Read topology from chroot containing the /proc and /sys
                        of another system
  --input <directory>
  -i <directory>        Read topology from directory containing a CPUID dump
  --input "node:2 2"
  -i "node:2 2"         Simulate a fake hierarchy, here with 2 NUMA nodes of 2
                        processors
  --input-format <format>
  --if <format>         Enforce input format among xml, fsroot, cpuid, synthetic
  --thissystem          Assume that the input topology provides the topology
                        for the system on which we are running
  --pid <pid>           Detect topology as seen by process <pid>
  --disallowed          Include objects disallowed by administrative limitations
  -l --logical          Use logical object indexes for input (default)
  -p --physical         Use physical object indexes for input
Miscellaneous options:
  --version             Report version and exit
  -h --help             Show this usage
Options (34)
OptionDescriptionSource
--objectsReport information about specific objectshelp + man
--topologyReport a summary of the topology instead of about some specific objects.help + man
--supportReport the features that are supported by hwloc on the topology.help + man
-v --verboseInclude additional detailshelp + man
-q --quietReduce the amount of details to show.help + man
--get-attr nameOnly report the attribute of name <name> for each object (instead of all attributes).help + man
--ancestorsDisplay information about the object as well as about all its ancestors up to the root of the topology.help + man
--ancestor typeOnly display the object ancestors that match the given type.help + man
--childrenDisplay information about the object children.help + man
--descendants typeDisplay information about the object descendants that match the given type.help + man
--local-memoryDisplay information about the NUMA nodes that are local to the given object.help + man
--local-memory-flags xChange the flags used to select local NUMA nodes.help + man
--default-nodesDisplay information about the default NUMA nodes that are local to the given object.help + man
--firstFor each input object, only report the first matching output object (first ancestor, first child, etc.).help + man
-nWhen outputting object information, prefix each line with the index of the considered object within the input.help + man
--restrict nodeset=]<bitmapRestrict the topology to some processors or NUMA nodes.help + man
--restrict-flags nEnforce flags when restricting the topology.help + man
--no-icachesDo not show Instruction caches, only Data and Unified caches are considered.help + man
--no-ioDo not show any I/O device or bridge.help + man
--no-bridgesDo not show any I/O bridge except hostbridges.help + man
--whole-ioShow all I/O devices and bridges.help + man
-i XMLRead the topology from <path> instead of discovering the topology of the local machine.help + man
--input directoryhelp
--input-format formathelp
--if formatEnforce the input in the given format, among xml, fsroot, cpuid and synthetic.help + man
--thissystemAssume that the selected backend provides the topology for the system on which we are running.help + man
--pid pidDetect topology as seen by process <pid>, i.e. as if process <pid> did the discovery itself.help + man
--disallowedInclude objects disallowed by administrative limitations.help + man
-l --logicalUse logical indexes instead of physical/OS indexes for input (default).help + man
-p --physicalUse OS/physical indexes instead of logical indexes for input.help + man
--versionReport version and exit.help + man
-h --helpDisplay help message and exit.help + man
--best-memattr nameEnable the listing of local memory nodes with --local-memory, but only display the local nodes that have the best value for the memory attribute given by <name> (or as an index). (in the manual page but not in --help)man
--filter, --filter type>:<kindFilter objects of type <type>, or of any type if <type> is "all". (in the manual page but not in --help)man
Examples (7) from the manual page, untested

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.