sys::statistics::linux::sysinfo(3pm) [debian man page]

Sys::Statistics::Linux::SysInfo(3pm)			User Contributed Perl Documentation		      Sys::Statistics::Linux::SysInfo(3pm)

NAME

       Sys::Statistics::Linux::SysInfo - Collect linux system information.

SYNOPSIS

	   use Sys::Statistics::Linux::SysInfo;

	   my $lxs  = Sys::Statistics::Linux::SysInfo->new;
	   my $info = $lxs->get;

DESCRIPTION

       Sys::Statistics::Linux::SysInfo gathers system information from the virtual /proc filesystem (procfs).

       For more information read the documentation of the front-end module Sys::Statistics::Linux.

SYSTEM INFOMATIONS

       Generated by /proc/sys/kernel/{hostname,domainname,ostype,osrelease,version} and /proc/cpuinfo, /proc/meminfo, /proc/uptime, /proc/net/dev.

	   hostname   -  The host name.
	   domain     -  The host domain name.
	   kernel     -  The kernel name.
	   release    -  The kernel release.
	   version    -  The kernel version.
	   memtotal   -  The total size of memory.
	   swaptotal  -  The total size of swap space.
	   uptime     -  The uptime of the system.
	   idletime   -  The idle time of the system.
	   pcpucount  -  The total number of physical CPUs.
	   tcpucount  -  The total number of CPUs (cores, hyper threading).
	   interfaces -  The interfaces of the system.
	   arch       -  The machine hardware name (uname -m).

	   # countcpus is the same like tcpucount
	   countcpus  -  The total (maybe logical) number of CPUs.

       "pcpucount" and "tcpucount" are really easy to understand. Both values are collected from "/proc/cpuinfo". "pcpucount" is the number of
       physical CPUs, counted by "physical id". "tcpucount" is just the total number counted by "processor".

       If you want to get "uptime" and "idletime" as raw value you can set

	   $Sys::Statistics::Linux::SysInfo::RAWTIME = 1;
	   # or with
	   Sys::Statistics::Linux::SysInfo->new(rawtime => 1)

METHODS

   new()
       Call "new()" to create a new object.

	   my $lxs = Sys::Statistics::Linux::SysInfo->new;

   get()
       Call "get()" to get the statistics. "get()" returns the statistics as a hash reference.

	   my $info = $lxs->get;

EXPORTS

       No exports.

SEE ALSO

       proc(5)

REPORTING BUGS

       Please report all bugs to <jschulz.cpan(at)bloonix.de>.

AUTHOR

       Jonny Schulz <jschulz.cpan(at)bloonix.de>.

COPYRIGHT

       Copyright (c) 2006, 2007 by Jonny Schulz. All rights reserved.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2012-03-09				      Sys::Statistics::Linux::SysInfo(3pm)

Sys::Statistics::Linux::NetStats(3pm)			User Contributed Perl Documentation		     Sys::Statistics::Linux::NetStats(3pm)

NAME

       Sys::Statistics::Linux::NetStats - Collect linux net statistics.

SYNOPSIS

	   use Sys::Statistics::Linux::NetStats;

	   my $lxs = Sys::Statistics::Linux::NetStats->new;
	   $lxs->init;
	   sleep 1;
	   my $stat = $lxs->get;

       Or

	   my $lxs = Sys::Statistics::Linux::NetStats->new(initfile => $file);
	   $lxs->init;
	   my $stat = $lxs->get;

DESCRIPTION

       Sys::Statistics::Linux::NetStats gathers net statistics from the virtual /proc filesystem (procfs).

       For more information read the documentation of the front-end module Sys::Statistics::Linux.

NET STATISTICS

       Generated by /proc/net/dev.

	   rxbyt    -  Number of bytes received per second.
	   rxpcks   -  Number of packets received per second.
	   rxerrs   -  Number of errors that happend while received packets per second.
	   rxdrop   -  Number of packets that were dropped per second.
	   rxfifo   -  Number of FIFO overruns that happend on received packets per second.
	   rxframe  -  Number of carrier errors that happend on received packets per second.
	   rxcompr  -  Number of compressed packets received per second.
	   rxmulti  -  Number of multicast packets received per second.
	   txbyt    -  Number of bytes transmitted per second.
	   txpcks   -  Number of packets transmitted per second.
	   txerrs   -  Number of errors that happend while transmitting packets per second.
	   txdrop   -  Number of packets that were dropped per second.
	   txfifo   -  Number of FIFO overruns that happend on transmitted packets per second.
	   txcolls  -  Number of collisions that were detected per second.
	   txcarr   -  Number of carrier errors that happend on transmitted packets per second.
	   txcompr  -  Number of compressed packets transmitted per second.
	   ttpcks   -  Number of total packets (received + transmitted) per second.
	   ttbyt    -  Number of total bytes (received + transmitted) per second.

METHODS

   new()
       Call "new()" to create a new object.

	   my $lxs = Sys::Statistics::Linux::NetStats->new;

       Maybe you want to store/load the initial statistics to/from a file:

	   my $lxs = Sys::Statistics::Linux::NetStats->new(initfile => '/tmp/netstats.yml');

       If you set "initfile" it's not necessary to call sleep before "get()".

       It's also possible to set the path to the proc filesystem.

	    Sys::Statistics::Linux::NetStats->new(
	       files => {
		   # This is the default
		   path   => '/proc',
		   netdev => 'net/dev',
	       }
	   );

   init()
       Call "init()" to initialize the statistics.

	   $lxs->init;

   get()
       Call "get()" to get the statistics. "get()" returns the statistics as a hash reference.

	   my $stat = $lxs->get;

   raw()
       The same as get_raw() but it's not necessary to call init() first.

   get_raw()
       Call "get_raw()" to get the raw data - no deltas.

EXPORTS

       No exports.

SEE ALSO

       proc(5)

REPORTING BUGS

       Please report all bugs to <jschulz.cpan(at)bloonix.de>.

AUTHOR

       Jonny Schulz <jschulz.cpan(at)bloonix.de>.

COPYRIGHT

       Copyright (c) 2006, 2007 by Jonny Schulz. All rights reserved.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2012-03-09				     Sys::Statistics::Linux::NetStats(3pm)