SNMP::Info::MAU.3pm

Langue: en

Version: 2008-08-02 (ubuntu - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

SNMP::Info::MAU - SNMP Interface to Medium Access Unit (MAU) MIB (RFC 2668) via SNMP

AUTHOR

Max Baker

SYNOPSIS

  my $mau = new SNMP::Info ( 
                              AutoSpecify => 1,
                              Debug       => 1,
                              DestHost    => 'hpswitch', 
                              Community   => 'public',
                              Version     => 2
                            );
  
  my $class = $mau->class();
  print " Using device sub class : $class\n";
 
 

DESCRIPTION

SNMP::Info::MAU is a subclass of SNMP::Info that supplies access to the MAU-MIB (RFC 2668). This MIB is sometimes implemented on Layer 2 network devices like HP Switches. MAU = Media Access Unit.

The MAU table contains link and duplex info for the port itself and the device connected to that port.

Normally you use or create a subclass of SNMP::Info that inherits this one. Do not use directly.

For debugging purposes call the class directly as you would SNMP::Info

  my $mau = new SNMP::Info::MAU(...);
 
 

Inherited Classes

None.

Required MIBs

MAU-MIB

GLOBALS

These are methods that return scalar value from SNMP
None

TABLE METHODS

These are methods that return tables of information in the form of a reference to a hash.
$mau->mau_i_duplex()
Parses mau_index and mau_link to return the duplex information for interfaces.
$mau->mau_i_duplex_admin()
Parses "mac_index","mau_autostat","mau_type_admin" in order to find the admin duplex setting for all the interfaces.

Returns either (auto,full,half).

$mau->mau_i_duplex_admin_old()
Called by mau_i_duplex_admin() if "mau_type_admin" is empty. Parses "mau_index","mau_autostat","mau_autosent" in order to find the admin duplex setting for all the interfaces.

Returns either (auto,none,full,half).

$mau->mau_i_speed_admin()
Returns admin speed setting for all the interfaces.

MAU INTERFACE TABLE METHODS

$mau->mau_index() - Returns a list of interfaces and their index in the MAU IF Table.
("ifMauIfIndex")
$mau->mau_link() - Returns the type of Media Access used.
     This is essentially the type of link in use.  
     eg. dot3MauType100BaseTXFD - 100BaseT at Full Duplex
 
 

("ifMauType")

$mau->mau_status() - Returns the admin link condition as
     1 - other
     2 - unknown
     3 - operational
     4 - standby
     5 - shutdown
     6 - reset
 
 

Use 5 and !5 to see if the link is up or down on the admin side.

("ifMauStatus")

$mau->mau_up() - Returns the current link condition
  (C<ifMauMediaAvailable>)
 
 
$mau->mau_type() - Returns a 32bit string reporting the capabilities of the port from a MAU POV.
   Directly from F<MAU-MIB> : 
           Bit   Capability
             0      other or unknown
             1      AUI
             2      10BASE-5
             3      FOIRL
             4      10BASE-2
             5      10BASE-T duplex mode unknown
             6      10BASE-FP
             7      10BASE-FB
             8      10BASE-FL duplex mode unknown
             9      10BROAD36
            10      10BASE-T  half duplex mode
            11      10BASE-T  full duplex mode
            12      10BASE-FL half duplex mode
            13      10BASE-FL full duplex mode
            14      100BASE-T4
            15      100BASE-TX half duplex mode
            16      100BASE-TX full duplex mode
            17      100BASE-FX half duplex mode
            18      100BASE-FX full duplex mode
            19      100BASE-T2 half duplex mode
            20      100BASE-T2 full duplex mode
 
 

("ifMauTypeList")

$mau->mau_type_admin()
("ifMauDefaultType")
$mau->mau_auto() - Returns status of auto-negotiation mode for ports.
("ifMauAutoNegAdminStatus")
$mau->mau_autostat()
("ifMauAutoNegAdminStatus")
$mau->mau_autosent() - Returns a 32 bit bit-string representing the capabilities we are broadcasting on that port
     Uses the same decoder as $mau->mau_type().
 
 

("ifMauAutoNegCapAdvertised")

$mau->mau_autorec() - Returns a 32 bit bit-string representing the capabilities of the device on the other end.
     Uses the same decoder as $mau->mau_type().
 
 

("ifMauAutoNegCapReceived")

Utility Functions

munge_int2bin() - Unpacks an integer into a 32bit bit string.
$mau->_isfullduplex(bitstring)
     Boolean. Checks to see if any of the full_duplex types from mau_type()
     are     high.  Currently bits 11,13,16,18,20.
 
 
$mau->_ishalfduplex(bitstring)
     Boolean.  Checks to see if any of the half_duplex types from mau_type()
     are high.  Currently bits 10,12,15,17,19.