Provided by: libsnmp-info-perl_3.39-1_all bug

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() - Indicates whether or not auto-negotiation is supported.
           ("ifMauAutoNegSupported")

       $mau->mau_autostat() - 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")

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.