pcp-zoneinfo(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTES | PCP ENVIRONMENT | SEE ALSO | COLOPHON

PCP-ZONEINFO(1)          General Commands Manual         PCP-ZONEINFO(1)

NAME         top

       pcp-zoneinfo - Report statistics for System Zoneinfo.

SYNOPSIS         top

       pcp [pcp options] zoneinfo [-s samples] [-a archive] [-S
       start_time] [-T end_time] [-Z timezone]

DESCRIPTION         top

       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 file display
       information about memory zones.  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:

       HEADER                  DESCRIPTION
       _                       _

       Per node stats (for each zone for each NUMA node)

       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)

       pages free              free space
             min               min space
             low               low space
             high              high space
             spanned           spanned space
             present           present space
             managed           managed space
             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         top

       -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).

       -?, --help
              Display usage message and exit.

NOTES         top

       pcp-zoneinfo collects information from /proc/zoneinfo and aims to
       be command line and output compatible with it.

PCP ENVIRONMENT         top

       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).

       For environment variables affecting PCP tools, see
       pmGetOptions(3).

SEE ALSO         top

       PCPIntro(1), pcp(1), pmParseInterval(3) and environ(7).

COLOPHON         top

       This page is part of the PCP (Performance Co-Pilot) project.
       Information about the project can be found at 
       ⟨http://www.pcp.io/⟩.  If you have a bug report for this manual
       page, send it to pcp@groups.io.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/performancecopilot/pcp.git⟩ on 2023-12-22.
       (At that time, the date of the most recent commit that was found
       in the repository was 2023-12-16.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

Performance Co-Pilot               PCP                   PCP-ZONEINFO(1)