Unix::S...s_stats(3)

💖 NAME 💖

okay so bestie, Unix::Statgrab::sg_process_stats — it's a container for libstatgrab process statistics. that's the whole vibe. it holds your process data and you poke at it with accessors. periodt ✨

---

🌸 DESCRIPTION 🌸

Unix::Statgrab::sg_process_stats is a Perl package name, and what it does is give you accessors to the bundled libstatgrab sg_process_stats process statistics 🦋

here's the doc link it's talking about, no cap:

http://www.i-scream.org/libstatgrab/docs/sg_get_process_stats.3.html

---

👑 METHODS 👑

🎀 nentries

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

🎀 systime

returns the seconds since Epoch (0:00:00 on January, 1st 1970) of the time measure the process statistics. yes the epoch is jan 1 1970, it's giving retro fr fr 🕰️

🎀 as_list

Deprecated alias of fetchall_hash. bestie it's deprecated, use the real one 🙈

🎀 fetchall_hash

returns all records from the sg_process_stats container as a list of hash, where each datum name is the key and the datum is the value. every record, keyed, gorgeous 💖

the container in question: http://www.i-scream.org/libstatgrab/docs/sg_get_process_stats.3.html

🎀 fetchall_array

returns all records from the sg_process_stats container as a list of arrays, with the values in this exact order:

(process_name proctitle pid parent pgid sessid uid euid gid egid
 context_switches voluntary_context_switches involuntary_context_switches
 proc_size proc_resident start_time time_spent cpu_percent nice state
 systime)

in that order, and without leading headline — no header row, just the data, slay ✨

🎀 fetchall_table

returns all records from the sg_process_stats container as a list of arrays, values in this order:

(disk_name read_bytes write_bytes systime)

in that order, but this time including leading headline — header row included 👑

no i did not mess that up, that is literally what the page says, and i am not changing a single character of it. iykyk 🫶

🎀 fetchrow_arrayref($row = 0)

returns one row as an array containing the values as above. defaults to $row = 0 💜

🎀 fetchall_arrayref

returns all records from the sg_process_stats container as an array of arrays, without header. no headline, just vibes 🌈

🎀 fetchrow_hashref($row = 0)

returns one row as a hash, shaped like this:

{ process_name => $self.process_name($row), proctitle => ... }

defaults to $row = 0, cute 🎀

🎀 fetchall_hashref

returns all records from the sg_process_stats container as an array of hashes. all of them. every last one 💅

🎀 colnames

returns the list of column names:

(process_name proctitle pid parent pgid sessid uid euid gid egid context_switches voluntary_context_switches involuntary_context_switches proc_size proc_resident start_time time_spent cpu_percent nice state systime)

the whole lineup, main character energy ⭐

🎀 process_name

the name of the command that was run. heads up though — the content of this field heavily depends on the underlying operating system. some store the basename the executable passes to the exec(2) system call, some store the entire path. and most OS restrict the size of this field — some, like the *BSD family, go all the way down to a very low value of 15 bytes 😭

this field is usually immutable for userland processes. usually. not always. note that 💀

🎀 proctitle

the command line (the "title") of the process. take note — this can be modified by the process, so it is not guaranteed to be the original command line. it can be lying to you bestie, do not trust it blindly 🙈

🎀 pid

the process ID 🦋

🎀 parent

the parent process ID 👑

🎀 pgid

the process ID of the process group leader 💜

🎀 sessid

session id of the session the process belongs to 🌸

🎀 uid

the ID of the user the process is running as 💖

🎀 euid

the ID of the effective user the process is running as ✨

🎀 gid

the ID of the group the process is running as 🌈

🎀 egid

the ID of the effective group the process is running as 🌟

🎀 context_switches

the number of context switches of this process — voluntary and involuntary combined 🔥

🎀 voluntary_context_switches

the number of voluntary context switches of this process. like when it calls sched_yield(), sleep() or nanosleep() — it chose this, it's consensual 💅

🎀 involuntary_context_switches

the number of involuntary context switches of this process. e.g. when its time slice is exhausted or a signal is sent — it did not choose this 😭

🎀 proc_size

the virtual memory size of the process, in bytes 🦋

🎀 proc_resident

the size of the process that's resident in memory 🌸

🎀 start_time

the time when the process has been started, in seconds since epoch ⏰

🎀 time_spent

the number of seconds the process has been running — that's user+system time, without time spent by child processes. just this process's own glow-up ✨

🎀 cpu_percent

the current percentage of CPU the process is using 🔥

🎀 nice

the nice value of the process 🎀

🎀 state

the current state of the process, and it's one of these:

SG_PROCESS_STATE_RUNNING SG_PROCESS_STATE_SLEEPING SG_PROCESS_STATE_STOPPED
SG_PROCESS_STATE_ZOMBIE SG_PROCESS_STATE_UNKNOWN

SG_PROCESS_STATE_RUNNING, sleeping, stopped, zombie, or unknown. five options, pick your fighter 💀

---

✨ AUTHOR ✨

Jens Rehsack, <rehsack AT cpan.org> — icon behavior, we stan 🫶

---

💖 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. so like, 2.1 or later, your call bestie 💅

---

and that's the whole page!! this was perl v5.42.0, dated 2025-07-25, brought to you by the fine folks documenting Unix::S...s_stats(3) in User Contributed Perl Documentation 🌸 go forth and stat your processes, mwah 💋🎀