2015-06-20 03:13:02 +05:30
|
|
|
/*
|
2023-02-08 11:30:00 +05:30
|
|
|
* vmstat.h - virtual memory related declarations for libproc2
|
2015-06-20 03:13:02 +05:30
|
|
|
*
|
2023-02-08 11:30:00 +05:30
|
|
|
* Copyright © 2015-2023 Jim Warner <james.warner@comcast.net>
|
2023-02-07 15:39:48 +05:30
|
|
|
* Copyright © 2015-2023 Craig Small <csmall@dropbear.xyz>
|
2015-06-20 03:13:02 +05:30
|
|
|
*
|
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
|
|
|
*
|
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
|
* Lesser General Public License for more details.
|
|
|
|
|
*
|
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
|
|
|
* License along with this library; if not, write to the Free Software
|
|
|
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
|
|
|
*/
|
2016-09-28 20:40:10 +05:30
|
|
|
#ifndef PROCPS_VMSTAT_H
|
|
|
|
|
#define PROCPS_VMSTAT_H
|
2015-06-20 03:13:02 +05:30
|
|
|
|
2018-04-06 10:30:00 +05:30
|
|
|
#ifdef __cplusplus
|
|
|
|
|
extern "C" {
|
|
|
|
|
#endif
|
2015-06-20 03:13:02 +05:30
|
|
|
|
|
|
|
|
enum vmstat_item {
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_noop, // ( never altered )
|
|
|
|
|
VMSTAT_extra, // ( reset to zero )
|
|
|
|
|
// returns origin, see proc(5)
|
|
|
|
|
// ------- -------------------
|
|
|
|
|
VMSTAT_ALLOCSTALL_DMA, // ul_int /proc/vmstat
|
|
|
|
|
VMSTAT_ALLOCSTALL_DMA32, // ul_int "
|
|
|
|
|
VMSTAT_ALLOCSTALL_HIGH, // ul_int "
|
|
|
|
|
VMSTAT_ALLOCSTALL_MOVABLE, // ul_int "
|
|
|
|
|
VMSTAT_ALLOCSTALL_NORMAL, // ul_int "
|
|
|
|
|
VMSTAT_BALLOON_DEFLATE, // ul_int "
|
|
|
|
|
VMSTAT_BALLOON_INFLATE, // ul_int "
|
|
|
|
|
VMSTAT_BALLOON_MIGRATE, // ul_int "
|
|
|
|
|
VMSTAT_COMPACT_DAEMON_FREE_SCANNED, // ul_int "
|
|
|
|
|
VMSTAT_COMPACT_DAEMON_MIGRATE_SCANNED, // ul_int "
|
|
|
|
|
VMSTAT_COMPACT_DAEMON_WAKE, // ul_int "
|
|
|
|
|
VMSTAT_COMPACT_FAIL, // ul_int "
|
|
|
|
|
VMSTAT_COMPACT_FREE_SCANNED, // ul_int "
|
|
|
|
|
VMSTAT_COMPACT_ISOLATED, // ul_int "
|
|
|
|
|
VMSTAT_COMPACT_MIGRATE_SCANNED, // ul_int "
|
|
|
|
|
VMSTAT_COMPACT_STALL, // ul_int "
|
|
|
|
|
VMSTAT_COMPACT_SUCCESS, // ul_int "
|
|
|
|
|
VMSTAT_DROP_PAGECACHE, // ul_int "
|
|
|
|
|
VMSTAT_DROP_SLAB, // ul_int "
|
|
|
|
|
VMSTAT_HTLB_BUDDY_ALLOC_FAIL, // ul_int "
|
|
|
|
|
VMSTAT_HTLB_BUDDY_ALLOC_SUCCESS, // ul_int "
|
|
|
|
|
VMSTAT_KSWAPD_HIGH_WMARK_HIT_QUICKLY, // ul_int "
|
|
|
|
|
VMSTAT_KSWAPD_INODESTEAL, // ul_int "
|
|
|
|
|
VMSTAT_KSWAPD_LOW_WMARK_HIT_QUICKLY, // ul_int "
|
|
|
|
|
VMSTAT_NR_ACTIVE_ANON, // ul_int "
|
|
|
|
|
VMSTAT_NR_ACTIVE_FILE, // ul_int "
|
|
|
|
|
VMSTAT_NR_ANON_PAGES, // ul_int "
|
|
|
|
|
VMSTAT_NR_ANON_TRANSPARENT_HUGEPAGES, // ul_int "
|
|
|
|
|
VMSTAT_NR_BOUNCE, // ul_int "
|
|
|
|
|
VMSTAT_NR_DIRTIED, // ul_int "
|
|
|
|
|
VMSTAT_NR_DIRTY, // ul_int "
|
|
|
|
|
VMSTAT_NR_DIRTY_BACKGROUND_THRESHOLD, // ul_int "
|
|
|
|
|
VMSTAT_NR_DIRTY_THRESHOLD, // ul_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_NR_FILE_HUGEPAGES, // ul_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_NR_FILE_PAGES, // ul_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_NR_FILE_PMDMAPPED, // ul_int "
|
|
|
|
|
VMSTAT_NR_FOLL_PIN_ACQUIRED, // ul_int "
|
|
|
|
|
VMSTAT_NR_FOLL_PIN_RELEASED, // ul_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_NR_FREE_CMA, // ul_int "
|
|
|
|
|
VMSTAT_NR_FREE_PAGES, // ul_int "
|
|
|
|
|
VMSTAT_NR_INACTIVE_ANON, // ul_int "
|
|
|
|
|
VMSTAT_NR_INACTIVE_FILE, // ul_int "
|
|
|
|
|
VMSTAT_NR_ISOLATED_ANON, // ul_int "
|
|
|
|
|
VMSTAT_NR_ISOLATED_FILE, // ul_int "
|
|
|
|
|
VMSTAT_NR_KERNEL_MISC_RECLAIMABLE, // ul_int "
|
|
|
|
|
VMSTAT_NR_KERNEL_STACK, // ul_int "
|
|
|
|
|
VMSTAT_NR_MAPPED, // ul_int "
|
|
|
|
|
VMSTAT_NR_MLOCK, // ul_int "
|
|
|
|
|
VMSTAT_NR_PAGE_TABLE_PAGES, // ul_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_NR_SHADOW_CALL_STACK, // ul_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_NR_SHMEM, // ul_int "
|
|
|
|
|
VMSTAT_NR_SHMEM_HUGEPAGES, // ul_int "
|
|
|
|
|
VMSTAT_NR_SHMEM_PMDMAPPED, // ul_int "
|
|
|
|
|
VMSTAT_NR_SLAB_RECLAIMABLE, // ul_int "
|
|
|
|
|
VMSTAT_NR_SLAB_UNRECLAIMABLE, // ul_int "
|
|
|
|
|
VMSTAT_NR_UNEVICTABLE, // ul_int "
|
|
|
|
|
VMSTAT_NR_UNSTABLE, // ul_int "
|
|
|
|
|
VMSTAT_NR_VMSCAN_IMMEDIATE_RECLAIM, // ul_int "
|
|
|
|
|
VMSTAT_NR_VMSCAN_WRITE, // ul_int "
|
|
|
|
|
VMSTAT_NR_WRITEBACK, // ul_int "
|
|
|
|
|
VMSTAT_NR_WRITEBACK_TEMP, // ul_int "
|
|
|
|
|
VMSTAT_NR_WRITTEN, // ul_int "
|
|
|
|
|
VMSTAT_NR_ZONE_ACTIVE_ANON, // ul_int "
|
|
|
|
|
VMSTAT_NR_ZONE_ACTIVE_FILE, // ul_int "
|
|
|
|
|
VMSTAT_NR_ZONE_INACTIVE_ANON, // ul_int "
|
|
|
|
|
VMSTAT_NR_ZONE_INACTIVE_FILE, // ul_int "
|
|
|
|
|
VMSTAT_NR_ZONE_UNEVICTABLE, // ul_int "
|
|
|
|
|
VMSTAT_NR_ZONE_WRITE_PENDING, // ul_int "
|
|
|
|
|
VMSTAT_NR_ZSPAGES, // ul_int "
|
|
|
|
|
VMSTAT_NUMA_FOREIGN, // ul_int "
|
|
|
|
|
VMSTAT_NUMA_HINT_FAULTS, // ul_int "
|
|
|
|
|
VMSTAT_NUMA_HINT_FAULTS_LOCAL, // ul_int "
|
|
|
|
|
VMSTAT_NUMA_HIT, // ul_int "
|
|
|
|
|
VMSTAT_NUMA_HUGE_PTE_UPDATES, // ul_int "
|
|
|
|
|
VMSTAT_NUMA_INTERLEAVE, // ul_int "
|
|
|
|
|
VMSTAT_NUMA_LOCAL, // ul_int "
|
|
|
|
|
VMSTAT_NUMA_MISS, // ul_int "
|
|
|
|
|
VMSTAT_NUMA_OTHER, // ul_int "
|
|
|
|
|
VMSTAT_NUMA_PAGES_MIGRATED, // ul_int "
|
|
|
|
|
VMSTAT_NUMA_PTE_UPDATES, // ul_int "
|
|
|
|
|
VMSTAT_OOM_KILL, // ul_int "
|
|
|
|
|
VMSTAT_PAGEOUTRUN, // ul_int "
|
|
|
|
|
VMSTAT_PGACTIVATE, // ul_int "
|
|
|
|
|
VMSTAT_PGALLOC_DMA, // ul_int "
|
|
|
|
|
VMSTAT_PGALLOC_DMA32, // ul_int "
|
|
|
|
|
VMSTAT_PGALLOC_HIGH, // ul_int "
|
|
|
|
|
VMSTAT_PGALLOC_MOVABLE, // ul_int "
|
|
|
|
|
VMSTAT_PGALLOC_NORMAL, // ul_int "
|
|
|
|
|
VMSTAT_PGDEACTIVATE, // ul_int "
|
|
|
|
|
VMSTAT_PGFAULT, // ul_int "
|
|
|
|
|
VMSTAT_PGFREE, // ul_int "
|
|
|
|
|
VMSTAT_PGINODESTEAL, // ul_int "
|
|
|
|
|
VMSTAT_PGLAZYFREE, // ul_int "
|
|
|
|
|
VMSTAT_PGLAZYFREED, // ul_int "
|
|
|
|
|
VMSTAT_PGMAJFAULT, // ul_int "
|
|
|
|
|
VMSTAT_PGMIGRATE_FAIL, // ul_int "
|
|
|
|
|
VMSTAT_PGMIGRATE_SUCCESS, // ul_int "
|
|
|
|
|
VMSTAT_PGPGIN, // ul_int "
|
|
|
|
|
VMSTAT_PGPGOUT, // ul_int "
|
|
|
|
|
VMSTAT_PGREFILL, // ul_int "
|
|
|
|
|
VMSTAT_PGROTATED, // ul_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_PGSCAN_ANON, // ul_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_PGSCAN_DIRECT, // ul_int "
|
|
|
|
|
VMSTAT_PGSCAN_DIRECT_THROTTLE, // ul_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_PGSCAN_FILE, // ul_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_PGSCAN_KSWAPD, // ul_int "
|
|
|
|
|
VMSTAT_PGSKIP_DMA, // ul_int "
|
|
|
|
|
VMSTAT_PGSKIP_DMA32, // ul_int "
|
|
|
|
|
VMSTAT_PGSKIP_HIGH, // ul_int "
|
|
|
|
|
VMSTAT_PGSKIP_MOVABLE, // ul_int "
|
|
|
|
|
VMSTAT_PGSKIP_NORMAL, // ul_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_PGSTEAL_ANON, // ul_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_PGSTEAL_DIRECT, // ul_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_PGSTEAL_FILE, // ul_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_PGSTEAL_KSWAPD, // ul_int "
|
|
|
|
|
VMSTAT_PSWPIN, // ul_int "
|
|
|
|
|
VMSTAT_PSWPOUT, // ul_int "
|
|
|
|
|
VMSTAT_SLABS_SCANNED, // ul_int "
|
|
|
|
|
VMSTAT_SWAP_RA, // ul_int "
|
|
|
|
|
VMSTAT_SWAP_RA_HIT, // ul_int "
|
|
|
|
|
VMSTAT_THP_COLLAPSE_ALLOC, // ul_int "
|
|
|
|
|
VMSTAT_THP_COLLAPSE_ALLOC_FAILED, // ul_int "
|
|
|
|
|
VMSTAT_THP_DEFERRED_SPLIT_PAGE, // ul_int "
|
|
|
|
|
VMSTAT_THP_FAULT_ALLOC, // ul_int "
|
|
|
|
|
VMSTAT_THP_FAULT_FALLBACK, // ul_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_THP_FAULT_FALLBACK_CHARGE, // ul_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_THP_FILE_ALLOC, // ul_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_THP_FILE_FALLBACK, // ul_int "
|
|
|
|
|
VMSTAT_THP_FILE_FALLBACK_CHARGE, // ul_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_THP_FILE_MAPPED, // ul_int "
|
|
|
|
|
VMSTAT_THP_SPLIT_PAGE, // ul_int "
|
|
|
|
|
VMSTAT_THP_SPLIT_PAGE_FAILED, // ul_int "
|
|
|
|
|
VMSTAT_THP_SPLIT_PMD, // ul_int "
|
|
|
|
|
VMSTAT_THP_SPLIT_PUD, // ul_int "
|
|
|
|
|
VMSTAT_THP_SWPOUT, // ul_int "
|
|
|
|
|
VMSTAT_THP_SWPOUT_FALLBACK, // ul_int "
|
|
|
|
|
VMSTAT_THP_ZERO_PAGE_ALLOC, // ul_int "
|
|
|
|
|
VMSTAT_THP_ZERO_PAGE_ALLOC_FAILED, // ul_int "
|
|
|
|
|
VMSTAT_UNEVICTABLE_PGS_CLEARED, // ul_int "
|
|
|
|
|
VMSTAT_UNEVICTABLE_PGS_CULLED, // ul_int "
|
|
|
|
|
VMSTAT_UNEVICTABLE_PGS_MLOCKED, // ul_int "
|
|
|
|
|
VMSTAT_UNEVICTABLE_PGS_MUNLOCKED, // ul_int "
|
|
|
|
|
VMSTAT_UNEVICTABLE_PGS_RESCUED, // ul_int "
|
|
|
|
|
VMSTAT_UNEVICTABLE_PGS_SCANNED, // ul_int "
|
|
|
|
|
VMSTAT_UNEVICTABLE_PGS_STRANDED, // ul_int "
|
|
|
|
|
VMSTAT_WORKINGSET_ACTIVATE, // ul_int "
|
|
|
|
|
VMSTAT_WORKINGSET_NODERECLAIM, // ul_int "
|
|
|
|
|
VMSTAT_WORKINGSET_NODES, // ul_int "
|
|
|
|
|
VMSTAT_WORKINGSET_REFAULT, // ul_int "
|
|
|
|
|
VMSTAT_WORKINGSET_RESTORE, // ul_int "
|
|
|
|
|
VMSTAT_ZONE_RECLAIM_FAILED, // ul_int "
|
library: normalize/standardize interface, <VMSTAT> api
This interface represented a 2nd generation attempt at
the opaque newlib approach. In other words, it did not
involve the 1st generation 'chains'. Instead, 'stacks'
were employed. But the interface wasn't user friendly.
Users were required to create their own stacks, before
calling 'getstack' to retrieve multiple results with a
single call. Even worse, sometimes 'read' was required
before calling 'get' when working with single results.
So this commit represents the 3rd generation approach.
We eliminate the burden of 'read' and creating stacks.
Rather, beyond those standard 'new', 'ref' and 'unref'
functions, we'll offer just 'get' (single result) plus
a 'select' function (for multiple results in 1 stack).
And along the way, this commit vastly expands the data
extracted from /proc/vmstat. All values that currently
exist (and their delta equivalents) are now available.
Deltas were included for everything because there's no
real runtime costs beyond using a little extra memory.
The only problem is a lack of documentation for all of
those fields, as is reflected in the references below.
Oh well, maybe someday someone will dig through kernel
sources & finally plug that rather large document gap.
[ as an aside, rather than using a 'strcmp' approach ]
[ when parsing the /proc/vmstat file, as is found in ]
[ the <meminfo> module, we exploit those hash search ]
[ provisions that are found in the <search.h> header ]
Reference(s):
http://www.spinics.net/lists/linux-man/msg09096.html
http://www.linuxinsight.com/proc_vmstat.html
Signed-off-by: Jim Warner <james.warner@comcast.net>
2016-06-04 10:30:00 +05:30
|
|
|
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_DELTA_ALLOCSTALL_DMA, // sl_int derived from above
|
|
|
|
|
VMSTAT_DELTA_ALLOCSTALL_DMA32, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_ALLOCSTALL_HIGH, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_ALLOCSTALL_MOVABLE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_ALLOCSTALL_NORMAL, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_BALLOON_DEFLATE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_BALLOON_INFLATE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_BALLOON_MIGRATE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_COMPACT_DAEMON_FREE_SCANNED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_COMPACT_DAEMON_MIGRATE_SCANNED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_COMPACT_DAEMON_WAKE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_COMPACT_FAIL, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_COMPACT_FREE_SCANNED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_COMPACT_ISOLATED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_COMPACT_MIGRATE_SCANNED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_COMPACT_STALL, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_COMPACT_SUCCESS, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_DROP_PAGECACHE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_DROP_SLAB, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_HTLB_BUDDY_ALLOC_FAIL, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_HTLB_BUDDY_ALLOC_SUCCESS, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_KSWAPD_HIGH_WMARK_HIT_QUICKLY, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_KSWAPD_INODESTEAL, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_KSWAPD_LOW_WMARK_HIT_QUICKLY, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_ACTIVE_ANON, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_ACTIVE_FILE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_ANON_PAGES, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_ANON_TRANSPARENT_HUGEPAGES, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_BOUNCE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_DIRTIED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_DIRTY, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_DIRTY_BACKGROUND_THRESHOLD, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_DIRTY_THRESHOLD, // sl_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_DELTA_NR_FILE_HUGEPAGES, // sl_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_DELTA_NR_FILE_PAGES, // sl_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_DELTA_NR_FILE_PMDMAPPED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_FOLL_PIN_ACQUIRED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_FOLL_PIN_RELEASED, // sl_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_DELTA_NR_FREE_CMA, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_FREE_PAGES, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_INACTIVE_ANON, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_INACTIVE_FILE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_ISOLATED_ANON, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_ISOLATED_FILE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_KERNEL_MISC_RECLAIMABLE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_KERNEL_STACK, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_MAPPED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_MLOCK, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_PAGE_TABLE_PAGES, // sl_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_DELTA_NR_SHADOW_CALL_STACK, // sl_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_DELTA_NR_SHMEM, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_SHMEM_HUGEPAGES, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_SHMEM_PMDMAPPED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_SLAB_RECLAIMABLE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_SLAB_UNRECLAIMABLE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_UNEVICTABLE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_UNSTABLE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_VMSCAN_IMMEDIATE_RECLAIM, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_VMSCAN_WRITE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_WRITEBACK, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_WRITEBACK_TEMP, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_WRITTEN, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_ZONE_ACTIVE_ANON, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_ZONE_ACTIVE_FILE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_ZONE_INACTIVE_ANON, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_ZONE_INACTIVE_FILE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_ZONE_UNEVICTABLE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_ZONE_WRITE_PENDING, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NR_ZSPAGES, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NUMA_FOREIGN, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NUMA_HINT_FAULTS, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NUMA_HINT_FAULTS_LOCAL, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NUMA_HIT, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NUMA_HUGE_PTE_UPDATES, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NUMA_INTERLEAVE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NUMA_LOCAL, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NUMA_MISS, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NUMA_OTHER, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NUMA_PAGES_MIGRATED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_NUMA_PTE_UPDATES, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_OOM_KILL, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PAGEOUTRUN, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGACTIVATE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGALLOC_DMA, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGALLOC_DMA32, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGALLOC_HIGH, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGALLOC_MOVABLE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGALLOC_NORMAL, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGDEACTIVATE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGFAULT, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGFREE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGINODESTEAL, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGLAZYFREE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGLAZYFREED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGMAJFAULT, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGMIGRATE_FAIL, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGMIGRATE_SUCCESS, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGPGIN, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGPGOUT, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGREFILL, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGROTATED, // sl_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_DELTA_PGSCAN_ANON, // sl_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_DELTA_PGSCAN_DIRECT, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGSCAN_DIRECT_THROTTLE, // sl_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_DELTA_PGSCAN_FILE, // sl_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_DELTA_PGSCAN_KSWAPD, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGSKIP_DMA, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGSKIP_DMA32, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGSKIP_HIGH, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGSKIP_MOVABLE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PGSKIP_NORMAL, // sl_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_DELTA_PGSTEAL_ANON, // sl_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_DELTA_PGSTEAL_DIRECT, // sl_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_DELTA_PGSTEAL_FILE, // sl_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_DELTA_PGSTEAL_KSWAPD, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PSWPIN, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_PSWPOUT, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_SLABS_SCANNED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_SWAP_RA, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_SWAP_RA_HIT, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_COLLAPSE_ALLOC, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_COLLAPSE_ALLOC_FAILED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_DEFERRED_SPLIT_PAGE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_FAULT_ALLOC, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_FAULT_FALLBACK, // sl_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_DELTA_THP_FAULT_FALLBACK_CHARGE, // sl_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_DELTA_THP_FILE_ALLOC, // sl_int "
|
2020-08-07 10:30:00 +05:30
|
|
|
VMSTAT_DELTA_THP_FILE_FALLBACK, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_FILE_FALLBACK_CHARGE, // sl_int "
|
library: refactored some header file items and origins
This commit is intended as a refinement of the patches
mentioned below, where origins/sources of newlib items
were added to the header files for user documentation.
However, if those additions are to be truly effective,
along with kernel documentation (where available), the
following prerequisites must also have been satisfied:
. our identifiers closely align with linux field names
. our derived items are documented or self-documenting
Satisfying those prerequisites prompted this patch and
for these changes, kernel sources were emphasized over
available documentation (shame on me, it should always
have been so). And, while some 'new' fields were found
to be conditional, they were included unconditionally.
These changes appear more extensive than they actually
need be since I have attempted to enforce some spacing
conventions. So, I've summarize the significant things
in the sections that follow. For a proper perspective,
use: 'git diff --ignore-space-change' (good as alias).
___________________________________________ <PIDS> api
This api is unique in that there exists many different
file/directory origins subordinate to /proc/<pid>. And
our item identifiers are sometimes coerced so as to be
able to group related or similar enumerators together.
So, users needed more help relating our identifiers to
an actual documented field. Thus, we will now also add
the field names as with 'stat: delayacct_blkio_ticks'.
Each item ending with a '_C' now consistently includes
both the parent's count/time plus waited for children.
That 'RTPRIO' guy was renamed/relocated as PRIORITY_RT
since its original name is an implementation artifact.
___________________________________________ <STAT> api
The only api change was to correct a typo ('dervied').
_________________________________________ <VMSTAT> api
Even ignoring white space, this interface received the
largest number of changes. Mostly, this was because of
deficiencies in the proc(5) documentation. Recall that
this documentation already sorely lacks any substance.
Usually, just kernel releases are noted, not contents.
When compared to kernel source, that proc(5) contained
many non-existent fields and also omitted many others.
________________________________________ <MEMINFO> api
Sadly, with this api many of the changes were simply a
correction of some earlier 'human error' where several
fields where hashed then tracked but never represented
with an item enumerator in this meminfo.h header file.
_______________________________________ <SLABINFO> api
The 'SLABS' (summary) & 'SLABNODE' items were reversed
since the former are derived from the separate caches.
More significantly, those 'SLABNODE' guys were renamed
to 'SLAB' since they concern individual caches and the
concept of 'nodes' is really an implementation detail.
Also, several enumerators were changed to more closely
agree with official slabinfo(5) documentation referred
to in what we're treating as a base document: proc(5).
Lastly, while those 'SLABS' items are solely a product
of our library and not represented in slabinfo(5), the
names attempt to parallel those found as 'SLAB' items.
______________________________________ <DISKSTATS> api
One enumeration identifier was changed so as to better
reflect its relationship to that actual documentation:
'Documentation/iostats.txt', as referenced in proc(5).
Reference(s):
. 12/2018, item origins added (and commit msg history)
commit 96d59cbf46b3ff687bd29fad4708074a0e1cea14
. 01/2019, <stat> origins tweaked
commit 201e816b26ddaccc923ec40977c92037cdd0c34e
Signed-off-by: Jim Warner <james.warner@comcast.net>
2019-03-12 11:30:00 +05:30
|
|
|
VMSTAT_DELTA_THP_FILE_MAPPED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_SPLIT_PAGE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_SPLIT_PAGE_FAILED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_SPLIT_PMD, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_SPLIT_PUD, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_SWPOUT, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_SWPOUT_FALLBACK, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_ZERO_PAGE_ALLOC, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_THP_ZERO_PAGE_ALLOC_FAILED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_UNEVICTABLE_PGS_CLEARED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_UNEVICTABLE_PGS_CULLED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_UNEVICTABLE_PGS_MLOCKED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_UNEVICTABLE_PGS_MUNLOCKED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_UNEVICTABLE_PGS_RESCUED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_UNEVICTABLE_PGS_SCANNED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_UNEVICTABLE_PGS_STRANDED, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_WORKINGSET_ACTIVATE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_WORKINGSET_NODERECLAIM, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_WORKINGSET_NODES, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_WORKINGSET_REFAULT, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_WORKINGSET_RESTORE, // sl_int "
|
|
|
|
|
VMSTAT_DELTA_ZONE_RECLAIM_FAILED // sl_int "
|
2015-06-20 03:13:02 +05:30
|
|
|
};
|
2015-06-28 10:30:00 +05:30
|
|
|
|
library: normalize/standardize interface, <VMSTAT> api
This interface represented a 2nd generation attempt at
the opaque newlib approach. In other words, it did not
involve the 1st generation 'chains'. Instead, 'stacks'
were employed. But the interface wasn't user friendly.
Users were required to create their own stacks, before
calling 'getstack' to retrieve multiple results with a
single call. Even worse, sometimes 'read' was required
before calling 'get' when working with single results.
So this commit represents the 3rd generation approach.
We eliminate the burden of 'read' and creating stacks.
Rather, beyond those standard 'new', 'ref' and 'unref'
functions, we'll offer just 'get' (single result) plus
a 'select' function (for multiple results in 1 stack).
And along the way, this commit vastly expands the data
extracted from /proc/vmstat. All values that currently
exist (and their delta equivalents) are now available.
Deltas were included for everything because there's no
real runtime costs beyond using a little extra memory.
The only problem is a lack of documentation for all of
those fields, as is reflected in the references below.
Oh well, maybe someday someone will dig through kernel
sources & finally plug that rather large document gap.
[ as an aside, rather than using a 'strcmp' approach ]
[ when parsing the /proc/vmstat file, as is found in ]
[ the <meminfo> module, we exploit those hash search ]
[ provisions that are found in the <search.h> header ]
Reference(s):
http://www.spinics.net/lists/linux-man/msg09096.html
http://www.linuxinsight.com/proc_vmstat.html
Signed-off-by: Jim Warner <james.warner@comcast.net>
2016-06-04 10:30:00 +05:30
|
|
|
|
2015-06-28 10:30:00 +05:30
|
|
|
struct vmstat_result {
|
|
|
|
|
enum vmstat_item item;
|
2015-07-21 10:30:00 +05:30
|
|
|
union {
|
2016-06-14 10:30:00 +05:30
|
|
|
signed long sl_int;
|
|
|
|
|
unsigned long ul_int;
|
2015-07-21 10:30:00 +05:30
|
|
|
} result;
|
2015-06-28 10:30:00 +05:30
|
|
|
};
|
|
|
|
|
|
library: normalize/standardize interface, <VMSTAT> api
This interface represented a 2nd generation attempt at
the opaque newlib approach. In other words, it did not
involve the 1st generation 'chains'. Instead, 'stacks'
were employed. But the interface wasn't user friendly.
Users were required to create their own stacks, before
calling 'getstack' to retrieve multiple results with a
single call. Even worse, sometimes 'read' was required
before calling 'get' when working with single results.
So this commit represents the 3rd generation approach.
We eliminate the burden of 'read' and creating stacks.
Rather, beyond those standard 'new', 'ref' and 'unref'
functions, we'll offer just 'get' (single result) plus
a 'select' function (for multiple results in 1 stack).
And along the way, this commit vastly expands the data
extracted from /proc/vmstat. All values that currently
exist (and their delta equivalents) are now available.
Deltas were included for everything because there's no
real runtime costs beyond using a little extra memory.
The only problem is a lack of documentation for all of
those fields, as is reflected in the references below.
Oh well, maybe someday someone will dig through kernel
sources & finally plug that rather large document gap.
[ as an aside, rather than using a 'strcmp' approach ]
[ when parsing the /proc/vmstat file, as is found in ]
[ the <meminfo> module, we exploit those hash search ]
[ provisions that are found in the <search.h> header ]
Reference(s):
http://www.spinics.net/lists/linux-man/msg09096.html
http://www.linuxinsight.com/proc_vmstat.html
Signed-off-by: Jim Warner <james.warner@comcast.net>
2016-06-04 10:30:00 +05:30
|
|
|
struct vmstat_stack {
|
|
|
|
|
struct vmstat_result *head;
|
|
|
|
|
};
|
2015-06-28 10:30:00 +05:30
|
|
|
|
2021-12-15 11:30:00 +05:30
|
|
|
struct vmstat_info;
|
|
|
|
|
|
2015-06-28 10:30:00 +05:30
|
|
|
|
2016-08-06 21:41:11 +05:30
|
|
|
#define VMSTAT_GET( info, actual_enum, type ) ( { \
|
|
|
|
|
struct vmstat_result *r = procps_vmstat_get( info, actual_enum ); \
|
|
|
|
|
r ? r->result . type : 0; } )
|
2016-06-18 10:30:00 +05:30
|
|
|
|
2016-08-05 10:30:00 +05:30
|
|
|
#define VMSTAT_VAL( relative_enum, type, stack, info ) \
|
2016-06-18 10:30:00 +05:30
|
|
|
stack -> head [ relative_enum ] . result . type
|
library: normalize/standardize interface, <VMSTAT> api
This interface represented a 2nd generation attempt at
the opaque newlib approach. In other words, it did not
involve the 1st generation 'chains'. Instead, 'stacks'
were employed. But the interface wasn't user friendly.
Users were required to create their own stacks, before
calling 'getstack' to retrieve multiple results with a
single call. Even worse, sometimes 'read' was required
before calling 'get' when working with single results.
So this commit represents the 3rd generation approach.
We eliminate the burden of 'read' and creating stacks.
Rather, beyond those standard 'new', 'ref' and 'unref'
functions, we'll offer just 'get' (single result) plus
a 'select' function (for multiple results in 1 stack).
And along the way, this commit vastly expands the data
extracted from /proc/vmstat. All values that currently
exist (and their delta equivalents) are now available.
Deltas were included for everything because there's no
real runtime costs beyond using a little extra memory.
The only problem is a lack of documentation for all of
those fields, as is reflected in the references below.
Oh well, maybe someday someone will dig through kernel
sources & finally plug that rather large document gap.
[ as an aside, rather than using a 'strcmp' approach ]
[ when parsing the /proc/vmstat file, as is found in ]
[ the <meminfo> module, we exploit those hash search ]
[ provisions that are found in the <search.h> header ]
Reference(s):
http://www.spinics.net/lists/linux-man/msg09096.html
http://www.linuxinsight.com/proc_vmstat.html
Signed-off-by: Jim Warner <james.warner@comcast.net>
2016-06-04 10:30:00 +05:30
|
|
|
|
|
|
|
|
|
2016-07-21 10:30:00 +05:30
|
|
|
int procps_vmstat_new (struct vmstat_info **info);
|
|
|
|
|
int procps_vmstat_ref (struct vmstat_info *info);
|
|
|
|
|
int procps_vmstat_unref (struct vmstat_info **info);
|
2015-06-28 10:30:00 +05:30
|
|
|
|
2016-06-18 10:30:00 +05:30
|
|
|
struct vmstat_result *procps_vmstat_get (
|
2016-07-21 10:30:00 +05:30
|
|
|
struct vmstat_info *info,
|
2015-07-21 10:30:00 +05:30
|
|
|
enum vmstat_item item);
|
|
|
|
|
|
library: normalize/standardize interface, <VMSTAT> api
This interface represented a 2nd generation attempt at
the opaque newlib approach. In other words, it did not
involve the 1st generation 'chains'. Instead, 'stacks'
were employed. But the interface wasn't user friendly.
Users were required to create their own stacks, before
calling 'getstack' to retrieve multiple results with a
single call. Even worse, sometimes 'read' was required
before calling 'get' when working with single results.
So this commit represents the 3rd generation approach.
We eliminate the burden of 'read' and creating stacks.
Rather, beyond those standard 'new', 'ref' and 'unref'
functions, we'll offer just 'get' (single result) plus
a 'select' function (for multiple results in 1 stack).
And along the way, this commit vastly expands the data
extracted from /proc/vmstat. All values that currently
exist (and their delta equivalents) are now available.
Deltas were included for everything because there's no
real runtime costs beyond using a little extra memory.
The only problem is a lack of documentation for all of
those fields, as is reflected in the references below.
Oh well, maybe someday someone will dig through kernel
sources & finally plug that rather large document gap.
[ as an aside, rather than using a 'strcmp' approach ]
[ when parsing the /proc/vmstat file, as is found in ]
[ the <meminfo> module, we exploit those hash search ]
[ provisions that are found in the <search.h> header ]
Reference(s):
http://www.spinics.net/lists/linux-man/msg09096.html
http://www.linuxinsight.com/proc_vmstat.html
Signed-off-by: Jim Warner <james.warner@comcast.net>
2016-06-04 10:30:00 +05:30
|
|
|
struct vmstat_stack *procps_vmstat_select (
|
2016-07-21 10:30:00 +05:30
|
|
|
struct vmstat_info *info,
|
library: normalize/standardize interface, <VMSTAT> api
This interface represented a 2nd generation attempt at
the opaque newlib approach. In other words, it did not
involve the 1st generation 'chains'. Instead, 'stacks'
were employed. But the interface wasn't user friendly.
Users were required to create their own stacks, before
calling 'getstack' to retrieve multiple results with a
single call. Even worse, sometimes 'read' was required
before calling 'get' when working with single results.
So this commit represents the 3rd generation approach.
We eliminate the burden of 'read' and creating stacks.
Rather, beyond those standard 'new', 'ref' and 'unref'
functions, we'll offer just 'get' (single result) plus
a 'select' function (for multiple results in 1 stack).
And along the way, this commit vastly expands the data
extracted from /proc/vmstat. All values that currently
exist (and their delta equivalents) are now available.
Deltas were included for everything because there's no
real runtime costs beyond using a little extra memory.
The only problem is a lack of documentation for all of
those fields, as is reflected in the references below.
Oh well, maybe someday someone will dig through kernel
sources & finally plug that rather large document gap.
[ as an aside, rather than using a 'strcmp' approach ]
[ when parsing the /proc/vmstat file, as is found in ]
[ the <meminfo> module, we exploit those hash search ]
[ provisions that are found in the <search.h> header ]
Reference(s):
http://www.spinics.net/lists/linux-man/msg09096.html
http://www.linuxinsight.com/proc_vmstat.html
Signed-off-by: Jim Warner <james.warner@comcast.net>
2016-06-04 10:30:00 +05:30
|
|
|
enum vmstat_item *items,
|
|
|
|
|
int numitems);
|
2015-06-20 03:13:02 +05:30
|
|
|
|
2018-09-01 10:30:00 +05:30
|
|
|
|
|
|
|
|
#ifdef XTRA_PROCPS_DEBUG
|
2020-07-25 10:30:00 +05:30
|
|
|
# include "xtra-procps-debug.h"
|
2018-09-01 10:30:00 +05:30
|
|
|
#endif
|
2018-04-06 10:30:00 +05:30
|
|
|
#ifdef __cplusplus
|
|
|
|
|
}
|
|
|
|
|
#endif
|
2015-06-20 03:13:02 +05:30
|
|
|
#endif
|
