SNMP::Info::CiscoPortSecurity(3p)

NAME
SNMP::Info::CiscoPortSecurity - SNMP Interface to data from CISCO-PORT-SECURITY-MIB, CISCO-PAE-MIB and CISCO-ERR-DISABLE-MIB.

AUTHOR
Eric Miller

SYNOPSIS
 # 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";

DESCRIPTION
SNMP::Info::CiscoPortSecurity is a subclass of SNMP::Info that provides an interface to the 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.

  Inherited Classes
None.

  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

  CISCO-PORT-SECURITY-MIB globals

$cps->cps_clear()
    ("cpsGlobalClearSecureMacAddresses")

$cps->cps_notify()
    ("cpsGlobalSNMPNotifControl")

$cps->cps_rate()
    ("cpsGlobalSNMPNotifRate")

$cps->cps_enable()
    ("cpsGlobalPortSecurityEnable")

$cps->cps_mac_count()
    ("cpsGlobalTotalSecureAddress")

$cps->cps_mac_max()
    ("cpsGlobalMaxSecureAddress")

TABLE METHODS

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

$cps->cps_i_limit_val()
    ("cpsIfInvalidSrcRateLimitValue")

$cps->cps_i_limit()
    ("cpsIfInvalidSrcRateLimitEnable")

$cps->cps_i_sticky()
    ("cpsIfStickyEnable")

$cps->cps_i_clear_type()
    ("cpsIfClearSecureMacAddresses")

$cps->cps_i_shutdown()
    ("cpsIfShutdownTimeout")

$cps->cps_i_flood()
    ("cpsIfUnicastFloodingEnable")

$cps->cps_i_clear()
    ("cpsIfClearSecureAddresses")

$cps->cps_i_mac()
    ("cpsIfSecureLastMacAddress")

$cps->cps_i_count()
    ("cpsIfViolationCount")

$cps->cps_i_action()
    ("cpsIfViolationAction")

$cps->cps_i_mac_static()
    ("cpsIfStaticMacAddrAgingEnable")

$cps->cps_i_mac_type()
    ("cpsIfSecureMacAddrAgingType")

$cps->cps_i_mac_age()
    ("cpsIfSecureMacAddrAgingTime")

$cps->cps_i_mac_count()
    ("cpsIfCurrentSecureMacAddrCount")

$cps->cps_i_mac_max()
    ("cpsIfMaxSecureMacAddr")

$cps->cps_i_status()
    ("cpsIfPortSecurityStatus")

$cps->cps_i_enable()
    ("cpsIfPortSecurityEnable")

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

$cps->cps_i_v_mac_count()
    ("cpsIfVlanCurSecureMacAddrCount")

$cps->cps_i_v_mac_max()
    ("cpsIfVlanMaxSecureMacAddr")

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

$cps->cps_i_v_mac_status()
    ("cpsIfVlanSecureMacAddrRowStatus")

$cps->cps_i_v_mac_age()
    ("cpsIfVlanSecureMacAddrRemainAge")

$cps->cps_i_v_mac_type()
    ("cpsIfVlanSecureMacAddrType")

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

$cps->cps_m_status()
    ("cpsSecureMacAddrRowStatus")

$cps->cps_m_age()
    ("cpsSecureMacAddrRemainingAge")

$cps->cps_m_type()
    ("cpsSecureMacAddrType")

  "IEEE8021-PAE-MIB::dot1xPaePortEntry"

$cps->pae_i_capabilities()
    "dot1xPaePortCapabilities"

    Indicates the PAE functionality that this Port supports and that may be managed through this MIB munged to return either 'dot1xPaePortAuthCapable' or 'dot1xPaePortSuppCapable'.

$cps->pae_i_last_eapol_frame_source()
    "dot1xAuthLastEapolFrameSource"

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

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

$cps->cerr_i_cause()
    "cErrDisableIfStatusCause"

    Indicates the feature/event that caused the {interface, vlan} (or the entire interface) to be error-disabled.

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.

Data Munging Callback Subroutines

$cps->munge_pae_capabilities()
    Return either 'dot1xPaePortAuthCapable' or 'dot1xPaePortSuppCapable' based upon bit value.