SNMP::Info::Layer2::Baystack.3pm

Langue: en

Version: 2006-06-30 (fedora - 05/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

SNMP::Info::Layer2::Baystack - SNMP Interface to Nortel Ethernet (Baystack) Switches

AUTHOR

Eric Miller

SYNOPSIS

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

DESCRIPTION

Provides abstraction to the configuration information obtainable from a Nortel Ethernet Switch (Baystack) 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 $baystack = new SNMP::Info::Layer2::Baystack(...);

Inherited Classes

SNMP::Info
SNMP::Info::Bridge
SNMP::Info::NortelStack
SNMP::Info::SONMP
SNMP::Info::RapidCity

Required MIBs

Inherited Classes' MIBs
See SNMP::Info for its own MIB requirements.

See SNMP::Info::Bridge for its own MIB requirements.

See SNMP::Info::NortelStack for its own MIB requirements.

See SNMP::Info::SONMP for its own MIB requirements.

See SNMP::Info::RapidCity for its own MIB requirements.

GLOBALS

These are methods that return scalar value from SNMP
$baystack->vendor()
Returns 'nortel'
$baystack->model()
Cross references $baystack->id() to the SYNOPTICS-MIB and returns the results. 303s and 304s have the same ID, so we have a hack to return depending on which it is.

Returns BPS for Business Policy Switch

For BayStack, EthernetRoutingSwitch, or EthernetSwitch extracts and returns the switch numeric designation.

$baystack->os()
Returns 'baystack' or 'boss' depending on software version.
$baystack->os_bin()
Returns the firmware version extracted from sysDescr.

Overrides

$baystack->index_factor()
Required by SNMP::Info::SONMP. Number representing the number of ports reserved per slot within the device MIB.

Index factor on the Baystack switches are determined by the formula: Index Factor = 64 if (model = 470 or (os eq 'boss' and operating in pure mode)) or else Index factor = 32.

Returns either 32 or 64 based upon the formula.

Globals imported from SNMP::Info

See documentation in SNMP::Info for details.

Globals imported from SNMP::Info::Bridge

See documentation in SNMP::Info::Bridge for details.

Globals imported from SNMP::Info::NortelStack

See documentation in SNMP::Info::NortelStack for details.

Global Methods imported from SNMP::Info::SONMP

See documentation in SNMP::Info::SONMP for details.

Global Methods imported from SNMP::Info::RapidCity

See documentation in SNMP::Info::RapidCity for details.

TABLE ENTRIES

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

Overrides

$baystack->interfaces()
Returns reference to the map between IID and physical Port.
   Slot and port numbers on the Baystack switches are determined by the formula:
   
   port = (Interface index % Index factor)
   slot = (int(Interface index / Index factor)) + Slot offset
  
   The physical port name is returned as slot.port.
 
 
$baystack->i_ignore()
Returns reference to hash of IIDs to ignore.
$baystack->i_mac()
Returns the ifPhysAddress table entries.

Removes all entries matching '00:00:00:00:00:00' --- Certain revisions of Baystack firmware report all zeros for each port mac.

$baystack->i_name()
Crosses ifName with ifAlias and returns the human set port name if exists.

RFC1213 Arp Cache Table (ipNetToMediaTable)

$baystack->at_index()
Returns reference to hash. Maps ARP table entries to Interface IIDs

(ipNetToMediaIfIndex)

$baystack->at_paddr()
Returns reference to hash. Maps ARP table entries to MAC addresses.

(ipNetToMediaPhysAddress)

$baystack->at_netaddr()
Returns reference to hash. Maps ARP table entries to IPs

(ipNetToMediaNetAddress)

Table Methods imported from SNMP::Info

See documentation in SNMP::Info for details.

Table Methods imported from SNMP::Info::Bridge

See documentation in SNMP::Info::Bridge for details.

Table Methods imported from SNMP::Info::NortelStack

See documentation in SNMP::Info::NortelStack for details.

Table Methods imported from SNMP::Info::SONMP

See documentation in SNMP::Info::SONMP for details.

Table Methods imported from SNMP::Info::RapidCity

See documentation in SNMP::Info::RapidCity for details.