Info::Layer3::C3550(3p)

NAME
SNMP::Info::Layer3::C3550 - SNMP Interface to Cisco Catalyst 3550 Layer 2/3 Switches running IOS

AUTHOR
Max Baker

SYNOPSIS
 # Let SNMP::Info determine the correct subclass for you.
 my $c3550 = 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      = $c3550->class();
 print "SNMP::Info determined this device to fall under subclass : $class\n";

DESCRIPTION
Abstraction subclass for Cisco Catalyst 3550 Layer 2/3 Switches.

These devices run IOS but have some of the same characteristics as the Catalyst WS-C family (5xxx,6xxx). For example, forwarding tables are held in VLANs, and extended interface information is gleaned from CISCO-SWITCH-MIB.

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

 my $c3550 = new SNMP::Info::Layer3::C3550(...);

  Inherited Classes

SNMP::Info::Layer3
SNMP::Info::CiscoSTPExtensions
SNMP::Info::CiscoPower
SNMP::Info::CiscoPortSecurity
SNMP::Info::CiscoVTP
SNMP::Info::CiscoStack
SNMP::Info::CDP
SNMP::Info::LLDP
SNMP::Info::CiscoStats
SNMP::Info::CiscoImage

  Required MIBs

Inherited Classes' MIBs
    See "Required MIBs" in SNMP::Info::Layer3 for its own MIB requirements.

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

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

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

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

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

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

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

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

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

GLOBALS
These are methods that return scalar value from SNMP

$c3550->vendor()
    Returns 'cisco'

$c3550->model()
    Will take the translated model number and try to format it better.

     355048 -> 3550-48
     355012G -> 3550-12G

$c3550->ports()
    Tries to cull the number of ports from the model number.

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

  Topology information
Based upon the firmware version Cisco devices may support Link Layer Discovery Protocol (LLDP) in addition to Cisco Discovery Protocol (CDP). These methods will query both and return the combination of all information. As a result, there may be identical topology information returned from the two protocols causing duplicate entries. It is the calling program's responsibility to identify any duplicate entries and remove duplicates if necessary.

$c3550->hasCDP()
    Returns true if the device is running either CDP or LLDP.

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

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

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

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

  Global Methods imported from SNMP::Info::CiscoVTP
See documentation in "GLOBALS" in SNMP::Info::CiscoVTP for details.

  Global Methods imported from SNMP::Info::CiscoStack
See documentation in "GLOBALS" in SNMP::Info::CiscoStack for details.

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

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

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

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

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

$c3550->c_if()
    Returns reference to hash. Key: iid Value: local device port (interfaces)

$c3550->c_ip()
    Returns reference to hash. Key: iid Value: remote IPv4 address

    If multiple entries exist with the same local port, c_if(), with the same IPv4 address, c_ip(), it may be a duplicate entry.

    If multiple entries exist with the same local port, c_if(), with different IPv4 addresses, c_ip(), there is either a non-CDP/LLDP device in between two or more devices or multiple devices which are not directly connected.

    Use the data from the Layer2 Topology Table below to dig deeper.

$c3550->c_port()
    Returns reference to hash. Key: iid Value: remote port (interfaces)

$c3550->c_id()
    Returns reference to hash. Key: iid Value: string value used to identify the chassis component associated with the remote system.

$c3550->c_platform()
    Returns reference to hash. Key: iid Value: Remote Device Type

  Overrides

$c3550->i_duplex()
    Returns reference to hash of iid to current link duplex setting.

    Software version 12.1(22)EA1a or greater returns duplex based upon the result of $c3550->el_duplex(). Otherwise it uses the result of the call to CiscoStack::i_duplex().

    See SNMP::Info::Etherlike for el_duplex() method and SNMP::Info::CiscoStack for its i_duplex() method.

$c3550->i_duplex_admin()
    Returns reference to hash of iid to administrative duplex setting.

    Software version 12.1(22)EA1a or greater returns duplex based upon the result of $c3550->p_duplex(). Otherwise it uses the result of the call to CiscoStack::i_duplex().

    See SNMP::Info::CiscoStack for its i_duplex() and p_duplex() methods.

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

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

    Crosses $c3550->p_port() with $c3550->p_duplex() to utilize port "ifIndex".

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

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

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

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

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

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

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

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

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

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

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