Unix::Statgrab::sg_cpu_stats(3)

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.

  as_list
Deprecated alias of "fetchall_hash"

  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_array
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 without leading headline.

  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)"

  user
Clock ticks in user mode

  kernel
Clock ticks in kernel mode

  idle
Clock ticks while idle

  iowait
Clock ticks while waiting for outstanding I/O

  swap
Clock ticks while waiting for swap

  nice
Clock ticks in user mode with nice priority

  total
Overall clock ticks

  context_switches
Overall Context switches

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

  involuntary_context_switches
Involuntary context switches

  syscalls
Number of syscalls

  interrupts
Amount of interrupts happened

  soft_interrupts
Amount of software triggered interrupts

  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
Copyright (C) 2012-2015 by Jens Rehsack

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.