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.

cpanm SNMP::Info

perl -MCPAN -e shell
install SNMP::Info