Unix::S...ge_stats(3)

✨ Unix::Statgrab::sg_page_stats ✨

okay bestie, welcome to the glow-up of Unix::Statgrab::sg_page_stats(3) — it lives in the User Contributed Perl Documentation, section 3, and it's literally the cutest little container for libstatgrab paging stats. 🫶

---

🌸 NAME 🌸

Unix::Statgrab::sg_page_stats — a container for libstatgrab paging statistics. that's the whole vibe. 💅

---

🦋 DESCRIPTION 🦋

so Unix::Statgrab::sg_page_stats is a Perl package name, and what it does is hand you accessors into the bundled libstatgrab sg_page_stats paging statistics — the docs for that live over at http://www.i-scream.org/libstatgrab/docs/sg_get_page_stats.3.html. it's giving "wrapper with main character energy". ✨

---

🎀 METHODS 🎀

nentries

returns the number of entries in the container. that's it, that's the method. 💖

systime

returns the seconds since Epoch — and yes, Epoch means 0:00:00 on January, 1st 1970 — for the time the paging statistics were measured. 🕰️

as_list

deprecated alias of fetchall_hash. she's old, she's tired, she still works, but bestie… use the new one. 🙈

fetchall_hash

returns all the records from the sg_page_stats container (link: http://www.i-scream.org/libstatgrab/docs/sg_get_page_stats.3.html) as a list of hashes — each datum name is the key, each datum is the value. obsessed. 💜

fetchall_array

returns all the records from the sg_page_stats container (link: http://www.i-scream.org/libstatgrab/docs/sg_get_page_stats.3.html) as a list of arrays, with the values in this exact order:

(pages_pagein pages_pageout systime)

in that order, no leading headline. clean, no notes. ✨

fetchall_table

returns all the records from the sg_page_stats container (link: http://www.i-scream.org/libstatgrab/docs/sg_get_page_stats.3.html) as a list of arrays, values in this exact order:

(pages_pagein pages_pageout systime)

in that order, but including the leading headline this time. the header is invited to the party. 👑

fetchrow_arrayref($row = 0)

returns one row as an array, with the values exactly as above. and yeah, $row defaults to 0. 💅

fetchall_arrayref

returns all the records from the sg_page_stats container (link: http://www.i-scream.org/libstatgrab/docs/sg_get_page_stats.3.html) as an array of arrays, no header. nope, none. 😌

fetchrow_hashref($row = 0)

returns one row as a hash containing:

{ pages_pagein => $self.pages_pagein($row), pages_pageout => ... }

and $row defaults to 0 again, because consistency is a love language. 🍓

fetchall_hashref

returns all the records from the sg_page_stats container (link: http://www.i-scream.org/libstatgrab/docs/sg_get_page_stats.3.html) as an array of hashes. 🌈

colnames

returns the list of column names:

(pages_pagein pages_pageout systime)

pages_pagein

the number of pages swapped into memory. she's coming in. 🫶

pages_pageout

the number of pages swapped out of memory (to swap). she's leaving, and honestly? good for her. 🧚

get_page_stats_diff

provides the difference between the last measurement and the recent one. so like:

$recent->get_page_stats_diff($last);

comparison era, fr fr. 🔥

---

💖 AUTHOR 💖

Jens Rehsack, <rehsack AT cpan.org> — shoutout to the icon who built this. 👑

---

⭐ COPYRIGHT AND LICENSE ⭐

Copyright (C) 2012-2018 by Jens Rehsack

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. no cap, that's the actual license. 📜

---

and that's the whole page, bestie — no notes, no skips, every flag and every field made it in. slay. 💅

mwah 💋 this was brought to you by perl v5.42.0, dated 2025-07-25, and the manual page Unix::S...ge_stats(3) — catch you in the next man page! 🎀✨