 d460c5a473
			
		
	
	d460c5a473
	
	
	
		
			
			TABLE ENTRIES and others used TABLE METHODS. Since README says TABLE METHODS, let's standardize on that.
		
			
				
	
	
		
			289 lines
		
	
	
		
			8.4 KiB
		
	
	
	
		
			Perl
		
	
	
	
	
	
			
		
		
	
	
			289 lines
		
	
	
		
			8.4 KiB
		
	
	
	
		
			Perl
		
	
	
	
	
	
| # SNMP::Info::Layer3::C3550
 | |
| # Max Baker
 | |
| #
 | |
| # Copyright (c) 2004 Max Baker changes from version 0.8 and beyond.
 | |
| # Copyright (c) 2003, Regents of the University of California
 | |
| # All rights reserved.
 | |
| # 
 | |
| # Redistribution and use in source and binary forms, with or without 
 | |
| # modification, are permitted provided that the following conditions are met:
 | |
| # 
 | |
| #     * Redistributions of source code must retain the above copyright notice,
 | |
| #       this list of conditions and the following disclaimer.
 | |
| #     * Redistributions in binary form must reproduce the above copyright notice,
 | |
| #       this list of conditions and the following disclaimer in the documentation
 | |
| #       and/or other materials provided with the distribution.
 | |
| #     * Neither the name of the University of California, Santa Cruz nor the 
 | |
| #       names of its contributors may be used to endorse or promote products 
 | |
| #       derived from this software without specific prior written permission.
 | |
| # 
 | |
| # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
 | |
| # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
 | |
| # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
 | |
| # DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
 | |
| # ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 | |
| # (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
 | |
| # LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
 | |
| # ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
 | |
| # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
 | |
| # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 | |
| 
 | |
| package SNMP::Info::Layer3::C3550;
 | |
| $VERSION = '1.04';
 | |
| # $Id$
 | |
| 
 | |
| use strict;
 | |
| 
 | |
| use Exporter;
 | |
| use SNMP::Info::Layer3;
 | |
| use SNMP::Info::CiscoVTP;
 | |
| use SNMP::Info::CiscoStack;
 | |
| use SNMP::Info::CDP;
 | |
| use SNMP::Info::CiscoStats;
 | |
| use SNMP::Info::CiscoImage;
 | |
| 
 | |
| use vars qw/$VERSION $DEBUG %GLOBALS %MIBS %FUNCS %MUNGE $INIT/ ;
 | |
| @SNMP::Info::Layer3::C3550::ISA = qw/SNMP::Info::Layer3     SNMP::Info::CiscoStack SNMP::Info::CiscoVTP
 | |
|                                      SNMP::Info::CiscoStats SNMP::Info::CDP        Exporter
 | |
|                                      SNMP::Info::CiscoImage/;
 | |
| @SNMP::Info::Layer3::C3550::EXPORT_OK = qw//;
 | |
| 
 | |
| %MIBS =    (
 | |
|             %SNMP::Info::Layer3::MIBS,  
 | |
|             %SNMP::Info::CiscoVTP::MIBS,
 | |
|             %SNMP::Info::CiscoStack::MIBS,
 | |
|             %SNMP::Info::CDP::MIBS,
 | |
|             %SNMP::Info::CiscoStats::MIBS,
 | |
|             %SNMP::Info::CiscoImage::MIBS,
 | |
|            );
 | |
| 
 | |
| %GLOBALS = (
 | |
|             %SNMP::Info::Layer3::GLOBALS,
 | |
|             %SNMP::Info::CiscoVTP::GLOBALS,
 | |
|             %SNMP::Info::CiscoStack::GLOBALS,
 | |
|             %SNMP::Info::CDP::GLOBALS,
 | |
|             %SNMP::Info::CiscoStats::GLOBALS,
 | |
|             %SNMP::Info::CiscoImage::GLOBALS,
 | |
|             'ports2'      => 'ifNumber',
 | |
|            );
 | |
| 
 | |
| %FUNCS = (
 | |
|             %SNMP::Info::Layer3::FUNCS,
 | |
|             %SNMP::Info::CiscoVTP::FUNCS,
 | |
|             %SNMP::Info::CiscoStack::FUNCS,
 | |
|             %SNMP::Info::CDP::FUNCS,
 | |
|             %SNMP::Info::CiscoStats::FUNCS,
 | |
|             %SNMP::Info::CiscoImage::FUNCS,
 | |
|          );
 | |
| 
 | |
| %MUNGE = (
 | |
|             # Inherit all the built in munging
 | |
|             %SNMP::Info::Layer3::MUNGE,
 | |
|             %SNMP::Info::CiscoVTP::MUNGE,
 | |
|             %SNMP::Info::CiscoStack::MUNGE,
 | |
|             %SNMP::Info::CDP::MUNGE,
 | |
|             %SNMP::Info::CiscoStats::MUNGE,
 | |
|             %SNMP::Info::CiscoImage::MUNGE,
 | |
|          );
 | |
| 
 | |
| # Pick and choose
 | |
| 
 | |
| *SNMP::Info::Layer3::C3550::serial     = \&SNMP::Info::CiscoStack::serial;
 | |
| *SNMP::Info::Layer3::C3550::interfaces = \&SNMP::Info::Layer3::interfaces;
 | |
| *SNMP::Info::Layer3::C3550::i_duplex   = \&SNMP::Info::CiscoStack::i_duplex;
 | |
| *SNMP::Info::Layer3::C3550::i_duplex_admin = \&SNMP::Info::CiscoStack::i_duplex_admin;
 | |
| *SNMP::Info::Layer3::C3550::i_name     = \&SNMP::Info::Layer3::i_name;
 | |
| *SNMP::Info::Layer3::C3550::i_type     = \&SNMP::Info::CiscoStack::i_type;
 | |
| 
 | |
| sub vendor {
 | |
|     return 'cisco';
 | |
| }
 | |
| 
 | |
| sub model {
 | |
|     my $c3550 = shift;
 | |
|     my $id = $c3550->id();
 | |
|     my $model = &SNMP::translateObj($id) || $id;
 | |
|     $model =~ s/^catalyst//;
 | |
| 
 | |
|     # turn 355048 into 3550-48
 | |
|     if ($model =~ /^(35\d\d)(\d\d(T|G)?)$/) {
 | |
|         $model = "$1-$2";
 | |
|     }
 | |
|     return $model;
 | |
| }
 | |
| 
 | |
| # Ports is encoded into the model number
 | |
| sub ports {
 | |
|     my $c3550 = shift;
 | |
| 
 | |
|     my $ports2 = $c3550->ports2();    
 | |
| 
 | |
|     my $id = $c3550->id();
 | |
|     my $model = &SNMP::translateObj($id);
 | |
|     if ($model =~ /(12|24|48)(C|T|TS|G|TS-E|TS-S|T-E)?$/) {
 | |
|         return $1;
 | |
|     }
 | |
|     return $ports2;
 | |
| }
 | |
| 
 | |
| sub cisco_comm_indexing {
 | |
|     1;
 | |
| }
 | |
| 
 | |
| 
 | |
| 1;
 | |
| __END__
 | |
| 
 | |
| =head1 NAME
 | |
| 
 | |
| SNMP::Info::Layer3::C3550 - Perl5 Interface to Cisco Catalyst 3550 Layer 2/3 Switches running IOS
 | |
| 
 | |
| =head1 AUTHOR
 | |
| 
 | |
| Max Baker
 | |
| 
 | |
| =head1 SYNOPSIS
 | |
| 
 | |
|  # Let SNMP::Info determine the correct subclass for you. 
 | |
|  my $c3550 = new SNMP::Info(
 | |
|                           AutoSpecify => 1,
 | |
|                           Debug       => 1,
 | |
|                           # These arguments are passed directly on 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";
 | |
| 
 | |
| =head1 DESCRIPTION
 | |
| 
 | |
| Abstraction subclass for Cisco Catalyst 3550 Layer 2/3 Switches.  
 | |
| 
 | |
| These devices run IOS but have some of the same charactersitics as the Catalyst WS-C family (5xxx,6xxx). 
 | |
| For example, forwarding tables are held in VLANs, and extened interface information
 | |
| is gleened 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(...);
 | |
| 
 | |
| =head2 Inherited Classes
 | |
| 
 | |
| =over
 | |
| 
 | |
| =item SNMP::Info::Layer3
 | |
| 
 | |
| =item SNMP::Info::CiscoVTP
 | |
| 
 | |
| =item SNMP::Info::CiscoStack
 | |
| 
 | |
| =item SNMP::Info::CDP
 | |
| 
 | |
| =item SNMP::Info::CiscoStats
 | |
| 
 | |
| =item SNMP::Info::CiscoImage
 | |
| 
 | |
| =back
 | |
| 
 | |
| =head2 Required MIBs
 | |
| 
 | |
| =over
 | |
| 
 | |
| =item Inherited Classes' MIBs
 | |
| 
 | |
| See L<SNMP::Info::Layer3/"Required MIBs"> for its own MIB requirements.
 | |
| 
 | |
| See L<SNMP::Info::CiscoVTP/"Required MIBs"> for its own MIB requirements.
 | |
| 
 | |
| See L<SNMP::Info::CiscoStack/"Required MIBs"> for its own MIB requirements.
 | |
| 
 | |
| See L<SNMP::Info::CiscoStats/"Required MIBs"> for its own MIB requirements.
 | |
| 
 | |
| See L<SNMP::Info::CiscoImage/"Required MIBs"> for its own MIB requirements.
 | |
| 
 | |
| See L<SNMP::Info::CDP/"Required MIBs"> for its own MIB requirements.
 | |
| 
 | |
| =back
 | |
| 
 | |
| =head1 GLOBALS
 | |
| 
 | |
| These are methods that return scalar value from SNMP
 | |
| 
 | |
| =over
 | |
| 
 | |
| =item $c3550->vendor()
 | |
| 
 | |
|     Returns 'cisco'
 | |
| 
 | |
| =item $c3550->model()
 | |
| 
 | |
| Will take the translated model number and try to format it better.
 | |
| 
 | |
|  355048 -> 3550-48
 | |
|  355012G -> 3550-12G
 | |
| 
 | |
| =item $c3550->ports()
 | |
| 
 | |
| Trys to cull the number of ports from the model number.
 | |
| 
 | |
| =back
 | |
| 
 | |
| =head2 Globals imported from SNMP::Info::Layer3
 | |
| 
 | |
| See documentation in L<SNMP::Info::Layer3/"GLOBALS"> for details.
 | |
| 
 | |
| =head2 Global Methods imported from SNMP::Info::CiscoVTP
 | |
| 
 | |
| See documentation in L<SNMP::Info::CiscoVTP/"GLOBALS"> for details.
 | |
| 
 | |
| =head2 Global Methods imported from SNMP::Info::CiscoStack
 | |
| 
 | |
| See documentation in L<SNMP::Info::CiscoStack/"GLOBALS"> for details.
 | |
| 
 | |
| =head2 Globals imported from SNMP::Info::CDP
 | |
| 
 | |
| See documentation in L<SNMP::Info::CDP/"GLOBALS"> for details.
 | |
| 
 | |
| =head2 Globals imported from SNMP::Info::CiscoStats
 | |
| 
 | |
| See documentation in L<SNMP::Info::CiscoStats/"GLOBALS"> for details.
 | |
| 
 | |
| =head2 Globals imported from SNMP::Info::CiscoImage
 | |
| 
 | |
| See documentation in L<SNMP::Info::CiscoImage/"GLOBALS"> for details.
 | |
| 
 | |
| =head1 TABLE METHODS
 | |
| 
 | |
| These are methods that return tables of information in the form of a reference
 | |
| to a hash.
 | |
| 
 | |
| =head2 Table Methods imported from SNMP::Info::Layer3
 | |
| 
 | |
| See documentation in L<SNMP::Info::Layer3/"TABLE METHODS"> for details.
 | |
| 
 | |
| =head2 Table Methods imported from SNMP::Info::CiscoVTP
 | |
| 
 | |
| See documentation in L<SNMP::Info::CiscoVTP/"TABLE METHODS"> for details.
 | |
| 
 | |
| =head2 Table Methods imported from SNMP::Info::CiscoStack
 | |
| 
 | |
| See documentation in L<SNMP::Info::CiscoStack/"TABLE METHODS"> for details.
 | |
| 
 | |
| =head2 Table Methods imported from SNMP::Info::CDP
 | |
| 
 | |
| See documentation in L<SNMP::Info::CDP/"TABLE METHODS"> for details.
 | |
| 
 | |
| =head2 Table Methods imported from SNMP::Info::CiscoStats
 | |
| 
 | |
| See documentation in L<SNMP::Info::CiscoStats/"TABLE METHODS"> for details.
 | |
| 
 | |
| =head2 Table Methods imported from SNMP::Info::CiscoImage
 | |
| 
 | |
| See documentation in L<SNMP::Info::CiscoImage/"TABLE METHODS"> for details.
 | |
| 
 | |
| =cut
 |