1 package Linux::SysInfo;
8 Linux::SysInfo - Perl interface to the sysinfo(2) Linux system call.
23 use Linux::SysInfo qw/sysinfo/;
26 print "$_: $si->{$_}\n" for keys %$si;
30 This module is a wrapper around the C<sysinfo(2)> Linux system call.
31 It gives information about the current uptime, load average, memory usage and processes running.
32 Other systems have also this system call (e.g. Solaris), but in most cases the returned information is different.
36 =head2 C<LS_HAS_EXTENDED>
38 This constant is set to C<1> if your kernel supports the three extended fields C<totalhigh>, C<freehigh> and C<mem_unit> ; and to C<0> otherwise.
46 XSLoader::load(__PACKAGE__, $VERSION);
51 This function takes no argument.
52 It returns C<undef> on failure or a hash reference whose keys are the members name of the C<struct sysinfo> on success :
60 Seconds elapsed since the system booted.
64 C<load1>, C<load5>, C<load15>
66 1, 5 and 15 minutes load average.
72 Total usable main memory size.
78 Available memory size.
84 Amount of shared memory.
90 Memory used by buffers.
96 Total swap space size.
102 Swap space still available.
108 Number of current processes.
112 Prior to Linux 2.3.23 on i386 and 2.3.48 on all other architectures, the memory sizes were given in bytes.
113 Since then, the following members are also available and all the memory sizes are given as multiples of C<mem_unit> bytes :
121 Total high memory size.
127 Available high memory size.
133 Memory unit size in bytes.
139 The only function of this module, C<sysinfo>, and the constant C<LS_HAS_EXTENDED> are only exported on request.
140 Functions are also exported by the C<:funcs> tag, and constants by C<:consts>.
144 use base qw/Exporter/;
148 'funcs' => [ qw/sysinfo/ ],
149 'consts' => [ qw/LS_HAS_EXTENDED/ ]
151 our @EXPORT_OK = map { @$_ } values %EXPORT_TAGS;
152 $EXPORT_TAGS{'all'} = [ @EXPORT_OK ];
154 =head1 BINARY COMPATIBILITY
156 If you upgrade your kernel to a greater version than 2.3.23 on i386 or 2.3.48 on any other platform, you will need to rebuild the module to access the extended fields.
158 Moreover, since the perl hash function has changed after the 5.6 version, you will also need to recompile the module if you upgrade your perl from a version earlier than 5.6.
166 The C<sysinfo(2)> man page.
168 L<Sys::Info> : Gather information about your system.
170 L<Sys::CpuLoad> : Try several different methods to retrieve the load average.
172 L<BSD::getloadavg> : Wrapper to the C<getloadavg(3)> BSD system call.
176 Vincent Pit, C<< <perl at profvince.com> >>, L<http://www.profvince.com>.
178 You can contact me by mail or on C<irc.perl.org> (vincent).
182 Please report any bugs or feature requests to C<bug-linux-sysinfo at rt.cpan.org>, or through the web interface at L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Linux-SysInfo>.
183 I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
187 You can find documentation for this module with the perldoc command.
189 perldoc Linux::SysInfo
191 Tests code coverage report is available at L<http://www.profvince.com/perl/cover/Linux-SysInfo>.
193 =head1 COPYRIGHT & LICENSE
195 Copyright 2007,2008,2009,2010 Vincent Pit, all rights reserved.
197 This program is free software; you can redistribute it and/or modify it
198 under the same terms as Perl itself.
202 1; # End of Linux::SysInfo