NAME
   Linux::stat - parse /proc/stat

SYNOPSIS
     use Linux::stat;

     my $stat = Linux::stat->new( [ stat => "path to /proc/stat" ] );
     my $hashref = $stat->stat();

   or

     my $hashref = Linux::stat::stat( [ "path to /proc/stat" ] );

DESCRIPTION
   Linux::stat is a simple Perl module which parses /proc/stat
   file. Info is arranged in hash reference with descriptive keys.

   Linux::stat was written on RedHat Linux 7.2, kernel 2.4.7 and
   tested on RedHat 6.2, kernel 2.2.14. It is expected to work with
   other versions as well, but this depends on Linux configuration
   and kernel version.

   Output data can be easily previewed with Data::VarPrint package,
   available at CPAN.

   Output fields (some of these are unavailable on kernels older
   than 2.4):

   boot_timestamp
       Timestamp (number of seconds since epoch) when the system
       was booted

   context_switch
       Context switch, used by Linux job scheduler; for more info
       check Linux kernel sources: kernel/sched.c (look for
       kstat.context_swtch)

   cpu, cpu0, cpu1,...
       Overall and per-CPU time: user, nice, system, idle

   disks
       Disks I/O (for each partition):

   disk - disk number (0 for /dev/hda, 1 for /dev/hdb,...)
   io - total number of I/O requests
   major - major disk number (partition number on the disk)
   read_count - number of reads from disk
   read_sectors - number of sectors read from disk
   write_count - number of writes to disk
   write_sectors - number of sectors written to disk
   disks_io
       Overall disk I/O info; same fields as in disks (of course,
       except for disk and major)

   interrupts
       Number for interrupts for each IRQ

   interrupts_total
       Total number of interrupts (same as sum of all numbers in
       interrupts)

   kstat.*
       Not parsed, just added to hash

   pages_in
       Number of pages read

   pages_out
       Number of pages written

   swap_pages_in
       Number of pages read from swap

   swap_pages_out
       Number of pages written to swap

   total_forks
       Number of processes run since boot

   uptime
       System uptime in seconds (same as sum of all four times for
       cpu)

   All not-recognized fields are just passed on without parsing.

OPTIONS
   Currently, the only option available is stat which is path to
   /proc/stat in case this changes for some reason.

FILES
   /proc/stat CPU, disk and some other information

REQUIRES
   Perl 5.000

SEE ALSO
   perl(1)

AUTHOR
   Vedran Sego, [email protected]