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.