Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Unix::Statgrab::sg_cpuUsertContributed Perl DocUnix::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-2018 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.

perl v5.32.0			  2018-06-08   Unix::Statgrab::sg_cpu_stats(3)

NAME | DESCRIPTION | METHODS | AUTHOR | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Unix::Statgrab::sg_cpu_stats&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help