macOS
Homebrewverified · 100%
brew install hwloclocal Homebrew formula metadata
MacPortsverified · 94%
sudo port install hwlocMacPorts ports tree · devel/hwloc/Portfile · source: api.github.com
brew / rank 312
Install hwloc with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper
Portable abstraction of the hierarchical topology of modern architectures. Version 2.14.0 via Homebrew; verified 2026-07-14. Also installable with debian: sudo apt install hwloc.
install
Additional install commands
Linux
Alpine Linux apkverified · 92%
sudo apk add hwlocAlpine Linux edge package indexes · hwloc · source: dl-cdn.alpinelinux.org
Debian aptverified · 92%
sudo apt install hwlocDebian stable package indexes · hwloc · source: deb.debian.org
Fedora dnfverified · 92%
sudo dnf install hwlocFedora Rawhide package metadata · hwloc · source: dl.fedoraproject.org
Nixverified · 92%
nix profile install nixpkgs#hwlocnixpkgs package indexes · pkgs/by-name/hw/hwloc/package.nix · source: api.github.com
Arch Linux pacmanverified · 92%
sudo pacman -S hwlocArch Linux sync databases · hwloc · source: geo.mirror.pkgbuild.com
openSUSE zypperverified · 92%
sudo zypper install hwlocopenSUSE Tumbleweed package metadata · hwloc · source: download.opensuse.org
overview
Package summary
Portable abstraction of the hierarchical topology of modern architectures
Project links
Commands and aliases
- hwloc-annotate
- hwloc-bind
- hwloc-calc
- hwloc-compress-dir
- hwloc-diff
- hwloc-distrib
- hwloc-gather-topology
- hwloc-info
- hwloc-ls
- hwloc-patch
- hwloc-ps
- lstopo
- lstopo-no-graphics
history
Project history and usage
hwloc, Hardware Locality, is a portable library and command-line tool suite for discovering and using machine topology: NUMA nodes, packages, cores, processing units, caches, I/O devices, and locality relationships. It is a system and HPC building block rather than a single end-user command.
Project history
The Open MPI project history says hwloc evolved from and merged the libtopology and Portable Linux Processor Affinity projects because they overlapped functionally and ideologically. It was released under the hwloc name as an Open MPI sub-project and is mostly developed by the TADaaM team at Inria in Bordeaux.
The NEWS file covers features since version 0.9 and carries 2009 copyright notices for CNRS, Inria, Universite Bordeaux, and Cisco Systems. The 1.0.0 tag dates to May 2010. Later major lines expanded the API and the command-line suite while preserving the central promise: make topology discovery and binding portable across operating systems and hardware generations.
Adoption history
Open MPI's project page lists downstream or related users including MPC, Newmadeleine, StarPU, Kokkos, oneTBB, memkind, H2M, Seastar, PaStiX, LIKWID, TensorFlow, GEOPM, and OpenPMIx. The package metadata shows broad distribution across Homebrew, Debian, Ubuntu, Fedora-family, Alpine, Arch, Nix, MacPorts, and openSUSE ecosystems.
How it is used
Users run tools such as `lstopo`, `hwloc-info`, `hwloc-bind`, `hwloc-calc`, and related utilities to inspect topology, bind processes, calculate CPU or NUMA sets, export XML topologies, and debug locality issues. Developers use the C API to make runtime, scheduler, MPI, database, and performance tools topology-aware.
Why package nerds care
hwloc is package-nerd-significant because it is often pulled in indirectly by high-performance and systems software. A package manager may present it as a small system formula, but it encodes hard-won portability across Linux, BSDs, macOS, Windows, Solaris, AIX, cpusets, NUMA, caches, GPUs, and other topology surfaces.
Timeline
- 2009: NEWS history begins at version 0.9, with CNRS, Inria, Universite Bordeaux, and Cisco copyright notices.
- 2010: 1.0.0 release tag published.
- 2013: GitHub mirror/repository metadata begins for the Open MPI hwloc repo.
- 2018: 2.0.x line introduced a new major API era; 2.0.0 was marked as having a broken ABI, with 2.0.1 or later recommended.
- 2026: NEWS documents 3.0.0 API changes, removals, and topology-info updates.
Related projects
- hwloc is historically related to libtopology and PLPA, and operationally related to Open MPI, PMIx, NUMA libraries, CPU binding APIs, StarPU, Kokkos, oneTBB, memkind, TensorFlow, and other software that needs hardware-locality knowledge.
Sources
- Open MPI hwloc project history, README, NEWS, release archives, repository metadata, and Homebrew package metadata were used.
security posture
Risk level: blue
broad file, network, media, or database tool signal.
Risk classifier
blue risk · medium confidence · tool
Why
- broad file, network, media, or database tool signal
Signals
- text:compress
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
hwloc-annotate | executable | indexed executable | Discovered from the local executable index. |
hwloc-bind | executable | indexed executable | Discovered from the local executable index. |
hwloc-calc | executable | indexed executable | Discovered from the local executable index. |
hwloc-compress-dir | executable | indexed executable | Discovered from the local executable index. |
hwloc-diff | executable | indexed executable | Discovered from the local executable index. |
hwloc-distrib | executable | indexed executable | Discovered from the local executable index. |
hwloc-gather-topology | executable | indexed executable | Discovered from the local executable index. |
hwloc-info | executable | indexed executable | Discovered from the local executable index. |
hwloc-ls | executable | indexed executable | Discovered from the local executable index. |
hwloc-patch | executable | indexed executable | Discovered from the local executable index. |
hwloc-ps | executable | indexed executable | Discovered from the local executable index. |
lstopo | executable | indexed executable | Discovered from the local executable index. |
lstopo-no-graphics | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version2.14.0
manager updated2026-07-14
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:hwloc |
|---|---|
| Version | 2.14.0 |
| Package manager | Homebrew |
| Homepage | https://www.open-mpi.org/projects/hwloc/ |
| Repository | https://github.com/open-mpi/hwloc |
| Last updated | 2026-07-14T16:33:15Z |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Debian apt95%
hwloc 2.12.0-4
Hierarchical view of the machine - utilities
https://www.open-mpi.org/projects/hwloc/
sudo apt install hwloc- Section: admin
- Architecture: amd64
- 5 dependencies
- normalized package name match
- Matched by: Hwloc
Debian apt95%
hwloc-nox 2.12.0-4
Hierarchical view of the machine - non-X version of utilities
https://www.open-mpi.org/projects/hwloc/
sudo apt install hwloc-nox- Section: admin
- Architecture: amd64
- Source Package: hwloc
- 3 dependencies
- normalized package name match
- Matched by: Hwloc
Debian apt95%
libhwloc-common 2.12.0-4
Hierarchical view of the machine - common files
https://www.open-mpi.org/projects/hwloc/
sudo apt install libhwloc-common- Section: libs
- Architecture: all
- Source Package: hwloc
- normalized package name match
- Matched by: Hwloc
Debian apt95%
libhwloc-dev 2.12.0-4
Hierarchical view of the machine - static libs and headers
https://www.open-mpi.org/projects/hwloc/
sudo apt install libhwloc-dev- Section: libdevel
- Architecture: amd64
- Source Package: hwloc
- 3 dependencies
- normalized package name match
- Matched by: Hwloc
Debian apt95%
libhwloc-doc 2.12.0-4
Hierarchical view of the machine - documentation
https://www.open-mpi.org/projects/hwloc/
sudo apt install libhwloc-doc- Section: doc
- Architecture: all
- Source Package: hwloc
- 1 dependencies
- normalized package name match
- Matched by: Hwloc
Debian apt95%
libhwloc-plugins 2.12.0-4
Hierarchical view of the machine - plugins
https://www.open-mpi.org/projects/hwloc/
sudo apt install libhwloc-plugins- Section: libs
- Architecture: amd64
- Source Package: hwloc
- 9 dependencies
- normalized package name match
- Matched by: Hwloc
Debian apt95%
libhwloc15 2.12.0-4
Hierarchical view of the machine - shared libs
https://www.open-mpi.org/projects/hwloc/
sudo apt install libhwloc15- Section: libs
- Architecture: amd64
- Source Package: hwloc
- 2 dependencies
- 2 optional deps
- normalized package name match
- Matched by: Hwloc
Nix95%
hwloc
nix profile install nixpkgs#hwloc- normalized package name match
- Matched by: Hwloc
Ubuntu apt95%
hwloc 2.10.0-1build1
Hierarchical view of the machine - utilities
https://www.open-mpi.org/projects/hwloc/
sudo apt install hwloc- Section: universe/admin
- Architecture: amd64
- 5 dependencies
- normalized package name match
- Matched by: Hwloc
Ubuntu apt95%
hwloc-nox 2.10.0-1build1
Hierarchical view of the machine - non-X version of utilities
https://www.open-mpi.org/projects/hwloc/
sudo apt install hwloc-nox- Section: universe/admin
- Architecture: amd64
- Source Package: hwloc
- 3 dependencies
- normalized package name match
- Matched by: Hwloc
Ubuntu apt95%
libhwloc-common 2.10.0-1build1
Hierarchical view of the machine - common files
https://www.open-mpi.org/projects/hwloc/
sudo apt install libhwloc-common- Section: universe/libs
- Architecture: all
- Source Package: hwloc
- normalized package name match
- Matched by: Hwloc
Ubuntu apt95%
libhwloc-dev 2.10.0-1build1
Hierarchical view of the machine - static libs and headers
https://www.open-mpi.org/projects/hwloc/
sudo apt install libhwloc-dev- Section: universe/libdevel
- Architecture: amd64
- Source Package: hwloc
- 3 dependencies
- normalized package name match
- Matched by: Hwloc
Ubuntu apt95%
libhwloc-doc 2.10.0-1build1
Hierarchical view of the machine - documentation
https://www.open-mpi.org/projects/hwloc/
sudo apt install libhwloc-doc- Section: universe/doc
- Architecture: all
- Source Package: hwloc
- 1 dependencies
- normalized package name match
- Matched by: Hwloc
Ubuntu apt95%
libhwloc-plugins 2.10.0-1build1
Hierarchical view of the machine - plugins
https://www.open-mpi.org/projects/hwloc/
sudo apt install libhwloc-plugins- Section: universe/libs
- Architecture: amd64
- Source Package: hwloc
- 8 dependencies
- normalized package name match
- Matched by: Hwloc
Ubuntu apt95%
libhwloc15 2.10.0-1build1
Hierarchical view of the machine - shared libs
https://www.open-mpi.org/projects/hwloc/
sudo apt install libhwloc15- Section: universe/libs
- Architecture: amd64
- Source Package: hwloc
- 2 dependencies
- 2 optional deps
- normalized package name match
- Matched by: Hwloc
apk95%
hwloc 2.12.2-r0
Portable abstraction of hierarchical hardware architectures
sudo apk add hwloc- License: BSD-3-Clause
- Architecture: x86_64
- Source Package: hwloc
- 1 dependencies
- 1 provides
- normalized package name match
- Matched by: Hwloc
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- cross-ecosystem install command graph
- curated package history
- external package-manager database matches
- pkg.so package database
- pkgdb category and tag curation