AUTHOR

Max Baker

SYNOPSIS

This module is Deprecated. Please use Layer2::BayStack instead.

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 a more specific class using the method above.

 my $bay = new SNMP::Info::Layer2::Bay(...);

Inherited Classes

SNMP::Info::Layer2

Required MIBs

SYNOPTICS-ROOT-MIB

S5-ETH-MULTISEG-TOPOLOGY-MIB

Inherited classes

MIBs required by ``Required MIBs'' in SNMP::Info::Layer2 and its superclasses.

GLOBALS

These are methods that return scalar value from SNMP

$bay->vendor()

Returns 'bay' :)

$bay->model()

Cross references $bay->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.

Removes "sreg-" from the model name

$baystack->os()

Returns 'bay'.

$bay->os_ver()

Returns the os version extracted from "sysDescr".

$bay->os_bin()

Returns the firmware version extracted from "sysDescr".

$bay->cdp_id()

Returns the IP that the device is sending out for its Nmm topology info.

("s5EnMsTopIpAddr")

$bay->cdp_run()

Returns if the S5-ETH-MULTISEG-TOPOLOGY info is on for this device.

("s5EnMsTopStatus")

Globals imported from SNMP::Info::Layer2

See documentation in ``GLOBALS'' in SNMP::Info::Layer2 for details.

TABLE METHODS

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

Overrides

$bay->interfaces()

Returns reference to map of IIDs to physical ports.

Currently simply returns the "ifIndex"

$bay->i_ignore()

Returns reference to hash of IIDs to ignore.

Simply calls the SNMP::Info::Layer2::i_ignore() for this.

$bay->i_mac()

Returns the "ifPhysAddress" table entries.

Removes all entries matching '00:00:00:00:00:00' --- Certain older revisions of Bay 303 and 304 firmware report all zeros for each port mac.

Pseudo CDP information

All entries with port=0 are local and ignored.

$bay->c_if()

Returns reference to hash. Key: port.1 Value: port (iid)

$bay->c_ip()

Returns reference to hash. Key: port.1

The value of each hash entry can either be a scalar or an array. A scalar value is most likely a direct neighbor to that port. It is possible that there is a non-bay device in between this device and the remote device.

An array value represents a list of seen devices. The only time you will get an array of neighbors, is if there is a non-bay device in between two or more devices.

Use the data from the Layer2 Topology Table below to dig deeper.

$bay->c_port()

Returns reference to hash. Key: IID, Value: Remote port (interfaces)

$bay->c_platform()

Returns reference to hash. Key: IID, Value: Remote device type

$bay->port()

Returns reference to hash. Key: port.1 Value: port

$bay->platform()

Returns reference to hash. Key: port.1 Value: Remote Device Type

Layer2 Topology info (s5EnMsTopNmmTable)

$bay->bay_topo_slot()

Returns reference to hash. Key: Table entry, Value:slot number

("s5EnMsTopNmmSlot")

$bay->bay_topo_port()

Returns reference to hash. Key: Table entry, Value:Port Number (interface iid)

("s5EnMsTopNmmPort")

$bay->bay_topo_ip()

Returns reference to hash. Key: Table entry, Value:Remote IP address of entry

("s5EnMsTopNmmIpAddr")

$bay->bay_topo_seg()

Returns reference to hash. Key: Table entry, Value:Remote Segment ID

("s5EnMsTopNmmSegId")

$bay->bay_topo_mac ("s5EnMsTopNmmMacAddr")

Returns reference to hash. Key: Table entry, Value:Remote MAC address

$bay->bay_topo_platform

Returns reference to hash. Key: Table entry, Value:Remote Device Type

("s5EnMsTopNmmChassisType")

$bay->bay_topo_localseg

Returns reference to hash. Key: Table entry, Value:Boolean, if bay_topo_seg() is local

("s5EnMsTopNmmLocalSeg")

Table Methods imported from SNMP::Info::Layer2

See documentation in ``TABLE METHODS'' in SNMP::Info::Layer2 for details.