Info::MAU(3pm) User Contributed Perl Documentation Info::MAU(3pm)
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
";
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.
perl v5.12.4 2011-09-28 Info::MAU(3pm)