---
name: "hwloc_get_api_version"
section: "3"
platform: "linux"
package: "hwloc"
version: "2.15.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/hwlocality_api_version"
---

# hwloc\_get\_api\_version(3)

API version

Part of [hwlocality\_api\_version(3)](/hwlocality_api_version/3.md).

## NAME

hwlocality\_api\_version - API version

## SYNOPSIS

### Macros

\#define **HWLOC\_API\_VERSION**   0x00020c00\
 \#define **HWLOC\_COMPONENT\_ABI**   7\

### Functions

unsigned **hwloc\_get\_api\_version** (void)\

## Detailed Description

## Macro Definition Documentation

### #define HWLOC\_API\_VERSION 0x00020c00

Indicate at build time which hwloc API version is being used. This number is updated to (X\<\<16)+(Y\<\<8)+Z when a new release X.Y.Z actually modifies the API.

Users may check for available features at build time using this number (see **How do I handle API changes?**).

**Note**

This should not be confused with HWLOC\_VERSION, the library version. Two stable releases of the same series usually have the same **HWLOC\_API\_VERSION** even if their HWLOC\_VERSION are different.

### #define HWLOC\_COMPONENT\_ABI 7

Current component and plugin ABI version (see **hwloc/plugins.h**).

## Function Documentation

### unsigned hwloc\_get\_api\_version (void )

Indicate at runtime which hwloc API version was used at build time. Should be **HWLOC\_API\_VERSION** if running on the same version.

**Returns**

the build-time version number.

## Author

Generated automatically by Doxygen for Hardware Locality (hwloc) from the source code.