Vedran Sego > Linux-stat-1.00 > Linux::stat

Download:
Linux-stat-1.00.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 1.00   Source  

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, vsego@math.hr

syntax highlighting: