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.