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.