NAME

SNMP::Info::MAU - Perl5 Interface to Medium Access Unit (MAU) MIB (RFC2668) via SNMP

AUTHOR

Max Baker (max@warped.org)

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 sublcass of SNMP::Info that supplies access to the MAU-MIB (RFC2668). 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 INTERFACE TABLE ENTRIES

$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

 (B<ifMauMediaAvailable>)

$mau->mau_type() - Returns a 32bit string reporting the capabilities of the port from a MAU POV.

  Directly from the 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_auto() - Returns status of auto-negotiation mode for ports.

(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.