SNMP::Info::Layer3::Netscreen(3p)

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 device through SNMP.

  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_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.