hwloc-gather-topology (1) - Linux Man Pages
hwloc-gather-topology: Saves the relevant Linux topology files
NAMEhwloc-gather-topology - Saves the relevant Linux topology files and the lstopo output for later (possibly offline) usage
SYNOPSIShwloc-gather-topology [options] <path>
- Also gather I/O related files. The gathering may be much slower, and the generated archive may be much bigger. --dmi Also gather DMI/SMBIOS related files. The gathering requires root access, and the dmi-sysfs kernel module should be loaded.
- -h --help
- Display help message and exit
DESCRIPTIONhwloc-gather-topology saves all the relevant topology files into an archive (<path>.tar.bz2) and the lstopo output (<path>.output). The utility for example stores the /proc/cpuinfo file and the entire /sys/devices/system/node/ directory tree.
These files can be used later to explore the machine topology offline. Once the tarball has been extracted, it may for instance be given to some hwloc command-line utilities through their --input option. It is also possible to override the default topology that the hwloc library will read by setting the extracted path in the HWLOC_FSROOT environment variable.
Both archive and lstopo output may also be submitted to hwloc developers to debug issues remotely.
hwloc-gather-topology is a Linux specific tool, it is not installed on other operating systems.
NOTE: It is highly recommended that you read the hwloc(7) overview page before reading this man page.
To store topology information to be used later (possibly on a different host) please run:
It will store all relevant topology files in the /tmp/myhost.tar.bz2 archive and the lstopo output in the /tmp/myhost.output file. These files can be transferred on another host for later/offline analysis and/or as the input to various hwloc utilities.
To use these data with hwloc utilities you have to unpack myhost.tar.bz2 archive first:
A new directory named myhost now contains all topology files. Then you ask various hwloc utilities to use this topology instead of the one of the real machine by passing --input myhost. To display the topology just run:
It is not necessary that the topology is extracted in the current directory, absolute or relative paths are also supported:
To see how hwloc would distribute 8 parallel jobs on the original host:
To get the corresponding physical indexes in the previous command:
Any program may actually override the default topology with a given archived one even if it does not have a --input option. The HWLOC_FSROOT environment variable should be used to do so: