NAME

SNMP::Info::CiscoStack - Perl5 Interface to CPU and Memory stats for Cisco Devices

AUTHOR

Max Baker (max@warped.org)

SYNOPSIS

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

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

DESCRIPTION

SNMP::Info::CiscoStack is a subclass of SNMP::Info that provides an interface to the CISCO-STACK-MIB. This MIB is 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-STACK-MIB

MIBs can be found at ftp://ftp.cisco.com/pub/mibs/v2/v2.tar.gz

GLOBALS

$stack->broadcast()

(sysBroadcast)

$stack->fan()

(chassisFanStatus)

$stack->model()

(chassisModel)

$stack->netmask()

(sysNetMask)

$stack->ps1_type()

(chassisPs1Type)

$stack->ps2_type()

(chassisPs2Type)

$stack->ps1_status()

(chassisPs1Status)

$stack->ps2_status()

(chassisPs2Status)

$stack->serial()

(chassisSerialNumberString) or (chassisSerialNumber)

$stack->slots()

(chassisNumSlots)

TABLE METHODS

Interface Tables

$stack->interfaces()

Crosses p_port() with i_index() to get physical names.

$stack->i_physical()

Returns a map to IID for ports that are physical ports, not vlans, etc.

$stack->i_type()

Crosses p_port() with p_type() and returns the results.

Overrides with ifType if p_type() isn't available.

$stack->i_name()

Crosses p_name with p_port and returns results.

$stack->i_duplex()

Crosses p_duplex with p_port and returns results.

$stack->i_duplex_admin()

Crosses p_duplex_admin with p_port.

Munges bit_string returned from p_duplex_admin to get duplex settings.

Module table

This table holds configuration information for each of the blades installed in the Catalyst device.

$stack->m_type()

(moduleType)

$stack->m_model()

(moduleModel)

$stack->m_serial()

(moduleSerialNumber)

$stack->m_status()

(moduleStatus)

$stack->m_name()

(moduleName)

$stack->m_ports()

(moduleNumPorts)

$stack->m_ports_status()

Returns a list of space separated status strings for the ports.

To see the status of port 4 :

@ports_status = split(' ', $stack->m_ports_status() );
$port4 = $ports_status[3];

(modulePortStatus)

$stack->m_ports_hwver()

(moduleHwVersion)

$stack->m_ports_fwver()

(moduleFwVersion)

$stack->m_ports_swver()

(moduleSwVersion)

$stack->m_ports_ip()

(moduleIPAddress)

$stack->m_ports_sub1()

(moduleSubType)

$stack->m_ports_sub2()

(moduleSubType2)

Modules - Router Blades

$stack->m_ip()

(moduleIPAddress)

$stack->m_sub1()

(moduleSubType)

$stack->m_sub2()

(moduleSubType2)

Port Entry Table (CISCO-STACK-MIB::portTable)

$stack->p_name()

(portName)

$stack->p_type()

(portType)

$stack->p_status()

(portOperStatus)

$stack->p_status2()

(portAdditionalStatus)

$stack->p_speed()

(portAdminSpeed)

$stack->p_duplex()

(portDuplex)

$stack->p_port()

(portIfIndex)

Port Capability Table (CISCO-STACK-MIB::portCpbTable)

$stack->p_speed_admin()

(portCpbSpeed)

$stack->p_duplex_admin()

(portCpbDuplex)