---
name: "SNMP::Info::Layer1::S3000"
section: "3pm"
platform: "linux"
package: "libsnmp-info-perl"
version: "3.972002-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SNMP::Info::Layer1::S3000"
---

# SNMP::Info::Layer1::S3000(3pm)

SNMP Interface to Synoptics / Nortel Hubs

## NAME

SNMP::Info::Layer1::S3000 - SNMP Interface to Synoptics / Nortel Hubs

## AUTHOR

Eric Miller

## SYNOPSIS

```
    #Let SNMP::Info determine the correct subclass for you.
    my $s3000 = new SNMP::Info(
                          AutoSpecify => 1,
                          Debug       => 1,
                          DestHost    => 'myswitch',
                          Community   => 'public',
                          Version     => 2
                        )
    or die "Can't connect to DestHost.\n";
    my $class = $s3000->class();
    print "SNMP::Info determined this device to fall under subclass : $class\n";
```

## DESCRIPTION

Provides abstraction to the configuration information obtainable from a Bay hub device through SNMP.  Also provides device MAC to port mapping through the proprietary MIB.

### Inherited Classes

- SNMP::Info::Layer2

  ### Required MIBs

- *SYNOPTICS-COMMON-MIB*

  - *SYNOPTICS-ETHERNET-MIB*

  ### Inherited MIBs

See "Required MIBs" in SNMP::Info::Layer2 for its MIB requirements.

## GLOBALS

These are methods that return scalar value from SNMP

- $s3000-\>**vendor()**

  Returns 'nortel'

- $s3000-\>**os()**

  Returns 'synoptics'

- $s3000-\>**model()**

  Cross references `$s3000`-\>**id()** to the *SYNOPTICS-MIB* and returns the results.

  Removes `"sreg-"` from the model name and returns only the numeric model identifier.

- $stack-\>**os\_ver()**

  Returns the software version specified as major.minor.maint.

  (`"s3AgentSwMajorVer"`).(`"s3AgentSwMinorVer"`).(`"s3AgentSwMaintVer"`)

- $stack-\>**os\_bin()**

  Returns the firmware version. (`"s3AgentFwVer"`)

- $s3000-\>**mac()**

  Returns MAC of the advertised IP address of the device.

### Overrides

- $s3000-\>**layers()**

  Returns 00000011.  Class emulates Layer 2 functionality through proprietary MIBs.

### Globals imported from SNMP::Info::Layer2

See "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

- $s3000-\>**i\_index()**

  Returns reference to map of IIDs to Interface index.

  Since hubs do not support `"ifIndex"`, the interface index is created using the formula (board \* 256 + port).  This is required to support devices with more than one module.

- $s3000-\>**interfaces()**

  Returns reference to map of IIDs to physical ports.

- $s3000-\>**i\_duplex()**

  Returns half, hubs do not support full duplex.

- $s3000-\>**i\_duplex\_admin()**

  Returns half, hubs do not support full duplex.

- $s3000-\>**i\_speed()**

  Returns 10000000.  The hubs only support 10 Mbs Ethernet.

- $s3000-\>**i\_up()**

  Returns (`"s3EnetPortLinkStatus"`) for each port.  Translates on/off to up/down.

- $s3000-\>**i\_up\_admin()**

  Returns (`"s3EnetPortPartStatus"`) for each port.

- $s3000-\>set\_i\_up\_admin(state, ifIndex)

  Sets port state, must be supplied with state and port `"ifIndex"`

  State choices are 'up' or 'down'

  Example:\
     my `%if_map` = reverse %{$s3000-\>**interfaces()**};\
     `$s3000`-\>set\_i\_up\_admin('down', `$if_map`{'1.1'})\
         or die "Couldn't change port state. ",$s3000-\>**error**(1);

- $s3000-\>**bp\_index()**

  Simulates bridge MIB by returning reference to a hash containing the index for both the keys and values.

- $s3000-\>**fw\_port()**

  Returns reference to map of IIDs of the `"SYNOPTICS-ETHERNET-MIB::s3EnetShowNodesTable"` to the Interface index.

- $s3000-\>**fw\_mac()**

  (`"s3EnetShowNodesMacAddress"`)

- $s3000-\>**s3000\_topo\_port()**

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

  (`"s3EnetTopNmmPort"`)

- $s3000-\>**s3000\_topo\_mac()**

  (`"s3EnetTopNmmMacAddr"`)

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

### Table Methods imported from SNMP::Info::Layer2

See "TABLE METHODS" in SNMP::Info::Layer2 for details.