NAME

Unix::Statgrab::sg_network_io_stats - container for libstatgrab network I/O statistics

DESCRIPTION

"Unix::Statgrab::sg_network_io_stats" is a Perl package name providing accessors to bundled libstatgrab sg_network_io_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_network_io_stats.3.html> network I/O statistics.

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 network I/O statistics.

as_list

Deprecated alias of "fetchall_hash"

fetchall_hash

Returns all records from sg_network_io_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_network_io_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_network_io_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_network_io_stats.3.html> container as list of arrays containing the values in following order:

  (interface_name tx rx ipackets opackets ierrors oerrors collisions systime)

in that order without leading headline.

fetchall_table

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

  (interface_name tx rx ipackets opackets ierrors oerrors collisions 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_network_io_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_network_io_stats.3.html> container as array of arrays without header.

fetchrow_hashref($row = 0)

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

fetchall_hashref

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

colnames

Returns list of column names: "(interface_name tx rx ipackets opackets ierrors oerrors collisions systime)"

interface_name

The name known to the operating system. (e.g. on linux it might be eth0, on AIX en0 and on FreeBSD fxp0)

tx

The number of bytes transmitted.

rx

The number of bytes received.

ipackets

The number of packets received.

opackets

The number of packets transmitted.

ierrors

The number of receive errors.

oerrors

The number of transmit errors.

collisions

The number of collisions.

get_network_io_stats_diff

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

  $recent->get_network_io_stats_diff($last);

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.