NAME

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

DESCRIPTION

MAU-MIB is used by Layer 2 devices like HP Switches . The MAU table contains link and duplex info for the port itself and the device connected to that port.

Inherits all methods from SNMP::Info

AUTHOR

Max Baker (max@warped.org)

SYNOPSIS

my $mau = new SNMP::Info::MAU(      DestHost  => 'myswitch',
                              Community => 'public');

CREATING AN OBJECT

new SNMP::Info::MAU()

Arguments passed to new() are passed on to SNMP::Session::new()

my $mau = new SNMP::Info::MAU(
    DestHost => $host,
    Community => 'public',
    Version => 3,...
    ) 
die "Couldn't connect.\n" unless defined $mau;

$mau->session()

Sets or returns the SNMP::Session object

# Get
my $sess = $mau->session();

# Set
my $newsession = new SNMP::Session(...);
$mau->session($newsession);

$mau->all(), $mau->load_all()

Queries each of the methods listed in %FUNCS and returns a hash reference.

$mau->all() will call $mau->load_all() once and then return cahced valued. Use $mau->load_all() to reload from the device.

MAU Global Configuration Values

None

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.