Info::Layer2::C2900(3pm)				User Contributed Perl Documentation				  Info::Layer2::C2900(3pm)

NAME

       SNMP::Info::Layer2::C2900 - SNMP Interface to Cisco Catalyst 2900 Switches running IOS

AUTHOR

       Max Baker

SYNOPSIS

	# Let SNMP::Info determine the correct subclass for you.
	my $c2900 = new SNMP::Info(
			       AutoSpecify => 1,
			       Debug	   => 1,
			       # These arguments are passed directly to SNMP::Session
			       DestHost    => 'myswitch',
			       Community   => 'public',
			       Version	   => 2
			       )
	   or die "Can't connect to DestHost.
";

	my $class = $c2900->class();
	print "SNMP::Info determined this device to fall under subclass : $class
";

DESCRIPTION

       Provides abstraction to the configuration information obtainable from a C2900 device through SNMP.

       For speed or debugging purposes you can call the subclass directly, but not after determining a more specific class using the method above.

	my $c2900 = new SNMP::Info::Layer2::C2900(...);

   Inherited Classes
       SNMP::Info::CiscoVTP
       SNMP::Info::CDP
       SNMP::Info::CiscoStats
       SNMP::Info::CiscoConfig
       SNMP::Info::Layer2

   Required MIBs
       CISCO-C2900-MIB
	   Part of the v2 MIBs from Cisco.

   Inherited MIBs
       See "Required MIBs" in SNMP::Info::CiscoVTP for its MIB requirements.

       See "Required MIBs" in SNMP::Info::CDP for its MIB requirements.

       See "Required MIBs" in SNMP::Info::CiscoStats for its MIB requirements.

       See "Required MIBs" in SNMP::Info::CiscoConfig for its MIB requirements.

       See "Required MIBs" in SNMP::Info::Layer2 for its MIB requirements.

GLOBALS

       These are methods that return scalar value from SNMP

   Overrides
       $c2900->vendor()
	   Returns 'cisco' :)

       $c2900->cisco_comm_indexing()
	   Returns 1.  Use vlan indexing.

   Globals imported from SNMP::Info::CiscoVTP
       See "GLOBALS" in SNMP::Info::CiscoVTP for details.

   Globals imported from SNMP::Info::CDP
       See "GLOBALS" in SNMP::Info::CDP for details.

   Globals imported from SNMP::Info::CiscoStats
       See "GLOBALS" in SNMP::Info::CiscoStats for details.

   Globals imported from SNMP::Info::CiscoConfig
       See "GLOBALS" in SNMP::Info::CiscoConfig for details.

   Globals imported from SNMP::Info::Layer2
       See "GLOBALS" in SNMP::Info::Layer2 for details.

TABLE METHODS

       These are methods that return tables of information in the form of a reference to a hash.

   Overrides
       $c2900->interfaces()
	   Returns reference to the map between IID and physical Port.

	   On the 2900 devices i_name isn't reliable, so we override to just the description.

	   Next all dots are changed for forward slashes so that the physical port name is the same as the broad-casted CDP port name.
	       (Ethernet0.1 -> Ethernet0/1)

	   Also, any weird characters are removed, as I saw a few pop up.

       $c2900->i_duplex()
	   Returns reference to map of IIDs to current link duplex

	   Crosses $c2900->c2900_p_index() with $c2900->c2900_p_duplex()

       $c2900->i_duplex_admin()
	   Returns reference to hash of IIDs to admin duplex setting

	   Crosses $c2900->c2900_p_index() with $c2900->c2900_p_duplex_admin()

   C2900-MIB Port Entry Table
       $c2900->c2900_p_index()
	   Maps the Switch Port Table to the IID

	   ("c2900PortIfIndex")

       $c2900->c2900_p_duplex()
	   Gives Port Duplex Info

	   ("c2900PortDuplexStatus")

       $c2900->c2900_p_duplex_admin()
	   Gives admin setting for Duplex Info

	   ("c2900PortDuplexState")

       $c2900->c2900_p_speed_admin()
	   Gives Admin speed of port

	   ("c2900PortAdminSpeed")

   Table Methods imported from SNMP::Info::CiscoVTP
       See "TABLE METHODS" in SNMP::Info::CiscoVTP for details.

   Table Methods imported from SNMP::Info::CDP
       See "TABLE METHODS" in SNMP::Info::CDP for details.

   Table Methods imported from SNMP::Info::CiscoStats
       See "TABLE METHODS" in SNMP::Info::CiscoStats for details.

   Table Methods imported from SNMP::Info::CiscoConfig
       See "TABLE METHODS" in SNMP::Info::CiscoConfig for details.

   Table Methods imported from SNMP::Info::Layer2
       See "TABLE METHODS" in SNMP::Info::Layer2 for details.

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.

       $c2900->set_i_speed_admin(speed, ifIndex)
	   Sets port speed, must be supplied with speed and port "ifIndex"

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

	   Crosses $c2900->c2900_p_index() with $c2900->c2900_p_speed_admin() to utilize port "ifIndex".

	       Example:
	       my %if_map = reverse %{$c2900->interfaces()};
	       $c2900->set_i_speed_admin('auto', $if_map{'FastEthernet0/1'})
		   or die "Couldn't change port speed. ",$c2900->error(1);

       $c2900->set_i_duplex_admin(duplex, ifIndex)
	   Sets port duplex, must be supplied with duplex and port "ifIndex"

	   Speed choices are 'auto', 'half', 'full'

	   Crosses $c2900->c2900_p_index() with $c2900->c2900_p_duplex_admin() to utilize port "ifIndex".

	       Example:
	       my %if_map = reverse %{$c2900->interfaces()};
	       $c2900->set_i_duplex_admin('auto', $if_map{'FastEthernet0/1'})
		   or die "Couldn't change port duplex. ",$c2900->error(1);

perl v5.12.4							    2011-09-28						  Info::Layer2::C2900(3pm)