Sys::S...SysInfo(3pm)

💖 Sys::S...SysInfo(3pm) 💖

okay bestie, sit down, hydrate, and let me tell you about the User Contributed Perl Documentation page for Sys::S...SysInfo — she's a lil Perl module and she's about to tell you everything your Linux box knows about itself. no cap. 🦋

---

✨ NAME ✨

Sys::Statistics::Linux::SysInfo — she collects linux system information. that's it. that's the whole job. and she eats. 💅

---

🌸 SYNOPSIS 🌸

like, literally three lines and you're in:

use Sys::Statistics::Linux::SysInfo;

my $lxs  = Sys::Statistics::Linux::SysInfo->new;
my $info = $lxs->get;

see? iconic. no drama. 💖

---

🎀 DESCRIPTION 🎀

Sys::Statistics::Linux::SysInfo gathers system information from the virtual /proc filesystem — aka procfs. that's where Linux keeps all the receipts. 🧾✨

and if you want the whole lore, go read the documentation of the front-end module Sys::Statistics::Linux. she's the main character, this module is her very capable bestie. 👑

---

🦋 SYSTEM INFOMATIONS 🦋

(yes the heading says "INFOMATIONS", we don't gatekeep, we love her 🫶)

so all this good stuff gets generated by /proc/sys/kernel/{hostname,domainname,ostype,osrelease,version} plus /proc/cpuinfo, /proc/meminfo, /proc/uptime, and /proc/net/dev. the glow-up is real:

• hostname — the host name. 💖
• domain — the host domain name.
• kernel — the kernel name.
• release — the kernel release.
• version — the kernel version.
• memtotal — the total size of memory.
• swaptotal — the total size of swap space.
• uptime — the uptime of the system.
• idletime — the idle time of the system.
• pcpucount — the total number of physical CPUs.
• tcpucount — the total number of CPUs (cores, hyper threading).
• interfaces — the interfaces of the system.
• arch — the machine hardware name (uname -m).
• countcpus — the total (maybe logical) number of CPUs.

psst — countcpus is the same like tcpucount. twins. matching outfits. fr fr. 👯

okay so pcpucount and tcpucount are really easy to understand, bestie. both values are collected from /proc/cpuinfo. pcpucount is the number of physical CPUs, counted by physical id. tcpucount is just the total number counted by processor. one counts the actual little guys, the other counts everybody including the hyperthreaded besties. 🔥

now — if you want to get uptime and idletime as raw value, you can set:

$Sys::Statistics::Linux::SysInfo::RAWTIME = 1;
# or with
Sys::Statistics::Linux::SysInfo->new(rawtime => 1)

---

💜 METHODS 💜

🌈 new()

call new() to create a new object. brand new, fresh out the box, smelling like a new car. 🚗✨

my $lxs = Sys::Statistics::Linux::SysInfo->new;

🌈 get()

call get() to get the statistics. get() returns the statistics as a hash reference. she's giving data. she's giving structure. she's giving hashref. 🎁

my $info = $lxs->get;

---

⭐ EXPORTS ⭐

no exports. nothing. zero. empty. she's low maintenance like that. 💀

---

🌸 SEE ALSO 🌸

• proc(5) — go read it, bestie, it's the source material. 📖

---

🎀 REPORTING BUGS 🎀

please report all bugs to <jschulz.cpan(at)bloonix.de>. don't be mean about it, she's trying her best. 🙈

---

👑 AUTHOR 👑

Jonny Schulz <jschulz.cpan(at)bloonix.de>. legend behaviour. 💅

---

💖 COPYRIGHT 💖

Copyright (c) 2006, 2007 by Jonny Schulz. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay, legally. ⚖️✨

---

and that's the whole page, bestie! this one shipped as perl v5.36.0, dated 2022-11-19, under the name Sys::S...SysInfo(3pm) — go forth and get() your stats. mwah. 💋🦋🌸