---
name: "PAPI_get_hardware_info"
section: "3"
platform: "linux"
package: "libpapi-dev"
version: "7.1.0-5+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/PAPI_get_hardware_info"
---

# PAPI\_get\_hardware\_info(3)

get information about the system hardware

## NAME

PAPI\_get\_hardware\_info - get information about the system hardware

## SYNOPSIS

## Detailed Description

In C, this function returns a pointer to a structure containing information about the hardware on which the program runs. In Fortran, the values of the structure are returned explicitly.

**Return values**

*PAPI\_EINVAL* One or more of the arguments is invalid.

**Note**

The C structure contains detailed information about cache and TLB sizes. This information is not available from Fortran.

**Examples:**

```
const PAPI_hw_info_t *hwinfo = NULL;
if (PAPI_library_init(PAPI_VER_CURRENT) != PAPI_VER_CURRENT)
exit(1);
if ((hwinfo = PAPI_get_hardware_info()) == NULL)
exit(1);
printf("%d CPUs at %f Mhz.\en",hwinfo->totalcpus,hwinfo->mhz);
```

**See also**

**PAPI\_hw\_info\_t**

**PAPI\_get\_executable\_info**, **PAPI\_get\_opt**, **PAPI\_get\_dmem\_info**, **PAPI\_library\_init**

## Author

Generated automatically by Doxygen for PAPI from the source code.