SNMP::Info::Layer2::C2900.3pm

Langue: en

Version: 2007-11-25 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

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.\n";
 
 
  my $class = $c2900->class();
  print "SNMP::Info determined this device to fall under subclass : $class\n";
 
 

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' :)

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 broadcasted 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);