NAME

Unix::Statgrab::sg_cpu_stats - container for libstatgrab CPU statistics

DESCRIPTION

"Unix::Statgrab::sg_cpu_stats" is a Perl package name providing accessors to bundled libstatgrab sg_cpu_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_cpu_stats.3.html> data collection.

METHODS

nentries

Returns the number of entries in the container.

systime

Returns the seconds since Epoch (0:00:00 on January, 1st 1970) of the time measure the CPU statistics.

fetchall_hash

Returns all records from sg_cpu_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_cpu_stats.3.html> container as list of hash containing each datum name as key and the datum as value.

fetchall_table

Returns all records from sg_cpu_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_cpu_stats.3.html> container as list of arrays containing the values in following order:

  (user kernel idle iowait swap nice total
   context_switches voluntary_context_switches involuntary_context_switches
   syscalls interrupts soft_interrupts
   systime)

in that order including leading headline.

fetchrow_arrayref($row = 0)

Returns one row as array containing values as above.

fetchall_arrayref

Returns all records from sg_cpu_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_cpu_stats.3.html> container as array of arrays without header.

fetchrow_hashref($row = 0)

Returns one row as hash containing "{ user => $self.user($row), kernel => ... }".

fetchall_hashref

Returns all records from sg_cpu_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_cpu_stats.3.html> container as array of hashes.

colnames

Returns list of column names: "(user kernel idle iowait swap nice total context_switches voluntary_context_switches involuntary_context_switches syscalls interrupts soft_interrupts systime)"

iowait

Clock ticks while waiting for outstanding I/O

nice

Clock ticks in user mode with nice priority

voluntary_context_switches

Voluntary context switches (See sched_yield(2) <http://pubs.opengroup.org/onlinepubs/9699919799/functions/sched_yield.html>)

get_cpu_stats_diff

Provides the difference between the last measurement and the recent one.

  $recent->get_cpu_stats_diff($last);

get_cpu_percents

Provides a percentage representation of the single cpu ticks measured.

AUTHOR

Jens Rehsack, <rehsack AT cpan.org>

COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.