The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

=head1 NAME
Sys::Statistics::Linux::SysInfo - Collect linux system informations.
=head1 SYNOPSIS
use Sys::Statistics::Linux::SysInfo;
my $lxs = Sys::Statistics::Linux::SysInfo->new;
my $info = $lxs->get;
=head1 DESCRIPTION
Sys::Statistics::Linux::SysInfo gathers system informations from the virtual F</proc> filesystem (procfs).
For more informations read the documentation of the front-end module L<Sys::Statistics::Linux>.
=head1 SYSTEM INFOMATIONS
Generated by F</proc/sys/kernel/{hostname,domainname,ostype,osrelease,version}>
and F</proc/cpuinfo>, F</proc/meminfo>, F</proc/uptime>.
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.
countcpus - The total (maybe logical) number of CPUs.
uptime - The uptime of the system.
idletime - The idle time of the system.
You can set
$Sys::Statistics::Linux::SysInfo::RAWTIME = 1;
to get C<uptime> and C<idletime> as raw value.
=head1 METHODS
=head2 new()
Call C<new()> to create a new object.
my $lxs = Sys::Statistics::Linux::SysInfo->new;
=head2 get()
Call C<get()> to get the statistics. C<get()> returns the statistics as a hash reference.
my $info = $lxs->get;
=head1 EXPORTS
No exports.
=head1 SEE ALSO
B<proc(5)>
=head1 REPORTING BUGS
Please report all bugs to <jschulz.cpan(at)bloonix.de>.
=head1 AUTHOR
Jonny Schulz <jschulz.cpan(at)bloonix.de>.
=head1 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.
=cut
use strict;
use Carp qw(croak);
our $VERSION = '0.08';
our $RAWTIME = 0;
sub new {
my $class = shift;
my %self = (
files => {
meminfo => '/proc/meminfo',
sysinfo => '/proc/sysinfo',
cpuinfo => '/proc/cpuinfo',
uptime => '/proc/uptime',
hostname => '/proc/sys/kernel/hostname',
domain => '/proc/sys/kernel/domainname',
kernel => '/proc/sys/kernel/ostype',
release => '/proc/sys/kernel/osrelease',
version => '/proc/sys/kernel/version',
#sem => '/proc/sys/kernel/sem',
#shmall => '/proc/sys/kernel/shmall',
#shmmax => '/proc/sys/kernel/shmmax',
#shmmni => '/proc/sys/kernel/shmmni',
}
);
return bless \%self, $class;
}
sub get {
my $self = shift;
my $class = ref $self;
my $file = $self->{files};
my $stats = $self->{stats};
#for my $x (qw(hostname domain kernel release version shmmax shmall shmmni)) {
for my $x (qw(hostname domain kernel release version)) {
open my $fh, '<', $file->{$x} or croak "$class: unable to open $file->{$x} ($!)";
$stats->{$x} = <$fh>;
close($fh);
}
#{ # read sem info
# open my $fh, '<', $file->{sem} or croak "$class: unable to open $file->{sem} ($!)";
# @{$stats}{qw/semmsl semmns semopm semmni/} = split /\s+/, <$fh>;
# close $fh;
#}
{ # memory and swap info
open my $fh, '<', $file->{meminfo} or croak "$class: unable to open $file->{meminfo} ($!)";
while (my $line = <$fh>) {
if ($line =~ /^MemTotal:\s+(\d+ \w+)/) {
$stats->{memtotal} = $1;
} elsif ($line =~ /^SwapTotal:\s+(\d+ \w+)/) {
$stats->{swaptotal} = $1;
}
}
close($fh);
}
{ # cpu info
$stats->{countcpus} = 0;
open my $fh, '<', $file->{cpuinfo} or croak "$class: unable to open $file->{cpuinfo} ($!)";
while (my $line = <$fh>) {
if ($line =~ /^processor\s*:\s*\d+/) { # x86
$stats->{countcpus}++;
} elsif ($line =~ /^# processors\s*:\s*(\d+)/) { # s390
$stats->{countcpus} = $1;
last;
}
}
close($fh);
$stats->{countcpus} ||= 1; # if it was not possible to match
}
{ # up- and idletime
open my $fh, '<', $file->{uptime} or croak "$class: unable to open $file->{uptime} ($!)";
($stats->{uptime}, $stats->{idletime}) = split /\s+/, <$fh>;
close $fh;
if (!$RAWTIME) {
foreach my $x (qw/uptime idletime/) {
my ($d, $h, $m, $s) = $self->_calsec(sprintf('%li', $stats->{$x}));
$stats->{$x} = "${d}d ${h}h ${m}m ${s}s";
}
}
close($fh);
}
foreach my $key (keys %{$stats}) {
chomp $stats->{$key};
$stats->{$key} =~ s/\t+/ /g;
$stats->{$key} =~ s/\s+/ /g;
}
return $stats;
}
sub _calsec {
my $self = shift;
my ($s, $m, $h, $d) = (shift, 0, 0, 0);
$s >= 86400 and $d = sprintf('%i',$s / 86400) and $s = $s % 86400;
$s >= 3600 and $h = sprintf('%i',$s / 3600) and $s = $s % 3600;
$s >= 60 and $m = sprintf('%i',$s / 60) and $s = $s % 60;
return ($d, $h, $m, $s);
}
1;