SNMP::...ecurity(3pm)

💖 NAME 💖

SNMP::Info::CiscoPortSecurity — bestie, it's the SNMP interface that goes and grabs all the data from CISCO-PORT-SECURITY-MIB, CISCO-PAE-MIB and CISCO-ERR-DISABLE-MIB. That's the whole vibe. ✨

(Also for the record: this is a 3pm page from the User Contributed Perl Documentation collection, and yes the module name is right there in the title, SNMP::Info::CiscoPortSecurity(3pm) — iykyk 💅)

---

✍️ AUTHOR ✍️

Eric Miller wrote this. Give them their flowers. 🌸

---

✨ SYNOPSIS ✨

Okay so here's the lil intro move — let SNMP::Info figure out the correct subclass for you, no cap:

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

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

That's it, that's the whole flex. 🫶

---

🌸 DESCRIPTION 🌸

SNMP::Info::CiscoPortSecurity is a subclass of SNMP::Info that provides an interface to CISCO-PORT-SECURITY-MIB, CISCO-PAE-MIB and CISCO-ERR-DISABLE-MIB. These MIBs are used across the Catalyst family under CatOS and IOS. ✨

Use or create in a subclass of SNMP::Info. Do not use directly. fr fr, not a drill 😭

🦋 Inherited Classes 🦋

None. She's an original. Periodt.

🎀 Required MIBs 🎀

• CISCO-PORT-SECURITY-MIB
• CISCO-PAE-MIB
• IEEE8021-PAE-MIB
• CISCO-ERR-DISABLE-MIB

---

👑 GLOBALS 👑

These are methods that return scalar values from SNMP. Little single-value girls, one and done. 💫

CISCO-PORT-SECURITY-MIB globals 🌈

• $cps->cps_clear() — pulls ("cpsGlobalClearSecureMacAddresses")
• $cps->cps_notify() — pulls ("cpsGlobalSNMPNotifControl")
• $cps->cps_rate() — pulls ("cpsGlobalSNMPNotifRate")
• $cps->cps_enable() — pulls ("cpsGlobalPortSecurityEnable")
• $cps->cps_mac_count() — pulls ("cpsGlobalTotalSecureAddress")
• $cps->cps_mac_max() — pulls ("cpsGlobalMaxSecureAddress")

---

🔥 TABLE METHODS 🔥

"CISCO-PORT-SECURITY-MIB" - Interface Config Table 💅

• $cps->cps_i_limit_val() — pulls ("cpsIfInvalidSrcRateLimitValue")
• $cps->cps_i_limit() — pulls ("cpsIfInvalidSrcRateLimitEnable")
• $cps->cps_i_sticky() — pulls ("cpsIfStickyEnable")
• $cps->cps_i_clear_type() — pulls ("cpsIfClearSecureMacAddresses")
• $cps->cps_i_shutdown() — pulls ("cpsIfShutdownTimeout")
• $cps->cps_i_flood() — pulls ("cpsIfUnicastFloodingEnable")
• $cps->cps_i_clear() — pulls ("cpsIfClearSecureAddresses")
• $cps->cps_i_mac() — pulls ("cpsIfSecureLastMacAddress")
• $cps->cps_i_count() — pulls ("cpsIfViolationCount")
• $cps->cps_i_action() — pulls ("cpsIfViolationAction")
• $cps->cps_i_mac_static() — pulls ("cpsIfStaticMacAddrAgingEnable")
• $cps->cps_i_mac_type() — pulls ("cpsIfSecureMacAddrAgingType")
• $cps->cps_i_mac_age() — pulls ("cpsIfSecureMacAddrAgingTime")
• $cps->cps_i_mac_count() — pulls ("cpsIfCurrentSecureMacAddrCount")
• $cps->cps_i_mac_max() — pulls ("cpsIfMaxSecureMacAddr")
• $cps->cps_i_status() — pulls ("cpsIfPortSecurityStatus")
• $cps->cps_i_enable() — pulls ("cpsIfPortSecurityEnable")

"CISCO-PORT-SECURITY-MIB::cpsIfVlanTable" 🧚

• $cps->cps_i_v_mac_count() — pulls ("cpsIfVlanCurSecureMacAddrCount")
• $cps->cps_i_v_mac_max() — pulls ("cpsIfVlanMaxSecureMacAddr")

"CISCO-PORT-SECURITY-MIB::cpsIfVlanSecureMacAddrTable" 🍓

• $cps->cps_i_v_mac_status() — pulls ("cpsIfVlanSecureMacAddrRowStatus")
• $cps->cps_i_v_mac_age() — pulls ("cpsIfVlanSecureMacAddrRemainAge")
• $cps->cps_i_v_mac_type() — pulls ("cpsIfVlanSecureMacAddrType")

"CISCO-PORT-SECURITY-MIB::cpsSecureMacAddressTable" 🌟

• $cps->cps_m_status() — pulls ("cpsSecureMacAddrRowStatus")
• $cps->cps_m_age() — pulls ("cpsSecureMacAddrRemainingAge")
• $cps->cps_m_type() — pulls ("cpsSecureMacAddrType")

"IEEE8021-PAE-MIB::dot1xPaePortEntry" 💜

• $cps->pae_i_capabilities() — pulls "dot1xPaePortCapabilities"

Indicates the PAE functionality that this Port supports and that may be managed through this MIB, munged to return either 'dot1xPaePortAuthCapable' or 'dot1xPaePortSuppCapable'. She picks a side. 💅

• $cps->pae_i_last_eapol_frame_source() — pulls "dot1xAuthLastEapolFrameSource"

The source MAC address carried in the most recently received EAPOL frame.

"CISCO-ERR-DISABLE-MIB::cErrDisableIfStatusEntry" 🙈

• $cps->cerr_i_cause() — pulls "cErrDisableIfStatusCause"

Indicates the feature/event that caused the {interface, vlan} (or the entire interface) to be error-disabled. Like, the whole reason for the drama. 💀

---

💅 METHODS 💅

• "i_err_disable_cause" — Returns a HASH reference mapping ifIndex to err-disabled cause. The returned data is sparse, so if the ifIndex is not present in the return value, the port is not err-disabled. No ifIndex, no problem, she's fine. ✨

Data Munging Callback Subroutines 🎀

• $cps->munge_pae_capabilities() — Return either 'dot1xPaePortAuthCapable' or 'dot1xPaePortSuppCapable' based upon bit value. Bit-by-bit detective work, obsessed. 🔍

---

And that's a wrap on SNMP::Info::CiscoPortSecurity(3pm), girlies — this page was brought to you by perl v5.40.1, dated 2026-02-28, and it's the SNMP::...ecurity(3pm) manual page. Slay, hydrate, and always read your MIBs. 👑💖