Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SNMP::Info::MAU(3)    User Contributed Perl Documentation   SNMP::Info::MAU(3)

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 like HP Switches.  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(...);

   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.

perl v5.32.0			  2020-08-09		    SNMP::Info::MAU(3)

NAME | AUTHOR | SYNOPSIS | DESCRIPTION | GLOBALS | TABLE METHODS | SET METHODS | Utility Functions

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=SNMP::Info::MAU&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help