VSEGO / Linux-stat-1.00 / README 

            

              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

              
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