Net::Int::Stats - Reports specific ifconfig values for a network interface


Net-Int-Stats documentation  | view source Contained in the Net-Int-Stats distribution.

Index


NAME

Top

Net::Int::Stats - Reports specific ifconfig values for a network interface

SYNOPSIS

Top

  use Net::Int::Stats;

  my $get = Net::Int::Stats->new();

  # get value for specific interface
  my $int     = 'eth0';
  my $stat    = 'rx_packets';
  my $packets = $get->value($int, $stat);

DESCRIPTION

Top

This module provides various statistics generated from the ifconfig command for specific interfaces. RX values consist of packets, errors, dropped, overruns, and frame. TX values consist of packets, errors, dropped, overruns, and carrier. In addition, collisions and txqueuelen are reported. Values are in the format of type:n - ex 'packets:123456'.

METHODS

Top

Use this one method to get specific values which requires two arguments: value(). Ex: $packets = $get->value($int, 'rx_packets');

The first argument is the interface and the second is the type value to extract.

RX values - rx_packets, rx_errors, rx_dropped, rx_overruns, rx_frame

TX values - tx_packets, tx_errors, tx_dropped, tx_overruns, tx_carrier

Miscellaneous values - collisions, txqueuelen

DEPENDENCIES

Top

This module is platform dependent. It uses the linux version of /sbin/ifconfig. Other platforms such as the windows equivalent of ipconfig, mac osx, and other versions of unix are not supported. This is due to the fact that each platform generates and displays different information in different formats of ifconfig results. The linux version is used over the other platforms because of the amount of data the default command outputs.

SEE ALSO

Top

linux command /sbin/ifconfig

NOTES

Top

ifconfig output contains more information than the values that are extracted in this module. More values can be added if there are any requests to do so.

AUTHOR

Top

Bruce Burch <bcb12001@yahoo.com>

COPYRIGHT AND LICENSE

Top


Net-Int-Stats documentation  | view source Contained in the Net-Int-Stats distribution.