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)