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.