SNMP::...::Nexus(3pm)

💖 SNMP::...::Nexus 💖

okay bestie, sit down, we're doing SNMP::...::Nexus — like, the SNMP Interface to Cisco Nexus Switches running NX-OS. yes that's the whole NAME. it's giving Perl documentation, user contributed, and honestly? iconic.

It's the SNMP::Info glue for Cisco Nexus Switches running NX-OS. 💅

---

✨ AUTHOR ✨

Eric Miller 🫶

---

🌸 SYNOPSIS 🌸

so here's the vibe. literally just let SNMP::Info figure out the right subclass for you, no cap:

# Let SNMP::Info determine the correct subclass for you.
my $nexus = new SNMP::Info(
                                               AutoSpecify => 1,
                                               Debug       => 1,
                                               # These arguments are passed directly to SNMP::Session
                                               DestHost    => 'myswitch',
                                               Community   => 'public',
                                               Version     => 2
                                               )
       or die "Can't connect to DestHost.\n";

my $class      = $nexus->class();
print "SNMP::Info determined this device to fall under subclass : $class\n";

like, it just tells you what class your switch is. main character energy fr fr. 👑

---

🦋 DESCRIPTION 🦋

It's an abstraction subclass for Cisco Nexus Switches running NX-OS. that's the whole personality and she serves. 🎀

If you're doing it for speed or for debugging, you can call the subclass directly — but not after you've already determined a more specific class with the method up above. don't do that. it's not the move. 😭

my $nexus = new SNMP::Info::Layer3::Nexus(...);

💜 Inherited Classes

• SNMP::Info::Layer3::CiscoSwitch

💜 Required MIBs

• CISCO-ENTITY-VENDORTYPE-OID-MIB
• CISCO-CONTEXT-MAPPING-MIB

🌈 Inherited Classes' MIBs

See "Required MIBs" in SNMP::Info::Layer3::CiscoSwitch for its own MIB requirements. yes queen, go read her page too. 💖

---

⭐ GLOBALS ⭐

These are methods that return a scalar value from SNMP. one little value, one little vibe. 🍓

• $nexus->os() — Returns 'nx-os'. that's it. that's the answer.
• $nexus->os_ver() — Returns the operating system version extracted from "sysDescr". 🔍
• $nexus->serial() — Returns the serial number of the chassis from ENTITY-MIB. yes, the chassis. the whole girl. 👑
• $nexus->model() — Tries to reference $nexus->id() to CISCO-ENTITY-VENDORTYPE-OID-MIB. Removes 'cevChassis' for readability. she said clean it up. ✨
• $nexus->mac() — "dot1dBaseBridgeAddress" 🫶

🌸 Overrides 🌸

IP Address Table

Each entry in this table is an IP address in use on this device. Some versions do not index the table with the IPv4 address in accordance with the MIB definition — and these overrides correct that behavior. periodt. 💅

Also?? the table gets augmented with IP addresses in use by UDP sockets on the device, as determined by checking RFC1213-MIB::udpLocalAddress. Valid addresses from this table — that's any IPv4 that is not localhost, not 0.0.0.0, not Class D (multicast), and not Class E (experimental) — are added as a /32 on interface ID 0. 🧚

bestie this is a workaround to determine possible VPC Keepalive IP addresses on the device, which are probably advertised by CDP/LLDP to neighbors. it's not magic, it's just clever. iykyk. 🔥

• $nexus->ip_index() — Maps the IP Table to the IID ("ipAdEntIfIndex") 🎀
• $nexus->ip_table() — Maps the Table to the IP address ("ipAdEntAddr") 💖
• $nexus->ip_netmask() — Gives netmask setting for IP table entry. ("ipAdEntNetMask") 🌸
• $nexus->ip_broadcast() — Gives broadcast address for IP table entry. ("ipAdEntBcastAddr") 📣
• $nexus->lldp_lport_desc() — On nx-os 6 only, this will return data from "lldpLocPortId" instead of the expected "lldpLocPortDesc". For all other nx-os versions it uses the function from SNMP::Info::LLDP. okay so that's a weird little quirk but we love her anyway. 🙈

💜 Globals imported from SNMP::Info::Layer3::CiscoSwitch

See documentation in "GLOBALS" in SNMP::Info::Layer3::CiscoSwitch for details. go look, the receipts are all there. 🫶

---

🔥 TABLE METHODS 🔥

These are methods that return tables of information in the form of a reference to a hash. hash refs, we're obsessed. 🍓

💜 Table Methods imported from SNMP::Info::Layer3::CiscoSwitch

See documentation in "TABLE METHODS" in SNMP::Info::Layer3::CiscoSwitch for details. 👑

---

and that's the whole page bestie, no notes, you ate this. 🎀

signed off with love from perl v5.40.1, dated 2026-02-28, under the SNMP::...::Nexus(3pm) header — the user contributed Perl documentation girlies. mwah. 💋 🌈