sg_get_page_stats(3) sg_get_page_stats(3) NAME sg_get_page_stats, sg_get_page_stats_r, sg_get_page_stats_diff, sg_get_page_stats_diff_between, sg_free_page_stats - get paging statistics SYNOPSIS #include <statgrab.h> sg_page_stats *sg_get_page_stats (size_t *entries); sg_page_stats *sg_get_page_stats_r (size_t *entries); sg_page_stats *sg_get_page_stats_diff (size_t *entries); sg_page_stats *sg_get_page_stats_diff_between (const sg_page_stats *cur, const sg_page_stats *last, size_t *entries); sg_error sg_free_page_stats (sg_page_stats *data); DESCRIPTION The page stats module deliver the number of pages swapped in and out, ei- ther since the machine has been booted (by the sg_get_page_stats() and sg_get_page_stats_r() functions) or the difference between two measured statistics (by the sg_get_page_stats_diff() and sg_get_page_stats_diff_be- tween() functions). The sg_get_page_stats_diff() function calculates the difference between the last call to the function sg_get_page_stats() in this thread (the statis- tics of the earlier call are saved and sg_get_page_stats() is called imme- diately after this). API Shortcut +----------------------------+-----------------+----------------------+ | function | returns | data owner | +----------------------------+-----------------+----------------------+ | sg_get_page_stats | sg_page_stats * | libstatgrab (thread | | | | local) | +----------------------------+-----------------+----------------------+ | sg_get_page_stats_r | sg_page_stats * | caller | +----------------------------+-----------------+----------------------+ | sg_get_page_stats_diff | sg_page_stats * | libstatgrab (thread | | | | local) | +----------------------------+-----------------+----------------------+ | sg_get_page_stats_diff_be- | sg_page_stats * | caller | | tween | | | +----------------------------+-----------------+----------------------+ The sg_page_stats buffer received from sg_get_page_stats_r() and the sg_get_page_stats_diff_between() must be freed using sg_free_page_stats() when not needed any more. The caller is responsible for doing it. RETURN VALUES typedef struct{ unsigned long long pages_pagein; unsigned long long pages_pageout; time_t systime; }sg_page_stats; pages_pagein The number of pages swapped into memory. pages_pageout The number of pages swapped out of memory (to swap). systime The timestamp when the above stats where collected in seconds since epoch or the time period over which pages_pagein and pages_pageout were transferred. 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. SEE ALSO statgrab(3) WEBSITE <https://libstatgrab.org/> libstatgrab 2019-03-08 sg_get_page_stats(3)
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | BUGS | SEE ALSO | WEBSITE
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=sg_get_page_stats_diff_between&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>