SNMP::...tscreen(3pm)

💖 NAME 💖

okay so you clicked into the manual page for SNMP::...tscreen(3pm) (the header squished the name, but the real one is right here bestie 👇)

SNMP::Info::Layer3::Netscreen — an 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";

like… the vibe is: you let SNMP::Info sniff out the correct subclass all by itself, and if it can't reach your box it just dies with Can't connect to DestHost.\n. no notes. 😭

---

🌸 DESCRIPTION 🌸

It gives you an abstraction — a whole cute little layer — over all the configuration info you can pull off a Juniper Netscreen device through SNMP. that's the assignment and it ate. 💅

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

(yes bestie, you need the MIBs from the parents too, they don't come free 🫶)

---

👑 GLOBALS 👑

These are methods that return scalar value from SNMP — one value, no table energy, just a straight answer. ✨

• $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. the device doesn't report layers properly, so this was modified to reflect Layer 2 and 3 functionality. lowkey iconic that it just lies and we handle it 🌈

🎀 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. hashes on hashes on hashes, we love to see it 💜

💅 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'. vibe check on the cable fr fr 🔥

("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. it's giving borrowed-but-make-it-work 💅

• $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 🌟

(yeah bestie it's nested in here under Arp Cache — that's just where the page puts it, we don't make the rules 🫠)

• $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.

---

and that's the whole page, you're caught up bestie 🫶 this gem is from perl v5.40.1, dated 2026-02-28, and it's part of the User Contributed Perl Documentation — go be the main character in your SNMP stack now 💜✨👑