This commit was manufactured by cvs2svn to create tag 'ver_0_3'.

Sprout from master 2003-03-06 21:56:22 UTC Max Baker 'ver_03'
Delete:
    t/prereq.t

ChangeLog

@@ -1,40 +1,17 @@
 SNMP::Info - Perl5 OO Interface to Network Devices and SNMP MIBs
 ChangeLog $Id$
 
-version 0.5 ()
-    * Added ability to get paritial tables.  For example to get the
-      IP routing table for 128.114.*  you can do 
-      $ipr = $dev->ipr_dest('128.114');
-    * Added IP Routing Table entries from RFC1213 to SNMP::Info
-
-version 0.4 (04/29/03)
-    * BIG CHANGE ! Internal Data structure has changed.  
-    * Added clear_cache() method
-    * Added NO_SUCH support for snmpget (TABLE) calls to get SNMP MIB II data 
-      from SNMP Version 1 devices.
-    * Methods load_all() and all() have changed their return value. Sorry but the API had to change.
-    * New object methods snmp_comm(), snmp_ver(), store(), class(), nosuch() to make it more OO happy.
-    * Globals are now cached
-    * Added new argument 'AutoSpecify' to new() to auto-connect with subclass 
-      detected in device_type()
-    * New method specify() returns a new subclass object
-    * Subclasses are automatically loaded when specify or autospecify is used!
-    * Added methods for Interface statistics (ifInOctets ...)
-    * Added methods for Memory and CPU statistics 
-    * Added SNMP::Info::Entity, moved out of L2-HP
-    * Added SNMP::Info::Layer2::Aironet
-
 version 0.3 (03/06/03)
     * Fixed HP model() warning
     * Added error checking for responses of NOSUCHOBJECT and NOSUCHINSTANCE in _global
       and _load_attr
     * Added more debugging
     * Added info and munging for c_capabilities in SNMP::Info::CD
-      Thanks to Martin Lorensen <martin /at- lorensen.dk>
+      Thanks to Martin Lorensen <martin@lorensen.dk>
     * Removed requirement for SNMP in the Makefile.PL and moved it to t/prereq.t
       so that the Module will install via CPAN without trying to install the old
       4.2.0 version of SNMP on CPAN.  Will now fail in the test phase. 
-      Thanks again to Martin Lorensen <martin /at- lorensen.dk>
+      Thanks again to Martin Lorensen <martin@lorensen.dk>
     * Moved tests from test.pl to t/*
 
 version 0.2 (02/19/03)

Info/Bridge.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Bridge;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 
 use strict;
@@ -44,9 +44,7 @@ $DEBUG=0;
 $SNMP::debugging=$DEBUG;
 
 $INIT = 0;
-
 %MIBS = ('BRIDGE-MIB' => 'dot1dBaseBridgeAddress');
-
 %GLOBALS = (
             'b_mac'   => 'dot1dBaseBridgeAddress',
             'b_ports' => 'dot1dBaseNumPorts',
@@ -84,7 +82,6 @@ $INIT = 0;
           # Inherit all the built in munging
           %SNMP::Info::MUNGE,
           # Add ones for our class
-          'b_mac'        => \&SNMP::Info::munge_mac,
           'fw_mac'       => \&SNMP::Info::munge_mac,
           'bs_mac'       => \&SNMP::Info::munge_mac,
           'stp_root'     => \&SNMP::Info::munge_mac,
@@ -118,7 +115,13 @@ __END__
 
 =head1 NAME
 
-SNMP::Info::Bridge - Perl5 Interface to SNMP data available through the BRIDGE-MIB (RFC1493)
+SNMP::Info::Bridge - Perl5 Interface to BRIDGE-MIB 
+
+=head1 DESCRIPTION
+
+BRIDGE-MIB is used by most Layer 2 devices like Switches 
+
+Inherits all methods from SNMP::Info
 
 =head1 AUTHOR
 
@@ -126,59 +129,40 @@ Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- my $bridge = new SNMP::Info ( 
+ my $bridge = new SNMP::Info::Bridge(DestHost  => 'myswitch',
-                             AutoSpecify => 1,
+                               Community => 'public');
-                             Debug       => 1,
+ my $mac = $bridge->mac(); 
-                             DestHost    => 'switch', 
-                             Community   => 'public',
-                             Version     => 2
-                             );
 
- my $class = $cdp->class();
+=head1 CREATING AN OBJECT
- print " Using device sub class : $class\n";
-
- # Grab Forwarding Tables
- my $interfaces = $bridge->interfaces();
- my $fw_mac     = $bridge->fw_mac();
- my $fw_port    = $bridge->fw_port();
- my $bp_index   = $bridge->bp_index();
-
- foreach my $fw_index (keys %$fw_mac){
-    my $mac   = $fw_mac->{$fw_index};
-    my $bp_id = $fw_mac->{$fw_index};
-    my $iid   = $bp_index->{$bp_id};
-    my $port  = $interfaces->{$iid};
-
-    print "Port:$port forwarding to $mac\n";
- } 
-
-=head1 DESCRIPTION
-
-BRIDGE-MIB is used by most Layer 2 devices, and holds information like the MAC Forwarding Table and Spanning Tree Protocol info.
-
-Create or use a subclass of SNMP::Info that inherits this class.  Do not use directly.
-
-For debugging you can call new() directly as you would in SNMP::Info 
-
- my $bridge = new SNMP::Info::Bridge(...);
-
-=head2 Inherited Classes
-
-None.
-
-=head2 Required MIBs
 
 =over
 
-=item BRIDGE-MIB
+=item  new SNMP::Info::Bridge()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $bridge = new SNMP::Info::Bridge(
+        DestHost => $host,
+        Community => 'public',
+        Version => 3,...
+        ) 
+    die "Couldn't connect.\n" unless defined $bridge;
+
+=item  $bridge->session()
+
+Sets or returns the SNMP::Session object
+
+    # Get
+    my $sess = $bridge->session();
+
+    # Set
+    my $newsession = new SNMP::Session(...);
+    $bridge->session($newsession);
 
 =back
 
-BRIDGE-MIB needs to be extracted from ftp://ftp.cisco.com/pub/mibs/v1/v1.tar.gz
+=head1 Bridge Global Configuration Values
-
-=head1 GLOBAL METHODS
-
-These are methods that return scalar values from SNMP
 
 =over
 
@@ -220,10 +204,7 @@ Returns root of STP.
 
 =back
 
-=head1 TABLE METHODS
+=head1 TABLE ENTRIES
-
-These are methods that return tables of information in the form of a reference
-to a hash.
 
 =head2 Forwarding Table (dot1dTpFdbEntry)
 

Info/CDP.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::CDP;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 
 use strict;
@@ -59,7 +59,7 @@ $INIT = 0;
            );
 
 %FUNCS  = (
-            'c_index'        => 'cdpCacheIfIndex',
+            'c_if'           => 'cdpCacheIfIndex',
             'c_proto'        => 'cdpCacheAddressType',
             'c_ip'           => 'cdpCacheAddress',
             'c_ver'          => 'cdpCacheVersion',
@@ -103,34 +103,6 @@ sub hasCDP {
     
     return $cdp->cdp_run();
 }
-
-sub c_if {
-    my $cdp  = shift;
-
-    # See if by some miracle Cisco implemented the cdpCacheIfIndex entry
-    my $c_index     = $cdp->c_index();
-    return $c_index if defined $c_index;
-
-    # Nope, didn't think so. Now we fake it.
-    my $c_ip = $cdp->c_ip();
-    unless (defined $c_ip){
-        $cdp->{error} = "SNMP::Info::CDP::c_if() - Device doesn't have c_ip() data.  Can't fake c_index()";
-        $DEBUG and carp($cdp->error(1));
-        return undef;
-    }
-
-    my %c_if;
-    foreach my $key (keys %$c_ip){
-      next unless defined $key;
-      my $iid = $key;
-      # Truncate .1 from cdp cache entry
-      $iid =~ s/\.\d+$//;
-      $c_if{$key} = $iid;
-    }
-
-    return \%c_if;
-}
-
 1;
 __END__
 
@@ -138,69 +110,40 @@ __END__
 
 SNMP::Info::CDP - Perl5 Interface to Cisco Discovery Protocol (CDP) using SNMP
 
-=head1 AUTHOR
-
-Max Baker (C<max@warped.org>)
-
-=head1 SYNOPSIS
-
- my $cdp = new SNMP::Info ( 
-                             AutoSpecify => 1,
-                             Debug       => 1,
-                             DestHost    => 'router', 
-                             Community   => 'public',
-                             Version     => 2
-                           );
-
- my $class = $cdp->class();
- print " Using device sub class : $class\n";
-
- $hascdp   = $cdp->hasCDP() ? 'yes' : 'no';
-
- # Print out a map of device ports with CDP neighbors:
- my $interfaces = $cdp->interfaces();
- my $c_if       = $cdp->c_if();
- my $c_ip       = $cdp->c_ip();
- my $c_port     = $cdp->c_port();
-
- foreach my $cdp_key (keys %$c_ip){
-    my $iid           = $c_if->{$cdp_key};
-    my $port          = $interfaces->{$iid};
-    my $neighbor      = $c_ip->{$cdp_key};
-    my $neighbor_port = $c_port->{$cdp_key};
-    print "Port : $port connected to $neighbor / $neighbor_port\n";
- }
-
 =head1 DESCRIPTION
 
 SNMP::Info::CDP is a subclass of SNMP::Info that provides an object oriented 
 interface to CDP information through SNMP.
 
 CDP is a Layer 2 protocol that supplies topology information of devices that also speak CDP, 
-mostly switches and routers.  CDP is implemented in Cisco and some HP devices.
+mostly switches and routers.
 
-Create or use a device subclass that inherits this class.  Do not use directly.
+=head1 AUTHOR
+
+Max Baker (C<max@warped.org>)
+
+=head1 SYNOPSIS
+
+ my $info = new SNMP::Info ( DestHost  => 'router', 
+                             Community => 'public' 
+                           );
+
+ my $type = $info->device_type();
+
+ my $cdp  = new $type ( DestHost => 'router',
+                        Community => 'public);
+
+ $hascdp = $cdp->hasCDP() ? 'yes' : 'no';
+ @neighbor_ips = values( %{$cdp->c_ip()} );
+
+See L<SNMP::Info> for all inherited methods.
+
+=head2 Your Device May Vary
 
 Each device implements a subset of the global and cache entries. 
 Check the return value to see if that data is held by the device.
 
-=head2 Inherited Classes
+=head1 CDP GLOBAL VALUES
-
-None.
-
-=head2 Required MIBs
-
-=over
-
-=item CISCO-CDP-MIB
-
-=back
-
-MIBs can be found at ftp://ftp.cisco.com/pub/mibs/v2/v2.tar.gz
-
-=head1 GLOBAL METHODS
-
-These are methods that return scalar values from SNMP
 
 =over
 
@@ -212,8 +155,7 @@ Accounts for SNMP version 1 devices which may have CDP but not cdp_run()
 
 =item $cdp->cdp_run()
 
-Is CDP enabled on this device?  Note that a lot of Cisco devices that implement
+Is CDP enabled on this device?
-CDP don't implement this value. @#%$!
 
 (B<cdpGlobalRun>)
 
@@ -239,15 +181,46 @@ This is the device id broadcast via CDP to other devices, and is what is retriev
 
 =back
 
-=head1 TABLE METHODS
+=head1 CDP CACHE ENTRIES
-
-These are methods that return tables of information in the form of a reference
-to a hash.
-
-=head2 CDP CACHE ENTRIES
 
 =over
 
+=item  $cdp->c_proto()
+
+Returns remote address type received.  Usually IP.
+
+(B<cdpCacheAddressType>)
+
+=item  $cdp->c_ip()
+
+Returns remote IP address
+
+(B<cdpCacheAddress>)
+
+=item $cdp->c_ver() 
+
+Returns remote hardware version
+
+(B<cdpCacheVersion>)
+
+=item $cdp->c_id()
+
+Returns remote device id string
+
+(B<cdpCacheDeviceId>)
+
+=item $cdp->c_port()
+
+Returns remote port ID
+
+(B<cdpDevicePort>)
+
+=item $cdp->c_platform() 
+
+Returns remote platform id 
+
+(B<cdpCachePlatform>)
+
 =item $cdp->c_capabilities()
 
 Returns Device Functional Capabilities.  Results are munged into an ascii
@@ -286,92 +259,18 @@ Returns remote VTP Management Domain as defined in CISCO-VTP-MIB::managementDoma
 
 (B<cdpCacheVTPMgmtDomain>)
 
-=item $cdp->c_duplex() 
-
-Returns the port duplex status from remote devices.
-
-(B<cdpCacheDuplex>)
-
-=item $cdp->c_id()
-
-Returns remote device id string
-
-(B<cdpCacheDeviceId>)
-
-=item $cdp->c_if()
-
-Returns the mapping to the SNMP Interface Table.
-
-Note that a lot devices don't implement $cdp->c_index(),  So if it isn't around,
-we fake it. 
-
-In order to map the cdp table entry back to the interfaces() entry, we truncate the last number
-off of it :
-
-  # it exists, yay.
-  my $c_index     = $device->c_index();
-  return $c_index if defined $c_index;
-
-  # if not, let's fake it
-  my $c_ip       = $device->c_ip();
-    
-  my %c_if
-  foreach my $key (keys %$c_ip){
-      $iid = $key;
-      ## Truncate off .1 from cdp response
-      $iid =~ s/\.\d+$//;
-      $c_if{$key} = $iid;
-  }
- 
-  return \%c_if;
-
-
-=item $cdp->c_index()
-
-Returns the mapping to the SNMP2 Interface table for CDP Cache Entries. 
-
-Most devices don't implement this, so you probably want to use $cdp->c_if() instead.
-
-See c_if() entry.
-
-(B<cdpCacheIfIndex>)
-
-=item  $cdp->c_ip()
-
-Returns remote IP address
-
-(B<cdpCacheAddress>)
-
-=item $cdp->c_platform() 
-
-Returns remote platform id 
-
-(B<cdpCachePlatform>)
-
-=item $cdp->c_port()
-
-Returns remote port ID
-
-(B<cdpDevicePort>)
-
-=item  $cdp->c_proto()
-
-Returns remote address type received.  Usually IP.
-
-(B<cdpCacheAddressType>)
-
-=item $cdp->c_ver() 
-
-Returns remote hardware version
-
-(B<cdpCacheVersion>)
-
 =item $cdp->c_vlan()
 
 Returns the remote interface native VLAN.
 
 (B<cdpCacheNativeVLAN>)
 
+=item $cdp->c_duplex() 
+
+Returns the port duplex status from remote devices.
+
+(B<cdpCacheDuplex>)
+
 =back
 
 =cut

Info/CiscoStats.pm

@@ -1,269 +0,0 @@
-# SNMP::Info::CiscoStats
-# Max Baker <max@warped.org>
-#
-# 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::CiscoStats;
-$VERSION = 0.4;
-# $Id$
-
-use strict;
-
-use Exporter;
-use SNMP::Info;
-
-use vars qw/$VERSION $DEBUG %MIBS %FUNCS %GLOBALS %MUNGE $INIT/;
-@SNMP::Info::CiscoStats::ISA = qw/SNMP::Info Exporter/;
-@SNMP::Info::CiscoStats::EXPORT_OK = qw//;
-
-$DEBUG=0;
-$SNMP::debugging=$DEBUG;
-
-$INIT    = 0;
-%MIBS    = (
-            'RFC1213-MIB'           => 'sysDescr',
-            'CISCO-PROCESS-MIB'     => 'cpmCPUTotal5sec',
-            'CISCO-MEMORY-POOL-MIB' => 'ciscoMemoryPoolUsed' 
-           );
-
-%GLOBALS = (
-            'description'  => 'sysDescr',
-            # We will use the numeric OID's so that we don't require people
-            # to install v1 MIBs, which can conflict.
-            # OLD-CISCO-CPU-MIB:avgBusyPer
-            'ios_cpu'      => '1.3.6.1.4.1.9.2.1.56.0',
-            'ios_cpu_1min' => '1.3.6.1.4.1.9.2.1.57.0',
-            'ios_cpu_5min' => '1.3.6.1.4.1.9.2.1.58.0',
-            # CISCO-PROCESS-MIB
-            'cat_cpu'      => 'cpmCPUTotal5sec.9',
-            'cat_cpu_1min' => 'cpmCPUTotal1min.9',
-            'cat_cpu_5min' => 'cpmCPUTotal5min.9',
-            # CISCO-MEMORY-POOL-MIB
-            'mem_free'     => 'ciscoMemoryPoolFree.1',
-            'mem_used'     => 'ciscoMemoryPoolUsed.1',
-           );
-
-%FUNCS   = (
-           );
-
-%MUNGE   = (
-           );
-
-sub os {
-    my $l2 = shift;
-    my $descr = $l2->description();
-
-    return 'catalyst' if ($descr =~ /catalyst/i);
-    return 'ios'      if ($descr =~ /IOS/);
-    return undef;
-}
-
-sub os_ver {
-    my $l2    = shift;
-    my $os    = $l2->os();
-    my $descr = $l2->description();
-    
-    # Older Catalysts
-    if ($os eq 'catalyst' and $descr =~ m/V(\d{1}\.\d{2}\.\d{2})/){
-        return $1;
-    }
-
-    # Newer Catalysts and IOS devices
-    if ($descr =~ m/Version (\d+\.\d+\([^)]+\)[^,\s]*)(,|\s)+/ ){
-        return $1;
-    } 
-    return undef;
-}
-
-sub cpu {
-    my $self = shift;
-    my $ios_cpu = $self->ios_cpu();
-    return $ios_cpu if defined $ios_cpu;
-    my $cat_cpu = $self->cat_cpu();
-    return $cat_cpu;
-}
-
-sub cpu_1min {
-    my $self = shift;
-    my $ios_cpu_1min = $self->ios_cpu_1min();
-    return $ios_cpu_1min if defined $ios_cpu_1min;
-    my $cat_cpu_1min = $self->cat_cpu_1min();
-    return $cat_cpu_1min;
-}
-
-sub cpu_5min {
-    my $self = shift;
-    my $ios_cpu_5min = $self->ios_cpu_5min();
-    return $ios_cpu_5min if defined $ios_cpu_5min;
-    my $cat_cpu_5min = $self->cat_cpu_5min();
-    return $cat_cpu_5min;
-}
-
-sub mem_total {
-    my $self = shift;
-    my $mem_free = $self->mem_free();
-    my $mem_used = $self->mem_used();
-    return undef unless defined $mem_free and defined $mem_used;
-    return $mem_free + $mem_used;
-}
-
-1;
-__END__
-
-=head1 NAME
-
-SNMP::Info::CiscoStats - Perl5 Interface to CPU and Memory stats for Cisco Devices
-
-=head1 AUTHOR
-
-Max Baker (C<max@warped.org>)
-
-=head1 SYNOPSIS
-
- # Let SNMP::Info determine the correct subclass for you. 
- my $ciscostats = 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      = $ciscostats->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
-
-=head1 DESCRIPTION
-
-SNMP::Info::CiscoStats is a subclass of SNMP::Info that provides cpu, memory, os and
-version information about Cisco Devices. 
-
-Use or create in a subclass of SNMP::Info.  Do not use directly.
-
-=head2 Inherited Classes
-
-none.
-
-=head2 Required MIBs
-
-=over
-
-=item CISCO-PROCESS-MIB
-
-=item CISCO-MEMORY-POOL-MIB
-
-=item RFC1213-MIB
-
-=back
-
-MIBs can be found at ftp://ftp.cisco.com/pub/mibs/v2/v2.tar.gz
-
-=head1 GLOBALS
-
-=over
-
-=item $ciscostats->cpu()
-
-Returns ios_cpu() or cat_cpu(), whichever is available.
-
-=item $ciscostats->cpu_1min()
-
-Returns ios_cpu_1min() or cat_cpu1min(), whichever is available.
-
-=item $ciscostats->cpu_5min()
-
-Returns ios_cpu_5min() or cat_cpu5min(), whichever is available.
-
-=item $ciscostats->mem_total()
-
-Returns mem_free() + mem_used()
-
-=item $ciscostats->os()
-
-Trys to parse if device is running IOS or CatOS from description()
-
-=item $ciscostats->os_ver()
-
-Trys to parse device operating system version from description()
-
-=item $ciscostats->ios_cpu()
-
-Current CPU usage in percents of device.
-
-B<1.3.6.1.4.1.9.2.1.56.0> = 
-B<OLD-CISCO-CPU-MIB:avgBusyPer>
-
-=item $ciscostats->ios_cpu_1min()
-
-Average CPU Usage in percents of device over last minute.
-
-B<1.3.6.1.4.1.9.2.1.57.0>
-
-=item $ciscostats->ios_cpu_5min()
-
-Average CPU Usage in percents of device over last 5 minutes.
-
-B<1.3.6.1.4.1.9.2.1.58.0>
-
-=item $ciscostats->cat_cpu()
-
-Current CPU usage in percents of device.
-
-B<CISCO-PROCESS-MIB::cpmCPUTotal5sec.9>
-
-=item $ciscostats->cat_cpu_1min()
-
-Average CPU Usage in percents of device over last minute.
-
-B<CISCO-PROCESS-MIB::cpmCPUTotal1min.9>
-
-=item $ciscostats->cat_cpu_5min()
-
-Average CPU Usage in percents of device over last 5 minutes.
-
-B<CISCO-PROCESS-MIB::cpmCPUTotal5min.9>
-
-=item $ciscostats->mem_free()
-
-Main DRAM free in device.  In bytes.
-
-B<CISCO-MEMORY-POOL-MIB::ciscoMemoryPoolFree.1>
-
-=item $ciscostats->mem_used()
-
-Main DRAM used in device.  In bytes.
-
-B<CISCO-MEMORY-POOL-MIB::ciscoMemoryPoolUsed.1>
-
-=back
-
-=head1 TABLE METHODS
-
-None.
-
-=cut

Info/Entity.pm

@@ -1,198 +0,0 @@
-# SNMP::Info::Entity
-# Max Baker <max@warped.org>
-#
-# 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::Entity;
-$VERSION = 0.4;
-# $Id$
-
-use strict;
-
-use Exporter;
-use SNMP::Info;
-
-use vars qw/$VERSION $DEBUG %MIBS %FUNCS %GLOBALS %MUNGE $INIT/;
-@SNMP::Info::Entity::ISA = qw/SNMP::Info Exporter/;
-@SNMP::Info::Entity::EXPORT_OK = qw//;
-
-$INIT    = 0;
-%MIBS    = ('ENTITY-MIB' => 'entPhysicalSerialNum');
-
-%GLOBALS = (
-           );
-
-%FUNCS   = (
-            'e_class'   => 'entPhysicalClass',
-            'e_descr'   => 'entPhysicalDescr',
-            'e_fwver'   => 'entPhysicalFirmwareRev',
-            'e_hwver'   => 'entPhysicalHardwareRev',
-            'e_map'     => 'entAliasMappingIdentifier',
-            'e_model'   => 'entPhysicalModelName',
-            'e_name'    => 'entPhysicalName',
-            'e_parent'  => 'entPhysicalContainedIn',
-            'e_serial'  => 'entPhysicalSerialNum',
-            'e_swver'   => 'entPhysicalSoftwareRev',
-            'e_type'    => 'entPhysicalVendorType',
-           );
-
-%MUNGE   = (
-           );
-
-sub e_port {
-    my $entity = shift;
-    my $e_map  = $entity->e_map();
-
-    my %e_port;
-
-    foreach my $e_id (keys %$e_map) {
-        my $id = $e_id;
-        $id =~ s/\.0$//;
-
-        my $iid = $e_map->{$e_id};
-        $iid =~ s/.*\.//;
-
-        $e_port{$id} = $iid;
-    }
-
-    return \%e_port;
-}
-1;
-
-=head1 NAME
-
-SNMP::Info::Entity - Perl5 Interface to SNMP data stored in ENTITY-MIB.
-
-=head1 AUTHOR
-
-Max Baker (C<max@warped.org>)
-
-=head1 SYNOPSIS
-
- # Let SNMP::Info determine the correct subclass for you. 
- my $entity = 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      = $entity->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
-
-=head1 DESCRIPTION
-
-ENTITY-MIB is used by some Layer 2 devices like HP Switches and Aironet Access Points
-
-Create or use a device subclass that inherit this class.  Do not use directly.
-
-For debugging purposes you can call this class directly as you would SNMP::Info
-
- my $entity = new SNMP::Info::Entity (...);
-
-=head2 Inherited Classes
-
-none.
-
-=head2 Required MIBs
-
-=over
-
-=item ENTITY-MIB
-
-=back
-
-MIBs can be found at ftp://ftp.cisco.com/pub/mibs/v2/v2.tar.gz
-
-=head1 GLOBALS
-
-none.
-
-=head1 TABLE METHODS
-
-These are methods that return tables of information in the form of a reference
-to a hash.
-
-=head2 Entity Table
-
-=over
-
-=item $entity->e_class()
-
-(C<entPhysicalClass>)
-
-=item $entity->e_descr()
-
-(C<entPhysicalClass>)
-
-=item $entity->e_fwver()
-
-(C<entPhysicalFirmwareRev>)
-
-=item $entity->e_hwver()
-
-(C<entPhysicalHardwareRev>)
-
-=item $entity->e_map()
-
-(C<entAliasMappingIdentifier>)
-
-=item $entity->e_model()
-
-(C<entPhysicalModelName>)
-
-=item $entity->e_name()
-
-(C<entPhysicalName>)
-
-=item $entity->e_parent()
-
-(C<entPhysicalContainedIn>)
-
-=item $entity->e_port()
-
-Maps EntityTable entries to the Interface Table (IfTable) using
-$entity->e_map()
-
-=item $entity->e_serial()
-
-(C<entPhysicalSerialNum>)
-
-=item $entity->e_swver()
-
-(C<entPhysicalSoftwareRev>)
-
-=item $entity->e_type()
-
-(C<entPhysicalVendorType>)
-
-=back
-
-=cut

Info/EtherLike.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::EtherLike;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 
 use strict;
@@ -52,25 +52,8 @@ $INIT = 0;
 
 %FUNCS = (
           # EtherLike StatsTable
-          'el_chipset'         => 'dot3StatsEtherChipSet',
-          'el_coll_excess'     => 'dot3StatsExcessiveCollisions',
-          'el_coll_late'       => 'dot3StatsLateCollisions',
-          'el_coll_mult'       => 'dot3StatsMultipleCollisionFrames',
-          'el_coll_single'     => 'dot3StatsSingleCollisionFrames',
-          'el_duplex'          => 'dot3StatsDuplexStatus',
-          'el_error_alignment' => 'dot3StatsAlignmentErrors',
-          'el_error_fcs'       => 'dot3StatsFCSErrors',
-          'el_error_cs'        => 'dot3StatsCarrierSenseErrors',
-          'el_error_frame'     => 'dot3StatsFrameTooLongs',
-          'el_error_mac_rec'   => 'dot3StatsInternalMacReceiveErrors',
-          'el_error_mac_xmit'  => 'dot3StatsInternalMacTransmitErrors',
-          'el_error_sqe'       => 'dot3StatsSQETestErrors',
-          'el_error_symbol'    => 'dot3StatsSymbolErrors',
           'el_index'  => 'dot3StatsIndex',
-          'el_xmit_defer'      => 'dot3StatsDeferredTransmissions',
+          'el_duplex' => 'dot3StatsDuplexStatus',
-          # Ethernet-like Collision Statistics Group
-          'el_coll_count'      => 'dot3CollCount',
-          'el_coll_freq'       => 'dot3CollFrequencies'
           );
 
 %MUNGE = ( %SNMP::Info::MUNGE );
@@ -83,77 +66,52 @@ __END__
 
 SNMP::Info::EtherLike - Perl5 Interface to SNMP ETHERLIKE-MIB 
 
+=head1 DESCRIPTION
+
+SNMP::Info::EtherLike is a subclass of SNMP::Info that supplies 
+access to the ETHERLIKE-MIB used by some Layer 3 Devices such as Cisco routers.
+
+Use SNMP::Info directly, or create a subclass that inherits this one.
+
 =head1 AUTHOR
 
 Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- my $el = new SNMP::Info ( 
+ my $el = new SNMP::Info::EtherLike(DestHost  => 'myrouter',
-                             AutoSpecify => 1,
+                                    Community => 'public');
-                             Debug       => 1,
-                             DestHost    => 'router', 
-                             Community   => 'public',
-                             Version     => 2
-                           );
 
- my $class = $cdp->class();
+ my $el_decoder = $el->el_index();
- print " Using device sub class : $class\n";
-
- # Find the duplex setting for a port on a device that implements ETHERLIKE-MIB
- my $interfaces = $el->interfaces();
- my $el_index   = $el->el_index();
  my $el_duplex = $el->el_duplex(); 
 
- foreach my $el_port (keys %$el_duplex){
+=head1 CREATING AN OBJECT
-    my $duplex = $el_duplex->{$el_port};
-    my $iid    = $el_index->{$el_port};
-    my $port   = $interfaces->{$iid};
-
-    $duplex = 'half' if $duplex =~/half/i;
-    $duplex = 'full' if $duplex =~/full/i;
-    $duplex = 'auto' if $duplex =~/auto/i;
-
-    print "PORT:$port set to duplex:$duplex\n";
- }
-
-=head1 DESCRIPTION
-
-SNMP::Info::EtherLike is a subclass of SNMP::Info that supplies 
-access to the ETHERLIKE-MIB used by some Layer 3 Devices such as Cisco routers.
-
-Use or create a subclass of SNMP::Info that inherits this one.  Do not use directly.
-
-=head2 Inherited Classes
-
-None.  
-
-=head2 Required MIBs
 
 =over
 
-=item ETHERLIKE-MIB
+=item  new SNMP::Info::EtherLike()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $el = new SNMP::Info::EtherLike(
+        DestHost => $host,
+        Community => 'public',
+        Version => 3,...
+        ) 
+    die "Couldn't connect.\n" unless defined $el;
 
 =back
 
-MIBs can be found at ftp://ftp.cisco.com/pub/mibs/v2/v2.tar.gz
-
 =head1 GLOBALS
 
-These are methods that return scalar values from SNMP
-
 =over
 
 =item None
 
 =back
 
-=head1 TABLE METHODS
+=head1 ETHERLIKE STATS TABLE (dot3StatsTable)
-
-These are methods that return tables of information in the form of a reference
-to a hash.
-
-=head2 ETHERLIKE STATS TABLE (dot3StatsTable)
 
 =over
 
@@ -169,70 +127,6 @@ Returns reference to hash.  Indexes Stats Table to Duplex Status of port.
 
 (B<dot3StatsDuplexStatus>)
 
-=item $el->el_chipset()
-
-(B<dot3StatsEtherChipSet>)
-
-=item $el->el_coll_excess()
-
-(B<dot3StatsExcessiveCollisions>)
-
-=item $el->el_coll_late()
-
-(B<dot3StatsLateCollisions>)
-
-=item $el->el_coll_mult()
-
-(B<dot3StatsMultipleCollisionFrames>)
-
-=item $el->el_coll_single()
-
-(B<dot3StatsSingleCollisionFrames>)
-
-=item $el->el_error_alignment()
-
-(B<dot3StatsAlignmentErrors>)
-
-=item $el->el_error_fcs()
-
-(B<dot3StatsFCSErrors>)
-
-=item $el->el_error_cs()
-
-(B<dot3StatsCarrierSenseErrors>)
-
-=item $el->el_error_frame()
-
-(B<dot3StatsFrameTooLongs>)
-
-=item $el->el_error_mac_rec()
-
-(B<dot3StatsInternalMacReceiveErrors>)
-
-=item $el->el_error_mac_xmit()
-
-(B<dot3StatsInternalMacTransmitErrors>)
-
-=item $el->el_error_sqe()
-
-(B<dot3StatsSQETestErrors>)
-
-=item $el->el_error_symbol()
-
-(B<dot3StatsSymbolErrors>)
-
-=item $el->el_xmit_defer()
-
-(B<dot3StatsDeferredTransmissions>)
-
-=item $el->el_coll_count()
-
-(B<dot3CollCount>)
-
-=item $el->el_coll_freq()
-
-(B<dot3CollFrequencies>)
-
 =back
 
 =cut

Info/Layer1.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Layer1;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 
 use strict;
@@ -163,7 +163,22 @@ __END__
 
 =head1 NAME
 
-SNMP::Info::Layer1 - Perl5 Interface to network devices serving Layer1 only.
+SNMP::Info::Layer1 - Perl5 Interface to Layer1 network devices.
+
+=head1 DESCRIPTION
+
+Provides abstraction to the configuration information obtainable from a 
+Layer1 device through SNMP.  Information is stored in a number of MIBs.
+
+Inherits from: 
+
+ SNMP::Info
+
+MIBS: 
+
+ MIBS listed in SNMP::Info
+
+Cisco MIBs can be found at ftp://ftp.cisco.com/pub/mibs/v2/v2.tar.gz
 
 =head1 AUTHOR
 
@@ -171,89 +186,41 @@ Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- # Let SNMP::Info determine the correct subclass for you. 
+ my $l1 = new SNMP::Info::Layer1(DestHost  => 'mybridge' , 
- my $l1 = new SNMP::Info(
+                              Community => 'public' ); 
-                          AutoSpecify => 1,
+
-                          Debug       => 1,
+=head1 CREATING AN OBJECT
-                          # These arguments are passed directly on to SNMP::Session
+
-                          DestHost    => 'myswitch',
+=over
+
+=item  new SNMP::Info::Layer1()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $l1 = new SNMP::Info::Layer1(
+        DestHost => $host,
         Community => 'public',
-                          Version     => 1
+        Version => 3,...
         ) 
-    or die "Can't connect to DestHost.\n";
+    die "Couldn't connect.\n" unless defined $l1;
-
- my $class      = $l1->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
-
- # Let's get some basic Port information
- my $interfaces = $l1->interfaces();
- my $i_up       = $l1->i_up();
- my $i_speed    = $l1->i_speed();
-
- foreach my $iid (keys %$interfaces) {
-    my $port  = $interfaces->{$iid};
-    my $up    = $i_up->{$iid};
-    my $speed = $i_speed->{$iid}
-    print "Port $port is $up. Port runs at $speed.\n";
- }
-
-=head1 DESCRIPTION
-
-This class is usually used as a superclass for more specific device classes listed under 
-SNMP::Info::Layer1::*   Please read all docs under SNMP::Info first.
-
-Provides abstraction to the configuration information obtainable from a 
-Layer1 device through SNMP.  Information is stored in a number of MIBs.
-
-For speed or debugging purposes you can call the subclass directly, but not after determining
-a more specific class using the method above. 
-
- my $l1 = new SNMP::Info::Layer1(...);
-
-=head2 Inherited Classes 
-
-=over
-
-=item SNMP::Info
 
 =back
 
-=head2 Required MIBs 
-
-=over
-
-=item SNMP-REPEATER-MIB
-
-=item Inherited Classes
-
-MIBs required for SNMP::Info
-
-=back
-
-SNMP-REPEATER-MIB needs to be extracted from ftp://ftp.cisco.com/pub/mibs/v1/v1.tar.gz
-
 =head1 GLOBALS
 
-These are methods that return scalar value from SNMP
-
-=over
-
-=item $l1->ports_managed()
-
-Gets the number of ports under the interface mib 
-
-(B<ifNumber>)
-
-=back
-
-=head2 Overrides
-
 =over
 
 =item $l1->vendor()
 
 Trys to discover the vendor from $l1->model() and $l1->vendor()
 
+=item $l1->ports_managed()
+
+Gets the number of ports under the interface mib 
+
+(B<ifNumber>)
+
 =item $l1->ports()
 
 Adds the values from rptr_ports() and ports_managed()
@@ -266,15 +233,8 @@ Number of 'groups' in the Repeater MIB
 
 =back
 
-=head2 Globals imported from SNMP::Info
-
-See documentation in SNMP::Info for details.
-
 =head1 TABLE ENTRIES
 
-These are methods that return tables of information in the form of a reference
-to a hash.
-
 =head2 Overrides
 
 =over
@@ -319,8 +279,4 @@ Group (slot) Number for given port.
 
 =back
 
-=head2 Table Methods imported from SNMP::Info
-
-See documentation in SNMP::Info for details.
-
 =cut

Info/Layer1/Allied.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Layer1::Allied;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 use strict;
 
@@ -64,19 +64,6 @@ sub vendor {
     return 'allied';
 }
 
-sub os {
-    return 'allied';
-}
-
-sub os_ver {
-    my $allied = shift;
-    my $descr = $allied->description();
-    
-    if ($descr =~ m/version (\d+\.\d+)/){
-        return $1;
-    }
-}
-
 sub model {
     my $allied = shift;
 
@@ -124,74 +111,57 @@ __END__
 
 SNMP::Info::Layer1::Allied - SNMP Interface to old Allied Hubs
 
-=head1 AUTHOR
-
-Max Baker (C<max@warped.org>)
-
-=head1 SYNOPSIS
-
- # Let SNMP::Info determine the correct subclass for you. 
- my $allied = new SNMP::Info(
-                          AutoSpecify => 1,
-                          Debug       => 1,
-                          # These arguments are passed directly on to SNMP::Session
-                          DestHost    => 'myhub',
-                          Community   => 'public',
-                          Version     => 1
-                        ) 
-    or die "Can't connect to DestHost.\n";
-
- my $class      = $l1->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
-
 =head1 DESCRIPTION
 
 Provides abstraction to the configuration information obtainable from a 
 Allied device through SNMP. See inherited classes' documentation for 
 inherited methods.
 
-=head2 Inherited Classes
+Inherits from:
+
+ SNMP::Info::Layer1
+
+Required MIBs:
+
+ ATI-MIB - Download for your device from http://www.allied-telesyn.com/allied/support/
+
+ MIBs listed in SNMP::Info::Layer1
+
+=head1 AUTHOR
+
+Max Baker (C<max@warped.org>)
+
+=head1 SYNOPSIS
+
+ my $allied = new SNMP::Info::Layer1::Allied(DestHost  => 'mycat1900' , 
+                              Community => 'public' ); 
+
+=head1 CREATING AN OBJECT
 
 =over
 
-=item SNMP::Info::Layer1
+=item  new SNMP::Info::Layer1::Allied()
 
-=back
+Arguments passed to new() are passed on to SNMP::Session::new()
     
-=head2 Required MIBs
 
-=over
+    my $allied = new SNMP::Info::Layer1::Allied(
-
+        DestHost => $host,
-=item ATI-MIB 
+        Community => 'public',
-
+        Version => 3,...
-Download for your device from http://www.allied-telesyn.com/allied/support/
+        ) 
-
+    die "Couldn't connect.\n" unless defined $allied;
-=item Inherited Classes
-
-MIBs listed in SNMP::Info::Layer1 and its inherited classes.
 
 =back
 
 =head1 GLOBALS
 
-These are methods that return scalar value from SNMP
-
-=head2 Overrides
-
 =over
 
 =item $allied->vendor()
 
 Returns 'allied' :)
 
-=item $allied->os()
-
-Returns 'allied' 
-
-=item $allied->os_ver()
-
-Culls Version from description()
-
 =item $allied->root_ip()
 
 Returns IP Address of Managed Hub.
@@ -204,10 +174,6 @@ Trys to cull out AT-nnnnX out of the description field.
 
 =back
 
-=head2 Global Methods imported from SNMP::Info::Layer1
-
-See documentation in SNMP::Info::Layer1 for details.
-
 =head1 TABLE ENTRIES
 
 =head2 Overrides
@@ -239,8 +205,4 @@ the values of ati_up() to 'up' and 'down'.
 
 =back
 
-=head2 Table Methods imported from SNMP::Info::Layer1
-
-See documentation in SNMP::Info::Layer1 for details.
-
 =cut

Info/Layer1/Asante.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Layer1::Asante;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 use strict;
 
@@ -80,19 +80,6 @@ sub interfaces {
     return \%interfaces;
 }
 
-sub os {
-    return 'asante';
-}
-
-sub os_ver {
-    my $asante = shift;
-    my $descr = $asante->description();
-    
-    if ($descr =~ /software v(\d+\.\d+)/){
-        return $1;
-    }
-}
-    
 sub vendor {
     return 'asante';
 }
@@ -167,65 +154,53 @@ __END__
 
 SNMP::Info::Layer1::Asante - SNMP Interface to old Asante 1012 Hubs
 
+=head1 DESCRIPTION
+
+Provides abstraction to the configuration information obtainable from a 
+Asante device through SNMP. See inherited classes' documentation for 
+inherited methods.
+
+Inherits from:
+
+ SNMP::Info::Layer1
+
+Required MIBs:
+
+ASANTE-HUB1012-MIB - Download from http://www.mibdepot.com
+
+ MIBs listed in SNMP::Info::Layer1
+
 =head1 AUTHOR
 
 Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- # Let SNMP::Info determine the correct subclass for you. 
+ my $asante = new SNMP::Info::Layer1::Asante(DestHost  => 'mycat1900' , 
- my $asante = new SNMP::Info(
+                              Community => 'public' ); 
-                          AutoSpecify => 1,
+
-                          Debug       => 1,
+=head1 CREATING AN OBJECT
-                          # These arguments are passed directly on to SNMP::Session
+
-                          DestHost    => 'myswitch',
+=over
+
+=item  new SNMP::Info::Layer1::Asante()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $asante = new SNMP::Info::Layer1::Asante(
+        DestHost => $host,
         Community => 'public',
-                          Version     => 2
+        Version => 3,...
         ) 
-    or die "Can't connect to DestHost.\n";
+    die "Couldn't connect.\n" unless defined $asante;
-
- my $class      = $asante->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
-
-=head1 DESCRIPTION
-
-Provides abstraction to the configuration information obtainable from a 
-Asante device through SNMP.
-
-=head2 Inherited Classes
-
-=over
-
-=item SNMP::Info::Layer1
-
-=back
-
-=head2 Required MIBs
-
-=over
-
-=item ASANTE-HUB1012-MIB
-
-Download from http://www.mibdepot.com
-
-=item MIBs listed in SNMP::Info::Layer1
 
 =back
 
 =head1 GLOBALS
 
-=head2 Overrides
-
 =over
 
-=item $asante->os()
-
-Returns 'asante'
-
-=item $asante->os_ver()
-
-Culls software version from description()
-
 =item $asante->vendor()
 
 Returns 'asante' :)
@@ -242,10 +217,6 @@ Trys to cull out AT-nnnnX out of the description field.
 
 =back
 
-=head2 Globals inherited from SNMP::Info::Layer1
-
-See documentation in SNMP::Info::Layer1 for details.
-
 =head1 TABLE ENTRIES
 
 =head2 Overrides
@@ -277,8 +248,4 @@ the values of ati_up() to 'up' and 'down'.
 
 =back
 
-=head2 Table Methods imported from SNMP::Info::Layer1
-
-See documentation in SNMP::Info::Layer1 for details.
-
 =cut

Info/Layer2.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Layer2;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 
 use strict;
@@ -37,11 +37,10 @@ use Exporter;
 use SNMP::Info;
 use SNMP::Info::Bridge;
 use SNMP::Info::CDP;
-use SNMP::Info::CiscoStats;
 
 use vars qw/$VERSION $DEBUG %GLOBALS %MIBS %FUNCS %PORTSTAT %MUNGE $INIT/;
 
-@SNMP::Info::Layer2::ISA = qw/SNMP::Info SNMP::Info::Bridge SNMP::Info::CDP SNMP::Info::CiscoStats Exporter/;
+@SNMP::Info::Layer2::ISA = qw/SNMP::Info SNMP::Info::Bridge SNMP::Info::CDP Exporter/;
 @SNMP::Info::Layer2::EXPORT_OK = qw//;
 
 $DEBUG=0;
@@ -54,23 +53,21 @@ $INIT = 0;
 %MIBS = ( %SNMP::Info::MIBS, 
           %SNMP::Info::Bridge::MIBS,
           %SNMP::Info::CDP::MIBS,
-          %SNMP::Info::CiscoStats::MIBS,
           'CISCO-PRODUCTS-MIB' => 'sysName',
           'CISCO-STACK-MIB'    => 'wsc1900sysID',
+#          'HP-ICF-OID'         => 'hpSwitch4000',
         );
 
 %GLOBALS = (
             %SNMP::Info::GLOBALS,
             %SNMP::Info::Bridge::GLOBALS,
             %SNMP::Info::CDP::GLOBALS,
-            %SNMP::Info::CiscoStats::GLOBALS,
             );
 
 %FUNCS   = (
             %SNMP::Info::FUNCS,
             %SNMP::Info::Bridge::FUNCS,
             %SNMP::Info::CDP::FUNCS,
-            %SNMP::Info::CiscoStats::FUNCS,
            );
 
 %MUNGE = (
@@ -78,7 +75,6 @@ $INIT = 0;
             %SNMP::Info::MUNGE,
             %SNMP::Info::Bridge::MUNGE,
             %SNMP::Info::CDP::MUNGE,
-            %SNMP::Info::CiscoStats::MUNGE,
          );
 
 # Method OverRides
@@ -164,7 +160,31 @@ __END__
 
 =head1 NAME
 
-SNMP::Info::Layer2 - Perl5 Interface to network devices serving Layer2 only.
+SNMP::Info::Layer2 - Perl5 Interface to Layer2 network devices.
+
+=head1 DESCRIPTION
+
+Provides abstraction to the configuration information obtainable from a 
+Layer2 device through SNMP.  Information is stored in a number of MIBs.
+
+See super classes for descriptions of other available methods.
+
+Inherits from: 
+
+ SNMP::Info
+ SNMP::Info::Bridge
+ SNMP::Info::CDP
+
+MIBS: 
+
+ CISCO-PRODUCTS-MIB - Needed for ID of Cisco Products
+ CISCO-STACK-MIB    - Needed for ID of Cisco Products
+ ##HP-ICF-OID         - Needed for ID of HP    Products
+ MIBS listed in SNMP::Info::Bridge and SNMP::Info::CDP
+
+Cisco MIBs can be found at ftp://ftp.cisco.com/pub/mibs/v2/v2.tar.gz
+
+HP MIBs can be found at http://www.hp.com/rnd/software
 
 =head1 AUTHOR
 
@@ -172,90 +192,35 @@ Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- # Let SNMP::Info determine the correct subclass for you. 
+ my $l2 = new SNMP::Info::Layer2(DestHost  => 'mybridge' , 
- my $l2 = new SNMP::Info(
+                              Community => 'public' ); 
-                          AutoSpecify => 1,
+
-                          Debug       => 1,
+=head1 CREATING AN OBJECT
-                          # These arguments are passed directly on to SNMP::Session
+
-                          DestHost    => 'myswitch',
+=over
+
+=item  new SNMP::Info::Layer2()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $l2 = new SNMP::Info::Layer2(
+        DestHost => $host,
         Community => 'public',
-                          Version     => 2
+        Version => 3,...
         ) 
-    or die "Can't connect to DestHost.\n";
+    die "Couldn't connect.\n" unless defined $l2;
-
- my $class      = $l2->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
-
- # Let's get some basic Port information
- my $interfaces = $l2->interfaces();
- my $i_up       = $l2->i_up();
- my $i_speed    = $l2->i_speed();
- foreach my $iid (keys %$interfaces) {
-    my $port  = $interfaces->{$iid};
-    my $up    = $i_up->{$iid};
-    my $speed = $i_speed->{$iid}
-    print "Port $port is $up. Port runs at $speed.\n";
- }
-
-=head1 DESCRIPTION
-
-This class is usually used as a superclass for more specific device classes listed under 
-SNMP::Info::Layer2::*   Please read all docs under SNMP::Info first.
-
-Provides abstraction to the configuration information obtainable from a 
-Layer2 device through SNMP.  Information is stored in a number of MIBs.
-
-For speed or debugging purposes you can call the subclass directly, but not after determining
-a more specific class using the method above. 
-
- my $l2 = new SNMP::Info::Layer2(...);
-
-=head2 Inherited Classes
-
-=over
-
-=item SNMP::Info
-
-=item SNMP::Info::Bridge
-
-=item SNMP::Info::CDP
-
-=item SNMP::Info::CiscoStats
 
 =back
 
-=head2 Required MIBs
-
-=over
-
-=item CISCO-PRODUCTS-MIB 
-
-Needed for ID of Cisco Products
-
-=item CISCO-STACK-MIB
-
-Needed for ID of Cisco Products
-
-=item Inherited Classes
-
-MIBs required by the inherited classes listed above.
-
-=back
-
-MIBs can be found at ftp://ftp.cisco.com/pub/mibs/v2/v2.tar.gz
-
 =head1 GLOBALS
 
-These are methods that return scalar value from SNMP
-
-=head2 Overrides
-
 =over
 
 =item $l2->model()
 
 Cross references $l2->id() with product IDs in the 
-Cisco MIBs.
+Cisco and HP specific MIBs.
 
 For HP devices, removes 'hpswitch' from the name
 
@@ -263,30 +228,11 @@ For Cisco devices, removes 'sysid' from the name
 
 =item $l2->vendor()
 
-Trys to discover the vendor from $l2->model() and $l2->description()
+Trys to discover the vendor from $l2->model() and $l2->vendor()
 
 =back
 
-=head2 Globals imported from SNMP::Info
+=head1 TABLE ENTRIES
-
-See documentation in SNMP::Info for details.
-
-=head2 Globals imported from SNMP::Info::Bridge
-
-See documentation in SNMP::Info::Bridge for details.
-
-=head2 Globals imported from SNMP::Info::CDP
-
-See documentation in SNMP::Info::CDP for details.
-
-=head2 Globals imported from SNMP::Info::CiscoStats
-
-See documentation in SNMP::Info::CiscoStats for details.
-
-=head1 TABLE METHODS
-
-These are methods that return tables of information in the form of a reference
-to a hash.
 
 =head2 Overrides
 
@@ -306,20 +252,4 @@ Ignores ports with B<ifType> of loopback,propvirtual,other, and cpu
 
 =back
 
-=head2 Table Methods imported from SNMP::Info
-
-See documentation in SNMP::Info for details.
-
-=head2 Table Methods imported from SNMP::Info::Bridge
-
-See documentation in SNMP::Info::Bridge for details.
-
-=head2 Table Methods imported from SNMP::Info::CDP
-
-See documentation in SNMP::Info::CDP for details.
-
-=head2 Table Methods imported from SNMP::Info::CiscoStats
-
-See documentation in SNMP::Info::CiscoStats for details.
-
 =cut

Info/Layer2/Aironet.pm

@@ -1,238 +0,0 @@
-# SNMP::Info::Layer2::Aironet
-# Max Baker <max@warped.org>
-#
-# 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::Layer2::Aironet;
-$VERSION = 0.4;
-# $Id$
-use strict;
-
-use Exporter;
-use SNMP::Info::Layer2;
-use SNMP::Info::Entity;
-use SNMP::Info::EtherLike;
-
-@SNMP::Info::Layer2::Aironet::ISA = qw/SNMP::Info::Layer2 SNMP::Info::Entity SNMP::Info::EtherLike Exporter/;
-@SNMP::Info::Layer2::Aironet::EXPORT_OK = qw//;
-
-use vars qw/$VERSION %FUNCS %GLOBALS %MIBS %MUNGE $AUTOLOAD $INIT $DEBUG/;
-
-# Set for No CDP
-%GLOBALS = (
-            %SNMP::Info::Layer2::GLOBALS,
-            %SNMP::Info::Entity::GLOBALS,
-            %SNMP::Info::EtherLike::GLOBALS,
-            'serial' => 'entPhysicalSerialNum.1',
-            'descr'  => 'sysDescr'
-            );
-
-%FUNCS   = (%SNMP::Info::Layer2::FUNCS,
-            %SNMP::Info::Entity::FUNCS,
-            %SNMP::Info::EtherLike::FUNCS
-            );
-
-%MIBS    = (
-            %SNMP::Info::Layer2::MIBS,
-            %SNMP::Info::Entity::MIBS,
-            %SNMP::Info::EtherLike::MIBS
-            );
-
-%MUNGE   = (%SNMP::Info::Layer2::MUNGE,
-            %SNMP::Info::Entity::MUNGE,
-            %SNMP::Info::EtherLike::MUNGE
-            );
-
-
-sub vendor {
-    # Sorry, but it's true.
-    return 'cisco';
-}
-
-sub interfaces {
-    my $aironet = shift;
-    my $i_description = $aironet->i_description();
-
-    return $i_description;
-}
-
-# Tag on e_descr.1
-sub description {
-    my $aironet = shift;
-    my $descr = $aironet->descr();
-    my $e_descr = $aironet->e_descr();
-
-    $descr = "$e_descr->{1}  $descr" if defined $e_descr->{1};
-
-    return $descr;
-}
-
-# Fetch duplex from EtherLike
-sub i_duplex {
-    my $aironet = shift;
-    my $el_duplex = $aironet->el_duplex();
-
-    my %i_duplex;
-    foreach my $d (keys %$el_duplex){
-        my $val = $el_duplex->{$d};
-        next unless defined $val;
-        $i_duplex{$d} = 'full' if $val =~ /full/i;
-        $i_duplex{$d} = 'half' if $val =~ /half/i;
-    }
-
-    return \%i_duplex;
-}
-
-1;
-__END__
-
-=head1 NAME
-
-SNMP::Info::Layer2::Aironet - SNMP Interface to Cisco Aironet devices running IOS.
-
-=head1 AUTHOR
-
-Max Baker (C<max@warped.org>)
-
-=head1 SYNOPSIS
-
- # Let SNMP::Info determine the correct subclass for you. 
- my $aironet = 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      = $aironet->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
-
-=head1 DESCRIPTION
-
-Provides interface to SNMP Data available on newer Aironet devices running Cisco IOS.
-
-Note there are two classes for Aironet devices :
-
-=over
-
-=item SNMP::Info::Layer3::Aironet
-
-This class is for devices running Aironet software (older)
-
-=item SNMP::Info::Layer2::Aironet
-
-This class is for devices running Cisco IOS software (newer)
-
-=back
-
-For speed or debugging purposes you can call the subclass directly, but not after determining
-a more specific class using the method above. 
-
-my $aironet = new SNMP::Info::Layer2::Aironet(...);
-
-=head2 Inherited Classes
-
-=over
-
-=item SNMP::Info::Layer2
-
-=item SNMP::Info::Entity
-
-=item SNMP::Info::EtherLike
-
-=back
-
-=head2 Required MIBs
-
-=over
-
-=item Inherited Classes
-
-MIBs required by the inherited classes listed above.
-
-=back
-
-=head1 GLOBALS
-
-These are methods that return scalar value from SNMP
-
-=over
-
-=item $aironet->discription()
-
-Adds info from method e_descr() from SNMP::Info::Entity
-
-=item $aironet->vendor()
-
-    Returns 'cisco' :)
-
-=back
-
-=head2 Globals imported from SNMP::Info::Layer2
-
-See documentation in SNMP::Info::Layer2 for details.
-
-=head2 Globals imported from SNMP::Info::Entity
-
-See documentation in SNMP::Info::Entity for details.
-
-=head2 Globals imported from SNMP::Info::EtherLike
-
-See documentation in SNMP::Info::EtherLike for details.
-
-=head1 TABLE ENTRIES
-
-=head2 Overrides
-
-=over
-
-=item $aironet->interfaces()
-
-Uses the i_description() field.
-
-=item $aironet->i_duplex()
-
-Crosses information from SNMP::Info::EtherLike to get duplex info for interfaces.
-
-=back
-
-=head2 Table Methods imported from SNMP::Info::Layer2
-
-See documentation in SNMP::Info::Layer2 for details.
-
-=head2 Table Methods imported from SNMP::Info::Entity
-
-See documentation in SNMP::Info::Entity for details.
-
-=head2 Table Methods imported from SNMP::Info::EtherLike
-
-See documentation in SNMP::Info::EtherLike for details.
-
-=cut

Info/Layer2/Bay.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Layer2::Bay;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 use strict;
 
@@ -73,44 +73,6 @@ $SNMP::Info::SPEED_MAP{200_000_000} = '100 Mbps';
             'i_mac2' => \&SNMP::Info::munge_mac ,
             );
 
-sub os {
-    return 'bay';
-}
-
-sub os_ver {
-    my $bay = shift;
-    my $descr = $bay->description();
-    return undef unless defined $descr;
-
-    # 303 / 304
-    if ($descr =~ m/Rev: \d+\.\d+\.\d+\.\d+-(\d+\.\d+\.\d+\.\d+)/){
-        return $1;
-    }
-
-    # 450
-    if ($descr =~ m/SW:v(\d+\.\d+\.\d+\.\d+)/){
-        return $1;
-    }
-    return undef;
-}
-
-sub os_bin {
-    my $bay = shift;
-    my $descr = $bay->description();
-    return undef unless defined $descr;
-
-    # 303 / 304
-    if ($descr =~ m/Rev: \d+\.(\d+\.\d+\.\d+)-\d+\.\d+\.\d+\.\d+/){
-        return $1;
-    }
-
-    # 450
-    if ($descr =~ m/FW:v(\d+\.\d+\.\d+\.\d+)/){
-        return $1;
-    }
-    return undef;
-}
-
 sub vendor {
     # or nortel, or synopsis?
     return 'bay';
@@ -154,9 +116,7 @@ sub i_mac {
 sub model {
     my $bay = shift;
     my $id = $bay->id();
-    return undef unless defined $id;
     my $model = &SNMP::translateObj($id);
-    return $id unless defined $model;
     $model =~ s/^sreg-//i;
 
     my $descr = $bay->description();
@@ -176,7 +136,6 @@ sub c_if {
     my %c_if;
     foreach my $entry (keys %$bay_topo_port){
         my $port = $bay_topo_port->{$entry};
-        next unless defined $port;
         next if $port == 0;
         $c_if{"$port.1"} = $port;
     }
@@ -195,7 +154,6 @@ sub c_ip {
     my %ip_port;
     foreach my $entry (keys %$bay_topo_ip){
         my $port = $bay_topo_port->{$entry};
-        next unless defined $port;
         next if $port == 0;
         my $ip   = $bay_topo_ip->{$entry};
         push(@{$ip_port{$port}},$ip);
@@ -222,7 +180,6 @@ sub c_port {
     my %c_port;
     foreach my $entry (keys %$bay_topo_seg){
         my $port = $bay_topo_port->{$entry};
-        next unless defined $port;
         next if $port == 0;
 
         # For fake remotes (multiple IPs for a c_ip), use first found
@@ -266,59 +223,22 @@ __END__
 
 =head1 NAME
 
-SNMP::Info::Layer2::Bay - SNMP Interface to old Bay Network BayStack Switches
+SNMP::Info::Layer2::Bay - SNMP Interface to old Bay Network Switches
-
-=head1 AUTHOR
-
-Max Baker (C<max@warped.org>)
-
-=head1 SYNOPSIS
-
- # Let SNMP::Info determine the correct subclass for you. 
- my $bay = 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      = $bay->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
 
 =head1 DESCRIPTION
 
 Provides abstraction to the configuration information obtainable from a 
 Bay device through SNMP. 
 
-For speed or debugging purposes you can call the subclass directly, but not after determining
+Inherits from 
-a more specific class using the method above. 
 
- my $bay = new SNMP::Info::Layer2::Bay(...);
+ SNMP::Info::Layer2
 
-=head2 Inherited Classes
+Required MIBs:
 
-=over
+ SYNOPTICS-ROOT-MIB
-
+ S5-ETH-MULTISEG-TOPOLOGY-MIB
-=item SNMP::Info::Layer2
+ MIBS listed in SNMP::Info::Layer2
-
-=back
-
-=head2 Required MIBs
-
-=over
-
-=item SYNOPTICS-ROOT-MIB
-
-=item S5-ETH-MULTISEG-TOPOLOGY-MIB
-
-=item Inherited classes
-
-MIBs required by SNMP::Info::Layer2 and its superclasses.
-
-=back
 
 Bay MIBs can be found on the CD that came with your product.  
 
@@ -327,12 +247,39 @@ www.nortelnetworks.com
 
 They have also been seen at : http://www.inotech.com/mibs/vendor/baynetworks/synoptics/synoptics.asp
 
-Or http://www.oidview.com/mibs/detail.html under Synoptics.  Check also www.mibdepot.com
+Or http://www.oidview.com/mibs/detail.html under Synoptics.
+
+You will need at least the two listed above, and probably a few more.  
+
+=head1 AUTHOR
+
+Max Baker (C<max@warped.org>)
+
+=head1 SYNOPSIS
+
+ my $bay = new SNMP::Info::Layer2::Bay(DestHost  => 'mybayswitch' , 
+                              Community => 'public' ); 
+
+=head1 CREATING AN OBJECT
+
+=over
+
+=item  new SNMP::Info::Layer2::Bay()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $bay = new SNMP::Info::Layer2::Bay(
+        DestHost => $host,
+        Community => 'public',
+        Version => 3,...
+        ) 
+    die "Couldn't connect.\n" unless defined $bay;
+
+=back
 
 =head1 GLOBALS
 
-These are methods that return scalar value from SNMP
-
 =over
 
 =item $bay->vendor()
@@ -361,15 +308,8 @@ Returns if the S5-ETH-MULTISEG-TOPOLOGY info is on for this device.
 
 =back
 
-=head2 Globals imported from SNMP::Info::Layer2
-
-See documentation in SNMP::Info::Layer2 for details.
-
 =head1 TABLE ENTRIES
 
-These are methods that return tables of information in the form of a reference
-to a hash.
-
 =head2 Overrides
 
 =over
@@ -476,8 +416,4 @@ Returns reference to hash.  Key: Table entry, Value:Boolean, if bay_topo_seg() i
 
 =back
 
-=head2 Table Methods imported from SNMP::Info::Layer2
-
-See documentation in SNMP::Info::Layer2 for details.
-
 =cut

Info/Layer2/C1900.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Layer2::C1900;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 use strict;
 
@@ -42,13 +42,11 @@ use vars qw/$VERSION %FUNCS %GLOBALS %MIBS %MUNGE $AUTOLOAD $INIT $DEBUG/;
 
 # Set for No CDP
 %GLOBALS = (
-            %SNMP::Info::Layer2::GLOBALS,
+            %SNMP::Info::Layer2::GLOBALS
-            'c1900_flash_status'    => 'upgradeFlashBankStatus',
             );
 
 %FUNCS   = (%SNMP::Info::Layer2::FUNCS,
             'i_type2'              => 'ifType',
-            'i_name2'              => 'ifName',
             # ESSWITCH-MIB
             'c1900_p_index'        => 'swPortIndex',
             'c1900_p_ifindex'      => 'swPortIfIndex',
@@ -72,35 +70,6 @@ use vars qw/$VERSION %FUNCS %GLOBALS %MIBS %MUNGE $AUTOLOAD $INIT $DEBUG/;
 sub vendor {
     return 'cisco';
 }
-sub os {
-    return 'catalyst';
-}
-
-sub os_ver {
-    my $c1900 = shift;
-
-    # Check for superclass one
-    my $os_ver = $c1900->SUPER::os_ver();
-    return $os_ver if defined $os_ver;
-    
-    my $c1900_flash_status = $c1900->c1900_flash_status();
-    return undef unless defined $c1900_flash_status;
-
-    if ($c1900_flash_status =~ m/V(\d+\.\d+(\.\d+)?)/){
-        return $1;
-    }  
-    return undef;
-}
-
-sub interfaces {
-    my $c1900 = shift;
-    my $i_descr = $c1900->i_description();
-
-    foreach my $iid (keys %$i_descr){
-        $i_descr->{$iid} =~ s/\s*$//;
-    }
-    return $i_descr;
-}
 
 sub i_duplex {
     my $c1900 = shift;
@@ -174,26 +143,29 @@ sub i_type {
 
     return $i_type;
 }
-
-sub i_name {
-    my $c1900 = shift;
-    my $i_name = $c1900->i_name2();
-    my $c1900_p_name = $c1900->c1900_p_name();
-    
-    foreach my $port (keys %$c1900_p_name){
-        my $name = $c1900_p_name->{$port};
-        next unless defined $name;
-        next unless $name !~ /^\s*$/;
-        $i_name->{$port} = $name;
-    }
-    
-    return $i_name;
-}
 __END__
 
 =head1 NAME
 
-SNMP::Info::Layer2::C1900 - Perl5 Interface to SNMP data from Cisco Catlyst 1900 Network Switches running CatOS
+SNMP::Info::Layer2::C1900 - SNMP Interface to old C1900 Network Switches
+
+=head1 DESCRIPTION
+
+Provides abstraction to the configuration information obtainable from a 
+C1900 device through SNMP. See inherited classes' documentation for 
+inherited methods.
+
+Inherits from:
+
+ SNMP::Info::Layer2
+
+Required MIBs:
+
+ STAND-ALONE-ETHERNET-SWITCH-MIB (ESSWITCH-MIB)
+ MIBs listed in SNMP::Info::Layer2
+
+ESSWITCH-MIB is included in the Version 1 MIBS from Cisco.
+They can be found at ftp://ftp.cisco.com/pub/mibs/v1/v1.tar.gz
 
 =head1 AUTHOR
 
@@ -201,90 +173,37 @@ Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- # Let SNMP::Info determine the correct subclass for you. 
+ my $c1900 = new SNMP::Info::Layer2::C1900(DestHost  => 'mycat1900' , 
- my $c1900 = new SNMP::Info(
+                              Community => 'public' ); 
-                          AutoSpecify => 1,
+
-                          Debug       => 1,
+=head1 CREATING AN OBJECT
-                          # These arguments are passed directly on to SNMP::Session
+
-                          DestHost    => 'myswitch',
+=over
+
+=item  new SNMP::Info::Layer2::C1900()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $c1900 = new SNMP::Info::Layer2::C1900(
+        DestHost => $host,
         Community => 'public',
-                          Version     => 1
+        Version => 3,...
         ) 
-    or die "Can't connect to DestHost.\n";
+    die "Couldn't connect.\n" unless defined $c1900;
-
- my $class      = $c1900->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
-
-=head1 DESCRIPTION
-
-Provides abstraction to the configuration information obtainable from a Catalyst 1900 device through SNMP. 
-See SNMP::Info for full documentation
-
-Note that most of these devices only talk SNMP version 1, but not all.
-
-For speed or debugging purposes you can call the subclass directly, but not after determining
-a more specific class using the method above. 
-
- my $c1900 = new SNMP::Info::Layer2::C1900(...);
-
-=head2 Inherited classes
-
-=over
-
-=item SNMP::Info::Layer2
-
-=back
-
-=head2 Required MIBs
-
-=over
-
-=item STAND-ALONE-ETHERNET-SWITCH-MIB (ESSWITCH-MIB)
-
-ESSWITCH-MIB is included in the Version 1 MIBS from Cisco.
-
-They can be found at ftp://ftp.cisco.com/pub/mibs/v1/v1.tar.gz
-
-=item Inherited Classes' MIBs
-
-MIBs listed in SNMP::Info::Layer2
 
 =back
 
 =head1 GLOBALS
 
-These are methods that return scalar value from SNMP
-
 =over
 
-=item $c1900->c1900_flash_status()
-
-Usually contains the version of the software loaded in flash.
-Used by os_ver()
-
-B<STAND-ALONE-ETHERNET-SWITCH-MIB::upgradeFlashBankStatus>
-
-=item $c1900->os()
-
-Returns 'catalyst'
-
-=item $c1900->os_ver()
-
-Returns CatOS version if obtainable.  First tries to use 
-SNMP::Info::CiscoStats->os_ver() .  If that fails then it 
-checks for the presence of $c1900->c1900_flash_status() and culls
-the version from there.
-
 =item $c1900->vendor()
 
 Returns 'cisco' :)
 
 =back
 
-=head2 Globals imported from SNMP::Info::Layer2
-
-See documentation in SNMP::Info::Layer2 for details.
-
 =head1 TABLE ENTRIES
 
 =head2 Overrides
@@ -303,10 +222,6 @@ Returns reference to hash of IIDs to admin duplex setting
 
 Crosses $c1900->c1900_p_index() with $c1900->c1900_p_duplex_admin;
 
-=item $c1900->i_name()
-
-Crosses ifName with c1900_p_name() and returns the human set port name if exists.
-
 =item $c1900->i_type()
 
 Returns reference to hash of IID to port type
@@ -365,8 +280,4 @@ B<swPortConnectorType>
 
 =back
 
-=head2 Table Methods imported from SNMP::Info::Layer2
-
-See documentation in SNMP::Info::Layer2 for details.
-
 =cut

Info/Layer2/C2900.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Layer2::C2900;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 use strict;
 
@@ -138,7 +138,16 @@ __END__
 
 =head1 NAME
 
-SNMP::Info::Layer2::C2900 - SNMP Interface to Cisco Catalyst 2900 Switches running IOS
+SNMP::Info::Layer2::C2900 - SNMP Interface to Cisco Catalyst 2900 Network Switches
+
+=head1 DESCRIPTION
+
+Provides abstraction to the configuration information obtainable from a 
+C2900 device through SNMP. 
+
+MIBS:  CISCO-C2900-MIB
+
+Inherits all SNMP::Info::Layer2 methods.
 
 =head1 AUTHOR
 
@@ -146,54 +155,29 @@ Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- # Let SNMP::Info determine the correct subclass for you. 
+ my $c2900 = new SNMP::Info::Layer2::C2900(DestHost  => 'mycat2900' , 
- my $c2900 = new SNMP::Info(
+                              Community => 'public' ); 
-                          AutoSpecify => 1,
+
-                          Debug       => 1,
+=head1 CREATING AN OBJECT
-                          # These arguments are passed directly on to SNMP::Session
+
-                          DestHost    => 'myswitch',
+=over
+
+=item  new SNMP::Info::Layer2::C2900()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $c2900 = new SNMP::Info::Layer2::C2900(
+        DestHost => $host,
         Community => 'public',
-                          Version     => 2
+        Version => 3,...
         ) 
-    or die "Can't connect to DestHost.\n";
+    die "Couldn't connect.\n" unless defined $c2900;
-
- my $class      = $c2900->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
-
-=head1 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(...);
-
-=head2 Inherited Classes
-
-=over
-
-=item SNMP::Info::Layer2
-
-=back
-
-=head2 Required MIBs
-
-=over
-
-=item CISCO-C2900-MIB
-
-Part of the v2 MIBs from Cisco.
 
 =back
 
 =head1 GLOBALS
 
-These are methods that return scalar value from SNMP
-
-=head2 Overrides
-
 =over
 
 =item $c2900->vendor()
@@ -202,15 +186,8 @@ These are methods that return scalar value from SNMP
 
 =back
 
-=head2 Globals imported from SNMP::Info::Layer2
-
-See documentation in SNMP::Info::Layer2 for details.
-
 =head1 TABLE ENTRIES
 
-These are methods that return tables of information in the form of a reference
-to a hash.
-
 =head2 Overrides
 
 =over
@@ -273,8 +250,5 @@ to a hash.
 
 =back
 
-=head2 Table Methods imported from SNMP::Info::Layer2
-
-See documentation in SNMP::Info::Layer2 for details.
-
 =cut
+

Info/Layer2/Catalyst.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Layer2::Catalyst;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 
 use strict;
@@ -36,7 +36,8 @@ use strict;
 use Exporter;
 use SNMP::Info::Layer2;
 
-use vars qw/$VERSION $DEBUG %GLOBALS %MIBS %FUNCS %PORTSTAT %MUNGE $INIT/ ;
+use vars qw/$VERSION $DEBUG %GLOBALS %MIBS %FUNCS %PORTSTAT 
+            %MYGLOBALS %MYMIBS %MYFUNCS %MYMUNGE %MUNGE $INIT/ ;
 @SNMP::Info::Layer2::Catalyst::ISA = qw/SNMP::Info::Layer2 Exporter/;
 @SNMP::Info::Layer2::Catalyst::EXPORT_OK = qw//;
 
@@ -46,29 +47,34 @@ $DEBUG=0;
 #       the interworkings.
 $INIT = 0;
 
-%MIBS =    ( %SNMP::Info::Layer2::MIBS, 
+%MYMIBS = (
           'CISCO-STACK-MIB' => 'moduleType',
           'CISCO-VTP-MIB'   => 'vtpVlanIndex'
           );
 
-%GLOBALS = (
+%MIBS = ( %SNMP::Info::Layer2::MIBS, 
-            %SNMP::Info::Layer2::GLOBALS,
+          %MYMIBS );
+
+%MYGLOBALS = (
             # these are in CISCO-STACK-MIB
             'sysip'       => 'sysIpAddr',    
             'netmask'     => 'sysNetMask',    
             'broadcast'   => 'sysBroadcast',
-            'serial'      => 'chassisSerialNumber',    
+            'serial'      => 'chassisSerialNumberString',    
             'model'       => 'chassisModel',    
             'ps1_type'    => 'chassisPs1Type',    
             'ps1_status'  => 'chassisPs1Status',    
             'ps2_type'    => 'chassisPs2Type',    
             'ps2_status'  => 'chassisPs2Status',    
             'slots'       => 'chassisNumSlots',    
-            'fan'         => 'chassisFanStatus',
+            'fan'         => 'chassisFanStatus'
+             );
+%GLOBALS = (
+            %SNMP::Info::Layer2::GLOBALS,
+            %MYGLOBALS
             );
 
-%FUNCS =   (
+%MYFUNCS = (
-            %SNMP::Info::Layer2::FUNCS,
             'i_type2'        => 'ifType',
             # CISCO-STACK-MIB::moduleEntry
             #   These are blades in a catalyst device
@@ -103,13 +109,22 @@ $INIT = 0;
             'v_name'    => 'vtpVlanName',
             'v_mtu'     => 'vtpVlanMtu',
            );
+%FUNCS   = (
+            %SNMP::Info::Layer2::FUNCS,
+            %MYFUNCS
+        );
 
-%MUNGE =   (
+%MYMUNGE = (
-            %SNMP::Info::Layer2::MUNGE,
             'm_ports_status' => \&munge_port_status,
             'p_duplex_admin' => \&SNMP::Info::munge_bits,
            );
 
+%MUNGE = (
+            # Inherit all the built in munging
+            %SNMP::Info::Layer2::MUNGE,
+            %MYMUNGE
+         );
+
 %PORTSTAT = (1 => 'other',
              2 => 'ok',
              3 => 'minorFault',
@@ -235,23 +250,6 @@ 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 undef 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 undef;
-}
-
 1;
 __END__
 
@@ -259,137 +257,82 @@ __END__
 
 SNMP::Info::Layer2::Catalyst - Perl5 Interface to Cisco devices running Catalyst OS 
 
+=head1 DESCRIPTION
+
+Provides abstraction to the configuration information obtainable from a 
+Catalyst device through SNMP.  Information is stored in a number of 
+MIB's such as IF-MIB, CISCO-CDP-MIB, CISCO-STACK-MIB, CISCO-VTP-MIB,
+and SWITCH-MIB.
+
 =head1 AUTHOR
 
 Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- # Let SNMP::Info determine the correct subclass for you. 
+ my $cat = new SNMP::Info::Layer2::Catalyst(DestHost  => 'router' , 
- my $cat = new SNMP::Info(
+                              Community => 'public' ); 
-                          AutoSpecify => 1,
+
-                          Debug       => 1,
+=head1 CREATING AN OBJECT
-                          # These arguments are passed directly on to SNMP::Session
+
-                          DestHost    => 'myswitch',
+=over
+
+=item  new SNMP::Info::Layer2::Catalyst()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $cat = new SNMP::Info::Layer2::Catalyst(
+        DestHost => $host,
         Community => 'public',
-                          Version     => 2
+        Version => 3,...
         ) 
-    or die "Can't connect to DestHost.\n";
+    die "Couldn't connect.\n" unless defined $cat;
-
- 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 switches running CatOS.
-
-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.
-
-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
 
 =back
 
-=head2 Required MIBs
+=head1 GLOBAL Values
 
 =over
 
-=item CISCO-STACK-MIB
-
-=item CISCO-VTP-MIB
-
-=item Inherited Classes' MIBs
-
-See SNMP::Info::Layer2 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->broadcast()
-
-(B<sysBroadcast>)
-
-=item $cat->fan()
-
-(B<chassisFanStatus>)
-
-=item $cat->model()
-
-(B<chassisModel>)
-
 =item $cat->netmask()
-
 (B<sysNetMask>)
 
-=item $cat->os()
+=item $cat->broadcast()
+(B<sysBroadcast>)
 
-Returns 'catalyst'
+=item $cat->serial()
+(B<chassisSerialNumberString>)
 
-=item $cat->os_ver()
+=item $cat->model()
-
+(B<chassisModel>)
-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->ps1_type()
-
 (B<chassisPs1Type>)
 
 =item $cat->ps2_type()
-
 (B<chassisPs2Type>)
 
 =item $cat->ps1_status()
-
 (B<chassisPs1Status>)
 
 =item $cat->ps2_status()
-
 (B<chassisPs2Status>)
 
-=item $cat->serial()
-
-(B<chassisSerialNumberString>)
-
 =item $cat->slots()
-
 (B<chassisNumSlots>)
 
+=item $cat->fan()
+(B<chassisFanStatus>)
+
 =item $cat->vendor()
 
     Returns 'cisco'
 
 =back
 
-=head2 Globals imported from SNMP::Info::Layer2
-
-See documentation in SNMP::Info::Layer2 for details.
-
 =head1 TABLE ENTRIES
 
-These are methods that return tables of information in the form of a reference
-to a hash.
-
 =head2 Overrides
 
 =over
@@ -432,62 +375,47 @@ the Catalyst device.
 =over
 
 =item $cat->m_type()
-
 (B<moduleType>)
 
 =item $cat->m_model()
-
 (B<moduleModel>)
 
 =item $cat->m_serial()
-
 (B<moduleSerialNumber>)
 
 =item $cat->m_status()
-
 (B<moduleStatus>)
 
 =item $cat->m_name()
-
 (B<moduleName>)
 
 =item $cat->m_ports()
-
 (B<moduleNumPorts>)
 
 =item $cat->m_ports_status()
-
  Returns a list of space separated status strings for the ports.
-
    To see the status of port 4 :
-
         @ports_status = split(' ', $cat->m_ports_status() );
         $port4 = $ports_status[3];
 
 (B<modulePortStatus>)
 
 =item $cat->m_ports_hwver()
-
 (B<moduleHwVersion>)
 
 =item $cat->m_ports_fwver()
-
 (B<moduleFwVersion>)
 
 =item $cat->m_ports_swver()
-
 (B<moduleSwVersion>)
 
 =item $cat->m_ports_ip()
-
 (B<moduleIPAddress>)
 
 =item $cat->m_ports_sub1()
-
 (B<moduleSubType>)
 
 =item $cat->m_ports_sub2()
-
 (B<moduleSubType2>)
 
 =back
@@ -497,15 +425,12 @@ To see the status of port 4 :
 =over
 
 =item $cat->m_ip()
-
 (B<moduleIPAddress>)
 
 =item $cat->m_sub1()
-
 (B<moduleSubType>)
 
 =item $cat->m_sub2()
-
 (B<moduleSubType2>)
 
 =back
@@ -515,31 +440,24 @@ To see the status of port 4 :
 =over
 
 =item $cat->p_name()
-
 (B<portName>)
 
 =item $cat->p_type()
-
 (B<portType>)
 
 =item $cat->p_status()
-
 (B<portOperStatus>)
 
 =item $cat->p_status2()
-
 (B<portAdditionalStatus>)
 
 =item $cat->p_speed()
-
 (B<portAdminSpeed>)
 
 =item $cat->p_duplex()
-
 (B<portDuplex>)
 
 =item $cat->p_port()
-
 (B<portIfIndex>)
 
 =back
@@ -549,11 +467,9 @@ To see the status of port 4 :
 =over
 
 =item $cat->p_speed_admin()
-
 (B<portCpbSpeed>)
 
 =item $cat->p_duplex_admin()
-
 (B<portCpbDuplex>)
 
 =back
@@ -563,28 +479,21 @@ To see the status of port 4 :
 See ftp://ftp.cisco.com/pub/mibs/supportlists/wsc5000/wsc5000-communityIndexing.html
 for a good treaty of how to connect to the VLANs
 
+
 =over
 
 =item $cat->v_state()
-
 (B<vtpVlanState>)
 
 =item $cat->v_type()
-
 (B<vtpVlanType>)
 
 =item $cat->v_name()
-
 (B<vtpVlanName>)
 
 =item $cat->v_mtu()
-
 (B<vtpVlanMtu>)
 
 =back
 
-=head2 Table Methods imported from SNMP::Info::Layer2
-
-See documentation in SNMP::Info::Layer2 for details.
-
 =cut

Info/Layer2/HP.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Layer2::HP;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 
 use strict;
@@ -36,53 +36,68 @@ use strict;
 use Exporter;
 use SNMP::Info::Layer2;
 use SNMP::Info::MAU;
-use SNMP::Info::Entity;
 
-use vars qw/$VERSION $DEBUG %GLOBALS %MIBS %FUNCS %PORTSTAT %MODEL_MAP %MUNGE $INIT/ ;
+use vars qw/$VERSION $DEBUG %GLOBALS %MIBS %FUNCS %PORTSTAT %MODEL_MAP 
-
+            %MYGLOBALS %MYMIBS %MYFUNCS %MYMUNGE %MUNGE $INIT/ ;
-@SNMP::Info::Layer2::HP::ISA = qw/SNMP::Info::Layer2 SNMP::Info::MAU SNMP::Info::Entity Exporter/;
+@SNMP::Info::Layer2::HP::ISA = qw/SNMP::Info::Layer2 SNMP::Info::MAU Exporter/;
 @SNMP::Info::Layer2::HP::EXPORT_OK = qw//;
 
-# See SNMP::Info for the details of these data structures and interworkings.
+$DEBUG=0;
+$SNMP::debugging=$DEBUG;
+
+# See SNMP::Info for the details of these data structures and 
+#       the interworkings.
 $INIT = 0;
 
+%MYMIBS = ( 'ENTITY-MIB'  => 'entPhysicalSerialNum',
+            'RFC1271-MIB' => 'logDescription',
+            'HP-ICF-OID'  => 'hpSwitch4000',
+          );
+
 %MIBS = ( %SNMP::Info::Layer2::MIBS,
           %SNMP::Info::MAU::MIBS,
-          %SNMP::Info::Entity::MIBS,
+          %MYMIBS );
-          'RFC1271-MIB' => 'logDescription',
-          'HP-ICF-OID'  => 'hpSwitch4000',
-          'STATISTICS-MIB' => 'hpSwitchCpuStat',
-          'NETSWITCH-MIB'  => 'hpMsgBufFree'
-        );
 
+%MYGLOBALS = ('serial1' => 'entPhysicalSerialNum.1',
+#              'model'  => 'entPhysicalModelName.1',
+             );
 %GLOBALS = (
             %SNMP::Info::Layer2::GLOBALS,
             %SNMP::Info::MAU::GLOBALS,
-            %SNMP::Info::Entity::GLOBALS,
+            %MYGLOBALS
-            'serial1'   => 'entPhysicalSerialNum.1',
-            'hp_cpu'    => 'hpSwitchCpuStat.0',
-            'hp_mem_total' => 'hpGlobalMemTotalBytes.1',
-            'mem_free'  => 'hpGlobalMemFreeBytes.1',
-            'mem_used'  => 'hpGlobalMemAllocBytes.1',
-            'os_version' => 'hpSwitchOsVersion.0',
-            'os_bin'    => 'hpSwitchRomVersion.0',
-            'mac'       => 'hpSwitchBaseMACAddress.0'
             );
 
+%MYFUNCS = (
+            'i_type2'   => 'ifType',
+            'e_class'   => 'entPhysicalClass',
+            'e_descr'   => 'entPhysicalDescr',
+            'e_fwver'   => 'entPhysicalFirmwareRev',
+            'e_hwver'   => 'entPhysicalHardwareRev',
+            'e_map'     => 'entAliasMappingIdentifier',
+            'e_model'   => 'entPhysicalModelName',
+            'e_name'    => 'entPhysicalName',
+            'e_parent'  => 'entPhysicalContainedIn',
+            'e_serial'  => 'entPhysicalSerialNum',
+            'e_swver'   => 'entPhysicalSoftwareRev',
+            'e_type'    => 'entPhysicalVendorType',
+            # RFC1271
+            'l_descr'   => 'logDescription'
+
+           );
 %FUNCS   = (
             %SNMP::Info::Layer2::FUNCS,
             %SNMP::Info::MAU::FUNCS,
-            %SNMP::Info::Entity::FUNCS,
+            %MYFUNCS
-            'i_type2'   => 'ifType',
+        );
-            # RFC1271
+
-            'l_descr'   => 'logDescription'
+%MYMUNGE = (
            );
 
 %MUNGE = (
             # Inherit all the built in munging
             %SNMP::Info::Layer2::MUNGE,
             %SNMP::Info::MAU::MUNGE,
-            %SNMP::Info::Entity::MUNGE
+            %MYMUNGE
          );
 
 %MODEL_MAP = ( 
@@ -98,31 +113,6 @@ $INIT = 0;
 
 # Method Overrides
 
-sub cpu {
-    my $hp = shift;
-    return $hp->hp_cpu();
-}
-
-sub mem_total {
-    my $hp = shift;
-    return $hp->hp_mem_total();
-}
-
-sub os {
-    return 'hp';
-}
-sub os_ver {
-    my $hp = shift;
-    my $os_version = $hp->os_version();
-    return $os_version if defined $os_version;
-    # Some older ones don't have this value,so we cull it from the description
-    my $descr = $hp->description();
-    if ($descr =~ m/revision ([A-Z]{1}\.\d{2}\.\d{2})/) {
-        return $1;
-    }
-    return undef;
-}
-
 # Lookup model number, and translate the part number to the common number
 sub model {
     my $hp = shift;
@@ -157,6 +147,7 @@ sub interfaces {
     foreach my $iid (keys %$interfaces){
         my $descr = $i_descr->{$iid};
         next unless defined $descr;
+        #$if{$iid} = $iid;
         $if{$iid} = $descr if (defined $descr and length $descr);
     }
 
@@ -164,6 +155,26 @@ sub interfaces {
 
 }
 
+# e_port maps EntityTable entries to IfTable
+sub e_port {
+    my $hp = shift;
+    my $e_map = $hp->e_map();
+
+    my %e_port;
+
+    foreach my $e_id (keys %$e_map) {
+        my $id = $e_id;
+        $id =~ s/\.0$//;
+
+        my $iid = $e_map->{$e_id};
+        $iid =~ s/.*\.//;
+
+        $e_port{$id} = $iid;
+    }
+
+    return \%e_port;
+}
+
 sub i_type {
     my $hp = shift;
     my $e_descr = $hp->e_descr();
@@ -333,100 +344,61 @@ __END__
 
 SNMP::Info::Layer2::HP - SNMP Interface to HP Procurve Switches
 
+=head1 DESCRIPTION
+
+Provides abstraction to the configuration information obtainable from a 
+HP device through SNMP.  Information is stored in a number of 
+MIB's such as IF-MIB, ENTITY-MIB, RFC1271-MIB, HP-ICF-OID, MAU-MIB
+
+MIBs required:
+
+=over
+
+=item RFC1271-MIB
+
+=item HP-ICF-OID
+
+=back
+
+HP MIBs can be found at http://www.hp.com/rnd/software
+
 =head1 AUTHOR
 
 Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- # Let SNMP::Info determine the correct subclass for you. 
+ my $hp = new SNMP::Info::Layer2::HP(DestHost  => 'router' , 
- my $hp = new SNMP::Info(
+                              Community => 'public' ); 
-                          AutoSpecify => 1,
+
-                          Debug       => 1,
+ See SNMP::Info and SNMP::Info::Layer2 for all the inherited methods.
-                          # These arguments are passed directly on to SNMP::Session
+
-                          DestHost    => 'myswitch',
+=head1 CREATING AN OBJECT
+
+=over
+
+=item  new SNMP::Info::Layer2::HP()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $hp = new SNMP::Info::Layer2::HP(
+        DestHost => $host,
         Community => 'public',
-                          Version     => 2
+        Version => 3,...
         ) 
-    or die "Can't connect to DestHost.\n";
+    die "Couldn't connect.\n" unless defined $hp;
-
- my $class      = $hp->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
-
-=head1 DESCRIPTION
-
-Provides abstraction to the configuration information obtainable from a 
-HP ProCurve Switch via SNMP. 
-
-Note:  Some HP Switches will connect via SNMP version 1, but a lot of config data will 
-not be available.  Make sure you try and connect with Version 2 first, and then fail back
-to 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 $hp = new SNMP::Info::Layer2::HP(...);
-
-=head2 Inherited Classes
-
-=over
-
-=item SNMP::Info::Layer2
-
-=item SNMP::Info::Entity
-
-=item SNMP::Info::MAU
 
 =back
 
-=head2 Required MIBs
+=head1 HP Global Configuration Values
 
 =over
 
-=item RFC1271-MIB
-
-Included in V2 mibs from Cisco
-
-=item HP-ICF-OID
-
-=item STATISTICS-MIB
-
-=item NETSWITCH-MIB
-
-=back
-
-The last three MIBs listed are from HP and can be found at http://www.hp.com/rnd/software
-
-=head1 ChangeLog
-
-Version 0.4 - Removed ENTITY-MIB e_*() methods to separate sub-class - SNMP::Info::Entity
-
-=head1 GLOBALS
-
-These are methods that return scalar value from SNMP
-
-=over
-
-=item $hp->cpu()
-
-Returns CPU Utilization in percentage.
-
 =item $hp->log()
 
 Returns all the log entries from the switch's log that are not Link up or down messages.
 
-=item $hp->mem_free()
-
-Returns bytes of free memory
-
-=item $hp->mem_total()
-
-Return bytes of total memory
-
-=item $hp->mem_used()
-
-Returns bytes of used memory
-
 =item $hp->model()
 
 Returns the model number of the HP Switch.  Will translate between the HP Part number and 
@@ -443,23 +415,6 @@ the common model number with this map :
                'J4874A' => '9315',
               );
 
-=item $hp->os()
-
-Returns hp
-
-=item $hp->os_bin()
-
-B<hpSwitchRomVersion.0>
-
-=item $hp->os_ver()
-
-Tries to use os_version() and if that fails will try and cull the version from
-the description field.
-
-=item $hp->os_version()
-
-B<hpSwitchOsVersion.0>
-
 =item $hp->serial()
 
 Returns serial number if available through SNMP
@@ -474,31 +429,69 @@ hp
 
 =back
 
-=head2 Globals imported from SNMP::Info::Layer2
+=head1 HP Table Values
 
-See documentation in SNMP::Info::Layer2 for details.
+=head2 Entity Table
 
-=head2 Globals imported from SNMP::Info::Entity
+=over
 
-See documentation in SNMP::Info::Entity for details.
+=item $hp->e_class()
 
-=head2 Globals imported from SNMP::Info::MAU
+(C<entPhysicalClass>)
 
-See documentation in SNMP::Info::MAU for details.
+=item $hp->e_descr()
 
-=head1 TABLE METHODS
+(C<entPhysicalClass>)
 
-These are methods that return tables of information in the form of a reference
+=item $hp->e_fwver()
-to a hash.
 
-=head2 Overrides
+(C<entPhysicalFirmwareRev>)
+
+=item $hp->e_hwver()
+
+(C<entPhysicalHardwareRev>)
+
+=item $hp->e_map()
+
+(C<entAliasMappingIdentifier>)
+
+=item $hp->e_model()
+
+(C<entPhysicalModelName>)
+
+=item $hp->e_name()
+
+(C<entPhysicalName>)
+
+=item $hp->e_parent()
+
+(C<entPhysicalContainedIn>)
+
+=item $hp->e_port()
+
+Maps EntityTable entries to the Interface Table (IfTable) using
+$hp->e_map()
+
+=item $hp->e_serial()
+
+(C<entPhysicalSerialNum>)
+
+=item $hp->e_swver()
+
+(C<entPhysicalSoftwareRev>)
+
+=item $hp->e_type()
+
+(C<entPhysicalVendorType>)
+
+=back
+
+=head2 Overriden Methods from SNMP::Info::Layer2
 
 =over
 
 =item $hp->interfaces() 
 
-Uses $hp->i_description()
-
 =item $hp->i_duplex()
 
 Maps $hp->mau_index() with $hp->mau_link().  Methods inherited from
@@ -519,17 +512,3 @@ Crosses i_name() with $hp->e_name() using $hp->e_port() and i_alias()
 Crosses i_type() with $hp->e_descr() using $hp->e_port()
 
 =back
-
-=head2 Table Methods imported from SNMP::Info::Layer2
-
-See documentation in SNMP::Info::Layer2 for details.
-
-=head2 Table Methods imported from SNMP::Info::Entity
-
-See documentation in SNMP::Info::Entity for details.
-
-=head2 Table Methods imported from SNMP::Info::MAU
-
-See documentation in SNMP::Info::MAU for details.
-
-=cut

Info/Layer3.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Layer3;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 
 use strict;
@@ -36,14 +36,12 @@ use strict;
 use Exporter;
 use SNMP::Info;
 use SNMP::Info::CDP;
-use SNMP::Info::CiscoStats;
 use SNMP::Info::Bridge;
 use SNMP::Info::EtherLike;
 
 use vars qw/$VERSION $DEBUG %GLOBALS %FUNCS $INIT %MIBS %MUNGE/;
 
-@SNMP::Info::Layer3::ISA = qw/SNMP::Info SNMP::Info::CDP SNMP::Info::Bridge 
+@SNMP::Info::Layer3::ISA = qw/SNMP::Info SNMP::Info::CDP SNMP::Info::Bridge SNMP::Info::EtherLike Exporter/;
-                              SNMP::Info::EtherLike SNMP::Info::CiscoStats Exporter/;
 @SNMP::Info::Layer3::EXPORT_OK = qw//;
 
 $DEBUG=0;
@@ -52,11 +50,11 @@ $SNMP::debugging=$DEBUG;
 $INIT = 0;
 
 %MIBS = ( %SNMP::Info::MIBS,
-          %SNMP::Info::Bridge::MIBS,
           %SNMP::Info::CDP::MIBS,
-          %SNMP::Info::CiscoStats::MIBS,
+          %SNMP::Info::Bridge::MIBS,
           %SNMP::Info::EtherLike::MIBS,
           'ENTITY-MIB'         => 'entPhysicalName',
+          'HP-ICF-OID'         => 'hpSwitch4000',
           'CISCO-PRODUCTS-MIB' => 'sysName',
           'OSPF-MIB'           => 'ospfRouterId',
         );
@@ -65,7 +63,6 @@ $INIT = 0;
             # Inherit the super class ones
             %SNMP::Info::GLOBALS,
             %SNMP::Info::CDP::GLOBALS,
-            %SNMP::Info::CiscoStats::GLOBALS,
             %SNMP::Info::Bridge::GLOBALS,
             %SNMP::Info::EtherLike::GLOBALS,
             'mac'       => 'ifPhysAddress.1',
@@ -76,7 +73,6 @@ $INIT = 0;
 %FUNCS   = (
             %SNMP::Info::FUNCS,
             %SNMP::Info::CDP::FUNCS,
-            %SNMP::Info::CiscoStats::FUNCS,
             %SNMP::Info::Bridge::FUNCS,
             %SNMP::Info::EtherLike::FUNCS,
             # IFMIB
@@ -92,7 +88,6 @@ $INIT = 0;
             # Inherit all the built in munging
             %SNMP::Info::MUNGE,
             %SNMP::Info::CDP::MUNGE,
-            %SNMP::Info::CiscoStats::MUNGE,
             %SNMP::Info::Bridge::MUNGE,
             %SNMP::Info::EtherLike::MUNGE,
             'at_paddr' => \&SNMP::Info::munge_mac,
@@ -227,7 +222,31 @@ __END__
 
 =head1 NAME
 
-SNMP::Info::Layer3 - Perl5 Interface to network devices serving Layer3 or Layers 2 & 3
+SNMP::Info::Layer3 - Perl5 Interface to network devices using Layer3
+
+=head1 DESCRIPTION
+
+Provides generic methods for accessing SNMP data for Layer 3 network devices. 
+Includes support for Layer2+3 devices. See super classes for other inherited
+methods.
+
+Inherits from:
+
+ SNMP::Info
+ SNMP::Info::Bridge
+ SNMP::Info::CDP
+ SNMP::Info::EtherLike
+
+Required MIBs:
+
+ ENTITY-MIB         - For model identification
+ CISCO-PRODUCTS-MIB - For model identification
+ HP-ICF-OID         - For model identification
+ MIBS listed in SNMP::Info::CDP, SNMP::Info::Bridge, and SNMP::Info::Etherlike
+
+Cisco MIBs can be found at ftp://ftp.cisco.com/pub/mibs/v2/v2.tar.gz
+
+HP MIBs can be found at http://www.hp.com/rnd/software
 
 =head1 AUTHOR
 
@@ -235,105 +254,46 @@ Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- # Let SNMP::Info determine the correct subclass for you. 
+ my $l3 = new SNMP::Info::Layer3(DestHost  => 'router' , 
- my $l3 = new SNMP::Info(
+                              Community => 'public' ); 
-                          AutoSpecify => 1,
+
-                          Debug       => 1,
+=head1 CREATING AN OBJECT
-                          # These arguments are passed directly on to SNMP::Session
+
-                          DestHost    => 'myswitch',
+=over
+
+=item  new SNMP::Info::Layer3()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $l3 = new SNMP::Info::Layer3(
+        DestHost => $host,
         Community => 'public',
-                          Version     => 2
+        Version => 3,...
         ) 
-    or die "Can't connect to DestHost.\n";
+    die "Couldn't connect.\n" unless defined $l3;
-
- my $class      = $l3->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
-
- # Let's get some basic Port information
- my $interfaces = $l3->interfaces();
- my $i_up       = $l3->i_up();
- my $i_speed    = $l3->i_speed();
- foreach my $iid (keys %$interfaces) {
-    my $port  = $interfaces->{$iid};
-    my $up    = $i_up->{$iid};
-    my $speed = $i_speed->{$iid}
-    print "Port $port is $up. Port runs at $speed.\n";
- }
-
-=head1 DESCRIPTION
-
-This class is usually used as a superclass for more specific device classes listed under 
-SNMP::Info::Layer3::*   Please read all docs under SNMP::Info first.
-
-Provides generic methods for accessing SNMP data for Layer 3 network devices. 
-Includes support for Layer2+3 devices. 
-
-For speed or debugging purposes you can call the subclass directly, but not after determining
-a more specific class using the method above. 
-
- my $l3 = new SNMP::Info::Layer3(...);
-
-=head2 Inherited Classes
-
-=over
-
-=item SNMP::Info
-
-=item SNMP::Info::Bridge
-
-=item SNMP::Info::CDP
-
-=item SNMP::Info::CiscoStats
-
-=item SNMP::Info::EtherLike
 
 =back
 
-=head2 Required MIBs
-
-=over
-
-=item CISCO-PRODUCTS-MIB
-
-=item ENTITY-MIB
-
-=item OSPF-MIB
-
-=item Inherited Classes
-
-MIBs required by the inherited classes listed above.
-
-=back
-
-MIBs can be found at ftp://ftp.cisco.com/pub/mibs/v2/v2.tar.gz
-
 =head1 GLOBALS
 
-These are methods that return scalar value from SNMP
-
 =over
 
-=item $l3->chassis()
-
-Returns Chassis type (model).
-
-(B<entPhysicalDescr.1>)
-
 =item $l3->mac()
 
 Returns root port mac address
 
 (B<ifPhysAddress.1>)
 
-=item $l3->router_ip()
+=item $l3->chassis()
 
-(B<ospfRouterId.0>)
+Returns Chassis type (model).
 
-=back
+(B<entPhysicalDescr.1>)
 
-=head2 Overrides
+=item $l3->serial()
 
-=over
+Trys to cull a serial number from $l3->chassis()
 
 =item $l3->model()
 
@@ -341,41 +301,14 @@ Trys to reference $l3->id() to one of the product MIBs listed above
 
 Removes 'cisco'  from cisco devices for readability.
 
-=item $l3->serial()
-
-Trys to cull a serial number from $l3->chassis()
-
 =item $l3->vendor()
 
 Trys to cull a Vendor name from B<sysDescr>
 
 =back
 
-=head2 Globals imported from SNMP::Info
-
-See documentation in SNMP::Info for details.
-
-=head2 Globals imported from SNMP::Info::Bridge
-
-See documentation in SNMP::Info::Bridge for details.
-
-=head2 Globals imported from SNMP::Info::CDP
-
-See documentation in SNMP::Info::CDP for details.
-
-=head2 Globals imported from SNMP::Info::CiscoStats
-
-See documentation in SNMP::Info::CiscoStats for details.
-
-=head2 Globals imported from SNMP::Info::EtherLike
-
-See documentation in SNMP::Info::EtherLike for details.
-
 =head1 TABLE ENTRIES
 
-These are methods that return tables of information in the form of a reference
-to a hash.
-
 =head2 Overrides
 
 =over
@@ -433,24 +366,4 @@ Returns reference to hash of Arp Cache Entries to IP Address
 
 =back
 
-=head2 Table Methods imported from SNMP::Info
-
-See documentation in SNMP::Info for details.
-
-=head2 Table Methods imported from SNMP::Info::Bridge
-
-See documentation in SNMP::Info::Bridge for details.
-
-=head2 Table Methods imported from SNMP::Info::CDP
-
-See documentation in SNMP::Info::CDP for details.
-
-=head2 Table Methods imported from SNMP::Info::CiscoStats
-
-See documentation in SNMP::Info::CiscoStats for details.
-
-=head2 Table Methods imported from SNMP::Info::EtherLike
-
-See documentation in SNMP::Info::EtherLike for details.
-
 =cut

Info/Layer3/Aironet.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Layer3::Aironet;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 
 use strict;
@@ -82,26 +82,6 @@ $INIT = 0;
           'fw_mac2'     => \&SNMP::Info::munge_mac,
          );
 
-sub os {
-    return 'aironet';
-}
-
-sub os_ver {
-    my $aironet = shift;
-    my $descr = $aironet->description();
-
-    # CAP340 11.21
-    if ($descr =~ /AP\d{3}\s+(\d{2}\.\d{2})/){
-        return $1;
-    }
-    
-    if ($descr =~ /Series\s*AP\s+(\d{2}\.\d{2})/){
-        return $1;
-    }
-
-    return undef;
-}
-
 # Override wireless port with static info
 sub bp_index {
     my $aironet = shift;
@@ -130,7 +110,6 @@ sub fw_mac {
     # remove port 0 forwarding table entries, only port 0 static entries
     foreach my $fw (keys %$fw_mac){
         my $port = $fw_port->{$fw};
-        next unless defined $port;
         delete $fw_mac->{$fw} if $port == 0;
     }
 
@@ -210,7 +189,11 @@ __END__
 
 =head1 NAME
 
-SNMP::Info::Layer3::Aironet - Perl5 Interface to Cisco Aironet Wireless Devices running Aironet software, not IOS
+SNMP::Info::Layer3::Aironet - Perl5 Interface to Cisco Aironet Wireless Devices
+
+=head1 DESCRIPTION
+
+Inherits all methods from SNMP::Info::Layer3
 
 =head1 AUTHOR
 
@@ -218,90 +201,43 @@ Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- # Let SNMP::Info determine the correct subclass for you. 
+ my $aironet = new SNMP::Info::Layer3::Aironet(DestHost  => 'myswitch',
- my $aironet = new SNMP::Info(
+                               Community => 'public');
-                          AutoSpecify => 1,
+ my $mac = $aironet->mac(); 
-                          Debug       => 1,
+
-                          # These arguments are passed directly on to SNMP::Session
+=head1 CREATING AN OBJECT
-                          DestHost    => 'myswitch',
+
+=over
+
+=item  new SNMP::Info::Layer3::Aironet()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $aironet = new SNMP::Info::Layer3::Aironet(
+        DestHost => $host,
         Community => 'public',
-                          Version     => 2
+        Version => 3,...
         ) 
-    or die "Can't connect to DestHost.\n";
+    die "Couldn't connect.\n" unless defined $aironet;
-
- my $class      = $aironet->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
-
-=head1 DESCRIPTION
-
-SNMP::Info subclass to provide access to SNMP data for an Aironet device running Aironet software,
-not cisco IOS.
-
-Note there are two classes for Aironet devices :
-
-=over
-
-=item SNMP::Info::Layer3::Aironet
-
-This class is for devices running Aironet software (older)
-
-=item SNMP::Info::Layer2::Aironet
-
-This class is for devices running Cisco IOS software (newer)
 
 =back
 
-For speed or debugging purposes you can call the subclass directly, but not after determining
+=head1 Globals
-a more specific class using the method above. 
-
- my $aironet = new SNMP::Info::Layer3::Aironet(...);
-
-=head2 Inherited Classes
 
 =over
 
-=item SNMP::Info::Layer3
-
-=back
-
-=head2 Required MIBs
-
-=over
-
-=item AWCVX-MIB
-
-=item IEEE802dot11-MIB
-
-=back
-
-These MIBs are now included in the v2.tar.gz archive available from ftp.cisco.com.  Make sure you 
-have a current version. 
-
-=head1 GLOBALS
-
-These are methods that return scalar value from SNMP
-
-=over
-
-=item $aironet->awc_duplex()
-
-Gives the admin duplex setting for the Ethernet Port.
-
-B<awcEtherDuplex.0>
-
 =item $aironet->mac()
 
 Gives the MAC Address of the wireless side 
 
 B<dot11StationID.2>
 
-=item $aironet->os()
+=item $aironet->awc_duplex()
 
-'aironet'
+Gives the admin duplex setting for the Ethernet Port.
 
-=item $aironet->os_ver
+B<awcEtherDuplex.0>
-
-Tries to cull the version from the description field.
 
 =item $aironet->vendor()
 
@@ -309,48 +245,8 @@ Returns 'cisco'.
 
 =back
 
-=head2 Globals imported from SNMP::Info::Layer3
-
-See documentation in SNMP::Info::Layer3 for details.
-
 =head1 TABLE ENTRIES
 
-These are methods that return tables of information in the form of a reference
-to a hash.
-
-=head2 Overrides
-
-=over
-
-=item $aironet->bp_index()
-
-Takes the bp_index() value from SNMP::Info::Bridge and overrides the wireless port 
-to be assigned to the transparent bridge port (port 0)
-
-=item $aironet->fw_mac()
-
-Adds static table entries from bs_mac() to port 0 so that wireless MAC addresses will
-be reported.  Forwarding table entries for port 0 are removed.
-
-=item $aironet->fw_port()
-
-Adds the static table port mappings to the forwarding table port mappings by adding 
-bs_port() to fw_port()
-
-=item $aironet->i_duplex()
-
-Adds the value of awc_duplex() to each Ethernet port seen.
-
-=item $aironet->i_mac()
-
-Overrides the values for i_mac with the value from awc_mac() if they are set.
-
-=item $aironet->i_ignore()
-
-Ignores ports that are of type ``rptr'' and ``lo''.
-
-=back
-
 =head2 Aironet specific items
 
 =over
@@ -385,8 +281,37 @@ B<awcIfMSDUMaxLength>
 
 =back
 
-=head2 Table Methods imported from SNMP::Info::Layer3
+=head2 Overrides
 
-See documentation in SNMP::Info::Layer3 for details.
+=over
+
+=item $aironet->bp_index()
+
+Takes the bp_index() value from SNMP::Info::Bridge and overrides the wireless port 
+to be assigned to the transparent bridge port (port 0)
+
+=item $aironet->fw_mac()
+
+Adds static table entries from bs_mac() to port 0 so that wireless MAC addresses will
+be reported.  Forwarding table entries for port 0 are removed.
+
+=item $aironet->fw_port()
+
+Adds the static table port mappings to the forwarding table port mappings by adding 
+bs_port() to fw_port()
+
+=item $aironet->i_duplex()
+
+Adds the value of awc_duplex() to each Ethernet port seen.
+
+=item $aironet->i_mac()
+
+Overrides the values for i_mac with the value from awc_mac() if they are set.
+
+=item $aironet->i_ignore()
+
+Ignores ports that are of type ``rptr'' and ``lo''.
+
+=back
 
 =cut

Info/Layer3/C3550.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Layer3::C3550;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 
 use strict;
@@ -201,60 +201,44 @@ __END__
 
 SNMP::Info::Layer3::C3550 - Perl5 Interface to Cisco Catalyst 3550 Layer 2/3 Switches running IOS
 
+=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.
+
 =head1 AUTHOR
 
 Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- # Let SNMP::Info determine the correct subclass for you. 
+ my $c3550 = new SNMP::Info::Layer3::C3550(DestHost  => 'router' , 
- my $c3550 = new SNMP::Info(
+                              Community => 'public' ); 
-                          AutoSpecify => 1,
+
-                          Debug       => 1,
+
-                          # These arguments are passed directly on to SNMP::Session
+See L<SNMP::Info> and L<SNMP::Info::Layer3> for all the inherited methods.
-                          DestHost    => 'myswitch',
+
+=head1 CREATING AN OBJECT
+
+=over
+
+=item  new SNMP::Info::Layer3::C3550()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $c3550 = new SNMP::Info::Layer3::C3550(
+        DestHost => $host,
         Community => 'public',
-                          Version     => 2
+        Version => 3,...
         ) 
-    or die "Can't connect to DestHost.\n";
+    die "Couldn't connect.\n" unless defined $c3550;
-
- 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
 
 =back
 
-=head2 Required MIBs
+=head1 GLOBAL Values
-
-=over
-
-=item CISCO-STACK-MIB
-
-=item CISCO-VTP-MIB
-
-=back
-
-=head1 GLOBALS
-
-These are methods that return scalar value from SNMP
 
 =over
 
@@ -288,15 +272,8 @@ These are methods that return scalar value from SNMP
 
 =back
 
-=head2 Globals imported from SNMP::Info::Layer3
-
-See documentation in SNMP::Info::Layer3 for details.
-
 =head1 TABLE ENTRIES
 
-These are methods that return tables of information in the form of a reference
-to a hash.
-
 =head2 Overrides
 
 =over
@@ -328,31 +305,24 @@ Munges bit_string returned from p_duplex_admin to get duplex settings.
 =over
 
 =item $c3550->p_name()
-
 (B<portName>)
 
 =item $c3550->p_type()
-
 (B<portType>)
 
 =item $c3550->p_status()
-
 (B<portOperStatus>)
 
 =item $c3550->p_status2()
-
 (B<portAdditionalStatus>)
 
 =item $c3550->p_speed()
-
 (B<portAdminSpeed>)
 
 =item $c3550->p_duplex()
-
 (B<portDuplex>)
 
 =item $c3550->p_port()
-
 (B<portIfIndex>)
 
 =back
@@ -362,11 +332,9 @@ Munges bit_string returned from p_duplex_admin to get duplex settings.
 =over
 
 =item $c3550->p_speed_admin()
-
 (B<portCpbSpeed>)
 
 =item $c3550->p_duplex_admin()
-
 (B<portCpbDuplex>)
 
 =back
@@ -376,28 +344,22 @@ Munges bit_string returned from p_duplex_admin to get duplex settings.
 See ftp://ftp.cisco.com/pub/mibs/supportlists/wsc5000/wsc5000-communityIndexing.html
 for a good treaty of how to connect to the VLANs
 
+
 =over
 
 =item $c3550->v_state()
-
 (B<vtpVlanState>)
 
 =item $c3550->v_type()
-
 (B<vtpVlanType>)
 
 =item $c3550->v_name()
-
 (B<vtpVlanName>)
 
 =item $c3550->v_mtu()
-
 (B<vtpVlanMtu>)
 
 =back
 
-=head2 Table Methods imported from SNMP::Info::Layer3
-
-See documentation in SNMP::Info::Layer3 for details.
-
 =cut
+

Info/Layer3/Foundry.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::Layer3::Foundry;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 
 use strict;
@@ -222,7 +222,16 @@ __END__
 
 =head1 NAME
 
-SNMP::Info::Layer3::Foundry - Perl5 Interface to Foundry FastIron Network Devices
+SNMP::Info::Layer3::Foundry - Perl5 Interface to Foundry Network Devices
+
+=head1 DESCRIPTION
+
+This module provides limited functionality from older Foundry devices.
+Specifically designed for a FI4802
+
+Data comes RFC1213 and FOUNDRY-SN-ROOT-MIB
+
+Inherits all methods from both SNMP::Info and SNMP::Info::Bridge
 
 =head1 AUTHOR
 
@@ -230,60 +239,30 @@ Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- # Let SNMP::Info determine the correct subclass for you. 
+ my $foundry = new SNMP::Info::Layer3::Foundry(DestHost  => 'switch' , 
- my $foundry = new SNMP::Info(
+                              Community => 'public' ); 
-                          AutoSpecify => 1,
+
-                          Debug       => 1,
+See L<SNMP::Info> and L<SNMP::Info::Layer3> for all inherited methods.
-                          # These arguments are passed directly on to SNMP::Session
+
-                          DestHost    => 'myswitch',
+=head1 CREATING AN OBJECT
+
+=over
+
+=item  new SNMP::Info::Layer3::Foundry()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $foundry = new SNMP::Info::Layer3::Foundry(
+        DestHost => $host,
         Community => 'public',
-                          Version     => 1
+        Version => 3,...
         ) 
-    or die "Can't connect to DestHost.\n";
+    die "Couldn't connect.\n" unless defined $foundry;
-
- my $class      = $foundry->class();
- print "SNMP::Info determined this device to fall under subclass : $class\n";
-
-=head1 DESCRIPTION
-
-This subclass no longer supported.
-
-This module provides limited functionality from older Foundry devices.
-
-Specifically designed for a FI4802.
-
-For speed or debugging purposes you can call the subclass directly, but not after determining
-a more specific class using the method above.  Turn off the AutoSpecify flag.
-
- my $foundry = new SNMP::Info::Layer3::Foundry(...);
-
-=head2 Inherited Classes
-
-=over
-
-=item SNMP::Info
-
-=item SNMP::Info::Bridge
 
 =back
 
-=head2 Required MIBs
+=head1 GLOBAL VALUES
-
-=over
-
-=item FOUNDRY-SN-ROOT-MIB
-
-=item Inherited Classes' MIBs
-
-See classes listed above for their required MIBs.
-
-=back
-
-The Foundry MIBS can be downloaded from www.mibdepot.com and ??
-
-=head1 GLOBALS
-
-These are methods that return scalar value from SNMP
 
 =over
 
@@ -340,19 +319,8 @@ Returns the status of the chassis fan.
 
 =back
 
-=head2 Globals imported from SNMP::Info
-
-See documentation in SNMP::Info for details.
-
-=head2 Globals imported from SNMP::Info::Bridge
-
-See documentation in SNMP::Info::Bridge for details.
-
 =head1 TABLE ENTRIES
 
-These are methods that return tables of information in the form of a reference
-to a hash.
-
 =head2 Overrides
 
 =over
@@ -449,12 +417,4 @@ Returns reference to hash.  Current Port Speed.
 
 =back
 
-=head2 Table Methods imported from SNMP::Info
-
-See documentation in SNMP::Info for details.
-
-=head2 Table Methods imported from SNMP::Info::Bridge
-
-See documentation in SNMP::Info::Bridge for details.
-
 =cut

Info/MAU.pm

@@ -28,7 +28,7 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 package SNMP::Info::MAU;
-$VERSION = 0.4;
+$VERSION = 0.3;
 # $Id$
 
 use strict;
@@ -109,7 +109,15 @@ __END__
 
 =head1 NAME
 
-SNMP::Info::MAU - Perl5 Interface to Medium Access Unit (MAU) MIB (RFC2668) via SNMP
+SNMP::Info::MAU - Perl5 Interface to SNMP Medium Access Unit (MAU) MIB (RFC2668) 
+
+=head1 DESCRIPTION
+
+MAU-MIB is used by Layer 2 devices like HP Switches . The MAU table
+contains link and duplex info for the port itself and the device
+connected to that port.
+
+Inherits all methods from SNMP::Info
 
 =head1 AUTHOR
 
@@ -117,47 +125,28 @@ Max Baker (C<max@warped.org>)
 
 =head1 SYNOPSIS
 
- my $mau = new SNMP::Info ( 
+ my $mau = new SNMP::Info::MAU(      DestHost  => 'myswitch',
-                             AutoSpecify => 1,
+                               Community => 'public');
-                             Debug       => 1,
-                             DestHost    => 'hpswitch', 
-                             Community   => 'public',
-                             Version     => 2
-                           );
 
- my $class = $mau->class();
+=head1 CREATING AN OBJECT
- print " Using device sub class : $class\n";
-
-=head1 DESCRIPTION
-
-SNMP::Info::MAU is a sublcass of SNMP::Info that supplies access to the
-MAU-MIB (RFC2668). This MIB is sometimes implemented on Layer 2 network devices like HP Switches.
-MAU = Media Access Unit.
-
-The MAU table contains link and duplex info for the port itself and the device
-connected to that port.
-
-Normally you use or create a subclass of SNMP::Info that inherits this one.  Do not use directly.
-
-For debugging purposes call the class directly as you would SNMP::Info
-
- my $mau = new SNMP::Info::MAU(...);
-
-=head2 Inherited Classes
-
-None.
-
-=head2 Required MIBs
 
 =over
 
-=item MAU-MIB
+=item  new SNMP::Info::MAU()
+
+Arguments passed to new() are passed on to SNMP::Session::new()
+    
+
+    my $mau = new SNMP::Info::MAU(
+        DestHost => $host,
+        Community => 'public',
+        Version => 3,...
+        ) 
+    die "Couldn't connect.\n" unless defined $mau;
 
 =back
 
-=head1 GLOBALS
+=head1 MAU Global Configuration Values
-
-These are methods that return scalar value from SNMP
 
 =over
 
@@ -165,12 +154,7 @@ These are methods that return scalar value from SNMP
 
 =back
 
-=head1 TABLE METHODS
+=head1 MAU INTERFACE TABLE ENTRIES
-
-These are methods that return tables of information in the form of a reference
-to a hash.
-
-=head2 MAU INTERFACE TABLE ENTRIES
 
 =over
 
@@ -270,5 +254,4 @@ capabilities of the device on the other end.
     high.  Currently bits 10,12,15,17,19.
 
 =back
-
 =cut

MANIFEST

@@ -1,10 +1,8 @@
-COPYRIGHT
 ChangeLog
+COPYRIGHT
 Info.pm
 Info/Bridge.pm
 Info/CDP.pm
-Info/CiscoStats.pm
-Info/Entity.pm
 Info/EtherLike.pm
 Info/Layer1.pm
 Info/Layer1/Allied.pm
@@ -17,10 +15,10 @@ Info/Layer2/Catalyst.pm
 Info/Layer2/HP.pm
 Info/Layer3.pm
 Info/Layer3/Aironet.pm
-Info/Layer3/C3550.pm
 Info/Layer3/Foundry.pm
+Info/Layer3/C3550.pm
 Info/MAU.pm
 MANIFEST
 Makefile.PL
 README
-t/prereq.t
+test.pl

Makefile.PL

@@ -5,12 +5,8 @@ use ExtUtils::MakeMaker;
 WriteMakefile(
     'NAME'               => 'SNMP::Info',
     'VERSION_FROM'       => 'Info.pm',
-    'PREREQ_PM'          => {
+# SNMP not available on CPAN -- not installable by CPAN
-                                'Math::BigInt' => 0
+#    'PREREQ_PM'          => {'SNMP' => '4'},
-                                # SNMP not available on CPAN . 
-                                # Install with net-snmp.sourceforge.net
-                                # 'SNMP' => '4'
-                            },
     ($] >= 5.005 ?    
           (ABSTRACT_FROM => 'Info.pm', 
            AUTHOR        => 'Max Baker <max@warped.org>')

t/prereq.t

@@ -1,81 +0,0 @@
-#!/usr/local/bin/perl -w
-# prereq.t - Test file for prerequesites for SNMP::Info
-# $Id$
-
-use Test::More tests=> 3;
-
-# Check for SNMP Module
-my $have_snmp=0;
-
-eval {
-    require SNMP;
-};
-
-if ($@){
-    print STDERR <<'end_snmp';
-
-Net-SNMP not found.  Net-SNMP installs the perl modules
-SNMP and SNMP::Session.  As of version 4.2.1 and greater the Perl
-modules are no longer distributed on CPAN, as they are specific to different
-versions of SNMP. 
-
-Install Net-SNMP from http://net-snmp.sourceforge.net and make sure you run
-configure with the --with-perl-modules switch!
-
-Note to Redhat Users:  Redhat, in its infinite wisdom, does not install the 
-Perl modules as part of their 8.0 RPMS.  Please uninstall them and install the
-newest version by hand.
-
-
-
-end_snmp
-    ok(0,'Net-SNMP not installed, or missing Perl modules.');
-} else {
-    $have_snmp=1;
-    ok(1,'Net-SNMP installed');
-}
-
-# Check for version
-SKIP: {
-    skip('SNMP not installed, no further testing',2) unless $have_snmp;
-
-    my $VERSION = $SNMP::VERSION;
-    ok(defined $VERSION ? 1 : 1, "found version for SNMP");
-
-    my ($ver_maj,$ver_min,$ver_rev) = split(/\./,$VERSION);
-
-    ok ($ver_maj >= 4, 'Net-SNMP ver 4 or higher');
-    
-    if ($ver_maj == 4 and $ver_min == 2 and $ver_rev == 0){
-        print STDERR << "end_420";
-
-SNMP module version 4.2.0 found.  Please triple check that you have
-version 4.2.0 of Net-SNMP installed, and that you did not accidently install
-the SNMP module found on CPAN.  All newer versions are bundled with 
-Net-SNMP, and are not available on CPAN.  Please find them at 
-http://net-snmp.sourceforge.net .  Make sure you run configure with the 
---with-perl-modules switch.
-
-end_420
-    }
- 
-    if( $ver_maj == 5 and $ver_min == 0 and $ver_rev == 1 ){
-        print STDERR << "end_501";
-
-
-Perl module of Net-SNMP 5.0.1 is buggy. Please upgrade.
-
-
-end_501
-
-    } 
-}
-
-print STDERR << "end_mibs";
-
-
-Make sure you download and install the MIBS needed for SNMP::Info.   
-See Man page or perldoc for SNMP::Info.
-
-end_mibs
-# vim:syntax=perl