---
name: "pcp-zoneinfo"
section: "1"
platform: "linux"
package: "pcp"
version: "7.2.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pcp-zoneinfo"
---

# pcp-zoneinfo(1)

Report NUMA zone statistics

## NAME

**pcp-zoneinfo** - Report NUMA zone statistics

## SYNOPSIS

**pcp** \[*pcp options*\] **zoneinfo** \[**-Vz?**\] \[**-s** *samples*\] \[**-a** *archive*\] \[**-S** *start\_time*\] \[**-T** *end\_time*\] \[**-Z** *timezone*\]

## DESCRIPTION

The **pcp-zoneinfo** command is used for viewing the different kinds of stats related to NUMA nodes. Using various options it helps a user to analyze useful information related to the zone availability for different NUMA nodes. This is useful for analyzing virtual memory behavior. By default **pcp-zoneinfo** reports live data for the local host.

The statistics shown are as follows:

| | |
| --- | --- |
| **Per node stats (for each NUMA node)** |
| **HEADER** | **DESCRIPTION** |
| nr\_inactive\_anon | zone inactive anonymous pages |
| nr\_active\_anon | active anonymous memory pages |
| nr\_inactive\_file | inactive file memory pages |
| nr\_active\_file | active file memory memory pages |
| nr\_unevictable | unevictable pages |
| nr\_slab\_reclaimable | reclaimable slab pages |
| nr\_slab\_unreclaimable | unreclaimable slab pages |
| nr\_isolated\_anon | isolated anonymous memory pages |
| nr\_isolated\_file | isolated file memory pages |
| nr\_anon\_pages | anonymous mapped pagecache pages |
| nr\_mapped | mapped pagecache pages |
| nr\_file\_pages | file pagecache pages |
| nr\_dirty | pages dirty state |
| nr\_writeback | pages writeback state |
| nr\_writeback\_temp | temporary writeback pages |
| nr\_shmem | shared memory pages |
| nr\_shmem\_hugepages | shared memory huge pages |
| nr\_shmem\_pmdmapped | shared memory PMD mappings |
| nr\_file\_hugepages | file-backed huge pages |
| nr\_file\_pmdmapped | file-backed PMD mappings |
| nr\_anon\_transparent\_hugepages | anonymous transparent huge pages |
| nr\_unstable | pages in unstable state in each zone |
| nr\_vmscan\_write | pages written from the LRU by the VM scanner The VM is supposed to minimise the number of pages which get written from the LRU (for IO scheduling efficiency and reclaim success). |
| nr\_vmscan\_immediate\_reclaim | prioritise for reclaim when writeback ends |
| nr\_dirtied | pages entering dirty state |
| nr\_written | pages written out in each zone |
| nr\_kernel\_misc\_reclaimable | miscellaneous reclaimable kernel pages |

| | |
| --- | --- |
| **Per zone stats (in each zone for each NUMA node)** |
| **HEADER** | **DESCRIPTION** |
| pages free | free space |
| pages min | min space |
| pages low | low space |
| pages high | high space |
| pages spanned | spanned space |
| pages present | present space |
| pages managed | managed space |
| pages protection | protection space |
| nr\_free\_pages | number of free pages |
| nr\_zone\_inactive\_anon | zone inactive anonymous pages |
| nr\_zone\_active\_anon | zone active anonymous pages |
| nr\_zone\_inactive\_file | zone inactive file-backed pages |
| nr\_zone\_active\_file | zone active file-backed pages |
| nr\_zone\_unevictable | zone unevictable pages |
| nr\_zone\_write\_pending | zone write-pending pages |
| nr\_mlock | pages under mlock |
| nr\_page\_table\_pages | page table pages |
| nr\_kernel\_stack | pages of kernel stack |
| nr\_bounce | bounce buffer pages |
| nr\_zspages | zsmalloc memory allocator pages |
| nr\_free\_cma | free Contiguous Memory Allocator pages |
| numa\_hit | successful allocations from preferred NUMA zone |
| numa\_miss | unsuccessful allocations from preferred NUMA zone |
| numa\_foreign | foreign NUMA zone allocations |
| numa\_interleave | interleaved NUMA allocations |
| numa\_local | successful allocations from local NUMA zone |
| numa\_other | unsuccessful allocations from local NUMA zone |

## OPTIONS

- **-a** *file*, **--archive**=*file*

  Fetch /proc/zoneinfo for a specified archive *file*

- **-s** *count*, **--samples**=*count*

  Get the zoneinfo statistics for specified number of samples *count*

- **-S**, **--start**=*time*

  Filter the samples from the archive from the given *time*

- **-T**, **--finish=time**

  Filter the samples from the archive until the given *time*

- **-V**, **--version**

  Display version number and exit.

- **-z**, **--hostzone**

  Use the local timezone of the host that is the source of the performance metrics, as identified by either the **-h** or the **-a** options. The default is to use the timezone of the local host.

- **-Z** *timezone*, **--timezone**=*timezone*

  Use *timezone* for the date and time. *Timezone* is in the format of the environment variable **TZ** as described in [**environ**(7)](/environ/7.md).

- **-?**, **--help**

  Display usage message and exit.

## NOTES

**pcp-zoneinfo** collects information from */proc/zoneinfo*.

## PCP ENVIRONMENT

Environment variables with the prefix **PCP\_** are used to parameterize the file and directory names used by PCP. On each installation, the file */etc/pcp.conf* contains the local values for these variables. The **$PCP\_CONF** variable may be used to specify an alternative configuration file, as described in [**pcp.conf**(5)](/pcp.conf/5.md).

For environment variables affecting PCP tools, see [**pmGetOptions**(3)](/pmGetOptions/3.md).

## SEE ALSO

[**PCPIntro**(1)](/PCPIntro/1.md), [**pcp**(1)](/pcp/1.md), [**pmParseInterval**(3)](/pmParseInterval/3.md) and [**environ**(7)](/environ/7.md).