NAME

SNMP::Info::MAU - SNMP Interface to Medium Attachment 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. MAU = Medium Attachment 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(...);

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.

SET METHODS

These are methods that provide SNMP set functionality for overridden methods or provide a simpler interface to complex set operations. See "SETTING DATA VIA SNMP" in SNMP::Info for general information on set operations.

$mau->mau_set_i_speed_admin(speed, ifIndex)

Sets port speed, must be supplied with speed and port "ifIndex".

Note that this method has some limitations since there is no way to reliably set the port speed independently of the port duplex setting on certain devices, notably the Cisco Cat4k series.

Speed choices are '10', '100', '1000', 'auto'.

$mau->mau_set_i_duplex_admin(duplex, ifIndex)

Sets port duplex, must be supplied with duplex and port "ifIndex".

Note that this method has some limitations since there is no way to reliably set the port duplex independently of the port speed setting on certain devices, notably the Cisco Cat4k series.

Duplex choices are 'auto', 'half', 'full'.

$mau->mau_set_i_speed_duplex_admin(speed, duplex, ifIndex)

Sets port speed and duplex settings, must be supplied with speed, duplex and port "ifIndex".

Accepts the following values for speed and duplex:

        Speed/Duplex
        ------------
        auto/auto (this is a special case)
        10/half
        10/full
        100/half
        100/full
        1000/half
        1000/full

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.