libstatgrab/docs/page_stat.txt

Page Statistics
===============

$Id$

Data Structure
--------------

typedef struct{
        long long pages_pagein;
        long long pages_pageout;
        time_t systime;
}page_stat_t;

pages_pagein    is the number of pages swapped in to memory
pages_pageout   is the number of pages swapped out of memory (to swap)

Functions
---------

page_stat_t *get_page_stats();
page_stat_t *get_page_stats_diff();

get_page_stats() and get_page_stats_diff() both return a pointer
to a static buffer of type page_stat_t.

get_page_stats() will return the number of pages the system has
paged in and out since bootup. get_page_stats_diff() will return
the difference since last time it was called.  If it has not been
called before, it will return get_page_stats().

Bugs
----

Solaris doesn't seem to report accurately. It reports the number
of pages swapped into memory, not necessarily from swap. This feature
isn't deemed entirely reliable :)

Example
-------

An example can be found in examples/page_stats.c
Revision:	1.2
Committed:	Sun Aug 24 21:59:09 2003 UTC (21 years, 2 months ago) by tdb
Content type:	text/plain
Branch:	MAIN
CVS Tags:	LIBSTATGRAB_0_5_1, LIBSTATGRAB_0_5
Changes since 1.1:	+31 -13 lines
Log Message:	Tidy page_stat.txt, and add the page stats stuff to the Makefiles.
#	Content
1	Page Statistics
2	===============
3
4	$Id$
5
6	Data Structure
7	--------------
8
9	typedef struct{
10	long long pages_pagein;
11	long long pages_pageout;
12	time_t systime;
13	}page_stat_t;
14
15	pages_pagein is the number of pages swapped in to memory
16	pages_pageout is the number of pages swapped out of memory (to swap)
17
18	Functions
19	---------
20
21	page_stat_t *get_page_stats();
22	page_stat_t *get_page_stats_diff();
23
24	get_page_stats() and get_page_stats_diff() both return a pointer
25	to a static buffer of type page_stat_t.
26
27	get_page_stats() will return the number of pages the system has
28	paged in and out since bootup. get_page_stats_diff() will return
29	the difference since last time it was called. If it has not been
30	called before, it will return get_page_stats().
31
32	Bugs
33	----
34
35	Solaris doesn't seem to report accurately. It reports the number
36	of pages swapped into memory, not necessarily from swap. This feature
37	isn't deemed entirely reliable :)
38
39	Example
40	-------
41
42	An example can be found in examples/page_stats.c