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)
| Option | Description | Source |
|---|---|---|
--objects | Report information about specific objects | help + man |
--topology | Report a summary of the topology instead of about some specific objects. | help + man |
--support | Report the features that are supported by hwloc on the topology. | help + man |
-v --verbose | Include additional details | help + man |
-q --quiet | Reduce the amount of details to show. | help + man |
--get-attr name | Only report the attribute of name <name> for each object (instead of all attributes). | help + man |
--ancestors | Display information about the object as well as about all its ancestors up to the root of the topology. | help + man |
--ancestor type | Only display the object ancestors that match the given type. | help + man |
--children | Display information about the object children. | help + man |
--descendants type | Display information about the object descendants that match the given type. | help + man |
--local-memory | Display information about the NUMA nodes that are local to the given object. | help + man |
--local-memory-flags x | Change the flags used to select local NUMA nodes. | help + man |
--default-nodes | Display information about the default NUMA nodes that are local to the given object. | help + man |
--first | For each input object, only report the first matching output object (first ancestor, first child, etc.). | help + man |
-n | When outputting object information, prefix each line with the index of the considered object within the input. | help + man |
--restrict nodeset=]<bitmap | Restrict the topology to some processors or NUMA nodes. | help + man |
--restrict-flags n | Enforce flags when restricting the topology. | help + man |
--no-icaches | Do not show Instruction caches, only Data and Unified caches are considered. | help + man |
--no-io | Do not show any I/O device or bridge. | help + man |
--no-bridges | Do not show any I/O bridge except hostbridges. | help + man |
--whole-io | Show all I/O devices and bridges. | help + man |
-i XML | Read the topology from <path> instead of discovering the topology of the local machine. | help + man |
--input directory | help | |
--input-format format | help | |
--if format | Enforce the input in the given format, among xml, fsroot, cpuid and synthetic. | help + man |
--thissystem | Assume that the selected backend provides the topology for the system on which we are running. | help + man |
--pid pid | Detect topology as seen by process <pid>, i.e. as if process <pid> did the discovery itself. | help + man |
--disallowed | Include objects disallowed by administrative limitations. | help + man |
-l --logical | Use logical indexes instead of physical/OS indexes for input (default). | help + man |
-p --physical | Use OS/physical indexes instead of logical indexes for input. | help + man |
--version | Report version and exit. | help + man |
-h --help | Display help message and exit. | help + man |
--best-memattr name | Enable 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>:<kind | Filter 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
hwloc-info package:all Package L#0 logical index = 0 ...
To display information about each package:hwloc-info -p core:2 Core L#1 logical index = 1 os index = 2 ...
To display information about the core whose physical index is 2:hwloc-info -s "os[OpenCL]:all" CoProc:6 CoProc:8
To list the OS devices that are of subtype OpenCL:hwloc-info --ancestor PCI --get-attr "attr PCI bus id" 'os[opencl]:all' 0000:05:00.0 0000:42:00.0
To find the PCI bus ID of PCI devices containing OpenCL devices:hwloc-info --local-memory pu:25 NUMANode L#6 = local memory #0 of PU L#25 type = NUMANode ... NUMANode L#7 = local memory #1 of PU L#25 type = NUMANode ...
To list the NUMA nodes that are local a PU:hwloc-info --local-memory --best-memattr bandwidth pu:25 NUMANode L#7 = local memory #1 of PU L#25 type = NUMANode ...
To show the best-bandwidth node(s) among NUMA nodes local to a PU:hwloc-info --ancestor kind=normal --first -s numa:1 Package:0
to find where a NUMA node is attached in the hierarchy of CPU cores: