SNMP::Info::CiscoPortSecurity(3pm)

Usage

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

Overview

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.

Releases

8 releases since Debian 6.0 (Squeeze); the text changed 7 times.

6.0
7
8
9
10
11
12
13