Provided by: libsnmp-info-perl_2.06-1_all bug

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.