NAME

SNMP::Info::Layer3::Netscreen - SNMP Interface to Juniper Netscreen Devices

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.