Automic VaultAutomic Vault

brew

Install hwloc with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper

Portable abstraction of the hierarchical topology of modern architectures. Version 2.13.0 via Homebrew; verified from local package data.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install hwloc

local Homebrew formula metadata

MacPortsverified · 94%
sudo port install hwloc

MacPorts ports tree · devel/hwloc/Portfile · source: api.github.com

Linux

Alpine Linux apkverified · 92%
sudo apk add hwloc

Alpine Linux edge package indexes · hwloc · source: dl-cdn.alpinelinux.org

Debian aptverified · 92%
sudo apt install hwloc

Debian stable package indexes · hwloc · source: deb.debian.org

Fedora dnfverified · 92%
sudo dnf install hwloc

Fedora Rawhide package metadata · hwloc · source: dl.fedoraproject.org

Nixverified · 92%
nix profile install nixpkgs#hwloc

nixpkgs package indexes · pkgs/by-name/hw/hwloc/package.nix · source: api.github.com

Arch Linux pacmanverified · 92%
sudo pacman -S hwloc

Arch Linux sync databases · hwloc · source: geo.mirror.pkgbuild.com

openSUSE zypperverified · 92%
sudo zypper install hwloc

openSUSE Tumbleweed package metadata · hwloc · source: download.opensuse.org

overview

Package summary

Portable abstraction of the hierarchical topology of modern architectures

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 post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 6 platform targets.
  • Build metadata lists 1 build dependencies.

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

CommandKindExposureNote
hwloc-annotatecliglobal executable
hwloc-bindcliglobal executable
hwloc-calccliglobal executable
hwloc-compress-dircliglobal executable
hwloc-diffcliglobal executable
hwloc-distribcliglobal executable
hwloc-gather-topologycliglobal executable
hwloc-infocliglobal executable
hwloc-lscliglobal executable
hwloc-patchcliglobal executable
hwloc-pscliglobal executable
lstopocliglobal executable
lstopo-no-graphicscliglobal executable

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-07-08
manager version2.13.0
manager updated
local dataok
upstreamnot checked
latest detectednot detected

https://www.open-mpi.org/projects/hwloc/

install metadata

Package metadata

Package keybrew:hwloc
Version2.13.0
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/hwloc
Homepagehttps://www.open-mpi.org/projects/hwloc/
Repositoryhttps://github.com/open-mpi/hwloc
Upstream docshttps://www.open-mpi.org/projects/hwloc
LicenseBSD-3-Clause
Source archivehttps://download.open-mpi.org/release/hwloc/v2.13/hwloc-2.13.0.tar.bz2
Build dependenciespkgconf
Uses from macOSlibxml2, ncurses
Bottleavailable (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Namehwloc
Version Scheme0
Revision0
Head VersionHEAD
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • head
  • stable

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 stable package indexes · deb.debian.org · Debian stable package indexes: hwloc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
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 stable package indexes · deb.debian.org · Debian stable package indexes: hwloc-nox from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
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 stable package indexes · deb.debian.org · Debian stable package indexes: libhwloc-common from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
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 stable package indexes · deb.debian.org · Debian stable package indexes: libhwloc-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
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 stable package indexes · deb.debian.org · Debian stable package indexes: libhwloc-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
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 stable package indexes · deb.debian.org · Debian stable package indexes: libhwloc-plugins from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
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
Debian stable package indexes · deb.debian.org · Debian stable package indexes: libhwloc15 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Nix95%

hwloc

nix profile install nixpkgs#hwloc
  • normalized package name match
  • Matched by: Hwloc
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/hw/hwloc/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
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 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: hwloc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
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 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: hwloc-nox from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
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 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: libhwloc-common from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
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 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: libhwloc-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
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 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: libhwloc-doc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
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 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: libhwloc-plugins from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
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
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: libhwloc15 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
apk95%

hwloc 2.12.2-r0

Portable abstraction of hierarchical hardware architectures

https://www.open-mpi.org/

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
Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: hwloc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Related tools

  • pkgconfBuild dependency declared by Homebrew.
  • chapelPopular package that depends on this formula.
  • mpichPopular package that depends on this formula.
  • nwchemPopular package that depends on this formula.
  • open-mpiPopular package that depends on this formula.
  • pmixPopular package that depends on this formula.
  • poclPopular package that depends on this formula.

Same workflow

  • libcpuidShares av.db curated category or tags: cli, hardware, library, system.
  • lsusbShares av.db curated category or tags: cli, hardware, system.
  • augeasShares av.db curated category or tags: cli, library, system.
  • cymeShares av.db curated category or tags: cli, hardware, system.
  • dcledShares av.db curated category or tags: cli, hardware, system.
  • digitempShares av.db curated category or tags: cli, hardware, system.

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.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment