AUTHOR

Kent Hamilton

SYNOPSIS

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

DESCRIPTION

Provides abstraction to the configuration information obtainable from a Juniper Netscreen devices 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 $netscreen = new SNMP::Info::Layer3::Netscreen(...);

Inherited Classes

SNMP::Info::Layer3

SNMP::Info::IEEE802dot11

Required MIBs

NETSCREEN-SMI

NETSCREEN-PRODUCTS-MIB

NETSCREEN-INTERFACE-MIB

NETSCREEN-SET-GEN-MIB

NETSCREEN-IP-ARP-MIB

Inherited Classes' MIBs

See ``Required MIBs'' in SNMP::Info::Layer3 for its MIB requirements.

See ``Required MIBs'' in SNMP::Info::IEEE802dot11 for its MIB requirements.

GLOBALS

These are methods that return scalar value from SNMP

$netscreen->model()

Tries to reference $netscreen->id() to NETSCREEN-PRODUCTS-MIB

$netscreen->vendor()

Returns 'juniper'

$netscreen->os()

Returns 'screenos'

$netscreen->os_ver()

Extracts the OS version from the description string.

$netscreen->serial()

Returns serial number.

Overrides

$netscreen->layers()

Returns 01001110. Device doesn't report layers properly, modified to reflect Layer 2 and 3 functionality.

Globals imported from SNMP::Info::Layer3

See ``GLOBALS'' in SNMP::Info::Layer3 for details.

Globals imported from SNMP::Info::IEEE802dot11

See ``GLOBALS'' in SNMP::Info::IEEE802dot11 for details.

TABLE METHODS

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

Overrides

Interface Information

$netscreen->interfaces()

Creates a map between the interface identifier (iid) and the physical port name.

Defaults to "insIfDescr" if available, uses "nsIfName" if not.

$netscreen->i_description()

Description of the interface. Uses "insIfDescr" if available, "nsIfName" if not.

$netscreen->i_ignore()

Returns without defining any interfaces to ignore.

$netscreen->i_index()

Default SNMP IID to Interface index.

("nsIfIndex")

$netscreen->i_lastchange()

The value of "sysUpTime" when this port last changed states (up,down), maps from "ifIndex" to "nsIfIndex".

("ifLastChange")

$netscreen->i_mac()

MAC address of the interface. Note this is just the MAC of the port, not anything connected to it. Uses "nsIfMAC" if available, "ifPhysAddress" if not.

$netscreen->i_mtu()

INTEGER. Interface MTU value, maps from "ifIndex" to "nsIfIndex".

("ifMtu")

$netscreen->i_name()

Interface Name field.

("nsIfName")

$netscreen->i_speed()

Speed of the link, maps from "ifIndex" to "nsIfIndex".

$netscreen->i_type()

Interface type. Maps from "ifIndex" to "nsIfIndex".

("ifType")

$netscreen->i_up()

Link Status of the interface. Typical values are 'up' and 'down'.

("nsIfStatus")

$netscreen->i_up_admin()

Administrative status of the port. Checks both "ifAdminStatus" and "nsIfStatus".

IP Address Table

Each entry in this table is an IP address in use on this device.

$netscreen->ip_index()

Maps the IP Table to the IID

$netscreen->ip_table()

Maps the Table to the IP address

("nsIfIp")

$netscreen->ip_netmask()

Gives netmask setting for IP table entry.

("nsIfNetmask")

Forwarding Table

Uses "nsIpArpTable" to emulate the forwarding table.

$netscreen->fw_index()

Maps the Forwarding Table to the IID

$netscreen->fw_mac()

Returns reference to hash of forwarding table MAC Addresses.

$netscreen->fw_port()

Returns reference to hash of forwarding table entries port interface identifier (IID).

$netscreen->bp_index()

Returns reference to hash of bridge port table entries map back to interface identifier (IID).

Arp Cache Table

$netscreen->at_index()

Returns reference to hash. Maps ARP table entries to Interface IIDs

If the device doesn't support "ipNetToMediaIfIndex", this will try the proprietary "nsIpArpIfIdx".

$netscreen->at_paddr()

Returns reference to hash. Maps ARP table entries to MAC addresses.

If the device doesn't support "ipNetToMediaPhysAddress", this will try the proprietary "nsIpArpMac".

$netscreen->at_netaddr()

Returns reference to hash. Maps ARP table entries to IP addresses.

If the device doesn't support "ipNetToMediaNetAddress", this will try the proprietary "nsIpArpIp".

Wireless Information

$dot11->i_ssidlist()

Returns reference to hash. SSID's recognized by the radio interface. Remaps from "ifIndex" to "nsIfIndex".

("dot11DesiredSSID")

$dot11->i_80211channel()

Returns reference to hash. Current operating frequency channel of the radio interface. Remaps from "ifIndex" to "nsIfIndex".

Table Methods imported from SNMP::Info::Layer3

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

Table Methods imported from SNMP::Info::IEEE802dot11

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