313 lines
7.9 KiB
Perl
313 lines
7.9 KiB
Perl
# SNMP::Info::Layer2::Catalyst
|
|
# $Id$
|
|
#
|
|
# Copyright (c) 2002,2003 Regents of the University of California
|
|
# Copyright (c) 2008 Max Baker changes from version 0.8 and beyond
|
|
# 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::Layer2::Catalyst;
|
|
|
|
use strict;
|
|
use Exporter;
|
|
use SNMP::Info::CiscoStack;
|
|
use SNMP::Info::Layer2::Cisco;
|
|
|
|
@SNMP::Info::Layer2::Catalyst::ISA
|
|
= qw/SNMP::Info::CiscoStack SNMP::Info::Layer2::Cisco Exporter/;
|
|
@SNMP::Info::Layer2::Catalyst::EXPORT_OK = qw//;
|
|
|
|
use vars qw/$VERSION %GLOBALS %MIBS %FUNCS %MUNGE/;
|
|
|
|
$VERSION = '3.26';
|
|
|
|
%MIBS = (
|
|
%SNMP::Info::Layer2::Cisco::MIBS,
|
|
%SNMP::Info::CiscoStack::MIBS,
|
|
);
|
|
|
|
%GLOBALS = (
|
|
%SNMP::Info::Layer2::Cisco::GLOBALS,
|
|
%SNMP::Info::CiscoStack::GLOBALS,
|
|
);
|
|
|
|
%FUNCS = (
|
|
%SNMP::Info::Layer2::Cisco::FUNCS,
|
|
%SNMP::Info::CiscoStack::FUNCS,
|
|
);
|
|
|
|
%MUNGE = (
|
|
%SNMP::Info::Layer2::Cisco::MUNGE,
|
|
%SNMP::Info::CiscoStack::MUNGE,
|
|
);
|
|
|
|
# Overidden Methods
|
|
|
|
# i_physical sets a hash entry as true if the iid is a physical port
|
|
sub i_physical {
|
|
my $cat = shift;
|
|
|
|
my $p_port = $cat->p_port();
|
|
|
|
my %i_physical;
|
|
foreach my $port ( keys %$p_port ) {
|
|
my $iid = $p_port->{$port};
|
|
$i_physical{$iid} = 1;
|
|
}
|
|
return \%i_physical;
|
|
}
|
|
|
|
sub vendor {
|
|
return 'cisco';
|
|
}
|
|
|
|
sub os {
|
|
return 'catalyst';
|
|
}
|
|
|
|
sub os_ver {
|
|
my $cat = shift;
|
|
my $os_ver = $cat->SUPER::os_ver();
|
|
return $os_ver if defined $os_ver;
|
|
|
|
my $m_swver = $cat->m_swver();
|
|
return unless defined $m_swver;
|
|
|
|
# assume .1 entry is the chassis and the sw version we want.
|
|
return $m_swver->{1} if defined $m_swver->{1};
|
|
return;
|
|
}
|
|
|
|
# Workaround for incomplete bp_index
|
|
sub bp_index {
|
|
my $cat = shift;
|
|
my $p_index = $cat->p_port();
|
|
my $b_index = $cat->p_oidx();
|
|
|
|
my %bp_index;
|
|
foreach my $iid ( keys %$p_index ) {
|
|
my $ifidx = $p_index->{$iid};
|
|
next unless defined $ifidx;
|
|
my $bpidx = $b_index->{$iid} || 0;
|
|
|
|
$bp_index{$bpidx} = $ifidx;
|
|
}
|
|
return \%bp_index;
|
|
}
|
|
|
|
sub cisco_comm_indexing {
|
|
return 1;
|
|
}
|
|
|
|
sub interfaces {
|
|
my $cat = shift;
|
|
my $partial = shift;
|
|
|
|
my $i_index = $cat->i_index($partial);
|
|
my $portnames = $cat->p_port() || {};
|
|
my %portmap = reverse %$portnames;
|
|
|
|
my %interfaces = ();
|
|
foreach my $iid ( keys %$i_index ) {
|
|
next unless defined $iid;
|
|
my $if = $i_index->{$iid};
|
|
$if =~ s/\./\// if $if;
|
|
my $port = $portmap{$iid};
|
|
$port =~ s/\./\// if $port;
|
|
$interfaces{$iid} = $port || $if;
|
|
}
|
|
return \%interfaces;
|
|
}
|
|
|
|
sub i_name {
|
|
my $cat = shift;
|
|
my $partial = shift;
|
|
|
|
my $p_port = $cat->p_port() || {};
|
|
my $p_name = $cat->p_name() || {};
|
|
|
|
my %i_name;
|
|
foreach my $port ( keys %$p_name ) {
|
|
my $iid = $p_port->{$port};
|
|
next unless defined $iid;
|
|
next if ( defined $partial and $iid !~ /^$partial$/ );
|
|
$i_name{$iid} = $p_name->{$port};
|
|
}
|
|
return \%i_name;
|
|
}
|
|
|
|
1;
|
|
__END__
|
|
|
|
=head1 NAME
|
|
|
|
SNMP::Info::Layer2::Catalyst - SNMP Interface to Cisco Catalyst devices
|
|
running Catalyst OS.
|
|
|
|
=head1 AUTHOR
|
|
|
|
Max Baker
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
# Let SNMP::Info determine the correct subclass for you.
|
|
my $cat = new SNMP::Info(
|
|
AutoSpecify => 1,
|
|
Debug => 1,
|
|
DestHost => 'myswitch',
|
|
Community => 'public',
|
|
Version => 2
|
|
)
|
|
or die "Can't connect to DestHost.\n";
|
|
|
|
my $class = $cat->class();
|
|
print "SNMP::Info determined this device to fall under subclass : $class\n";
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
SNMP::Info subclass to provide information for Cisco Catalyst series switches
|
|
running CatOS.
|
|
|
|
This class includes the Catalyst 2920, 4000, 5000, 6000 (hybrid mode)
|
|
families.
|
|
|
|
This subclass is not for all devices that have the name Catalyst. Note that
|
|
some Catalyst switches run IOS, like the 2900 and 3550 families. Cisco
|
|
Catalyst 1900 switches use their own MIB and have a separate subclass. Use
|
|
the method above to have SNMP::Info determine the appropriate subclass before
|
|
using this class directly.
|
|
|
|
See SNMP::Info::device_type() for specifics.
|
|
|
|
Note: Some older Catalyst switches will only talk SNMP version 1. Some
|
|
newer ones will not return all their data if connected via Version 1.
|
|
|
|
For speed or debugging purposes you can call the subclass directly, but not
|
|
after determining a more specific class using the method above.
|
|
|
|
my $cat = new SNMP::Info::Layer2::Catalyst(...);
|
|
|
|
=head2 Inherited Classes
|
|
|
|
=over
|
|
|
|
=item SNMP::Info::Layer2::Cisco
|
|
|
|
=item SNMP::Info::CiscoStack
|
|
|
|
=back
|
|
|
|
=head2 Required MIBs
|
|
|
|
=over
|
|
|
|
=item Inherited Classes' MIBs
|
|
|
|
See L<SNMP::Info::Layer2::Cisco/"Required MIBs"> for its own MIB requirements.
|
|
|
|
See L<SNMP::Info::CiscoStack/"Required MIBs"> for its own MIB requirements.
|
|
|
|
=back
|
|
|
|
These MIBs are found in the standard v2 MIBs from Cisco.
|
|
|
|
=head1 GLOBALS
|
|
|
|
These are methods that return scalar value from SNMP
|
|
|
|
=over
|
|
|
|
=item $cat->os()
|
|
|
|
Returns 'catalyst'
|
|
|
|
=item $cat->os_ver()
|
|
|
|
Tries to use the value from SNMP::Info::CiscoStats->os_ver() and if it fails
|
|
it grabs $cat->m_swver()->{1} and uses that.
|
|
|
|
=item $cat->vendor()
|
|
|
|
Returns 'cisco'
|
|
|
|
=item $cat->cisco_comm_indexing()
|
|
|
|
Returns 1. Use vlan indexing.
|
|
|
|
=back
|
|
|
|
=head2 Global Methods imported from SNMP::Info::Layer2::Cisco
|
|
|
|
See documentation in L<SNMP::Info::Layer2::Cisco/"GLOBALS"> for details.
|
|
|
|
=head2 Global Methods imported from SNMP::Info::CiscoStack
|
|
|
|
See documentation in L<SNMP::Info::CiscoStack/"GLOBALS"> for details.
|
|
|
|
=head1 TABLE METHODS
|
|
|
|
These are methods that return tables of information in the form of a reference
|
|
to a hash.
|
|
|
|
=head2 Overrides
|
|
|
|
=over
|
|
|
|
=item $cat->interfaces()
|
|
|
|
Returns the map between SNMP Interface Identifier (iid) and physical port
|
|
name.
|
|
|
|
=item $cat->i_name()
|
|
|
|
Returns reference to hash of iid to human set name.
|
|
|
|
C<portName>
|
|
|
|
=item $cat->i_physical()
|
|
|
|
Returns a map to IID for ports that are physical ports, not vlans, etc.
|
|
|
|
=item $cat->bp_index()
|
|
|
|
Returns reference to hash of bridge port table entries map back to interface
|
|
identifier (iid)
|
|
|
|
Crosses (C<portCrossIndex>) to (C<portIfIndex>) since some devices seem to
|
|
have problems with F<BRIDGE-MIB>
|
|
|
|
=back
|
|
|
|
=head2 Table Methods imported from SNMP::Info::Layer2::Cisco
|
|
|
|
See documentation in L<SNMP::Info::Layer2::Cisco/"TABLE METHODS"> for details.
|
|
|
|
=head2 Table Methods imported from SNMP::Info::CiscoStack
|
|
|
|
See documentation in L<SNMP::Info::CiscoStack/"TABLE METHODS"> for details.
|
|
|
|
=cut
|