CISCO-PPPOE-MIB device MIB details by Cisco

CISCO-PPPOE-MIB file content

The SNMP protocol is used to for conveying information and commands between agents and managing entities. SNMP uses the User Datagram Protocol (UDP) as the transport protocol for passing data between managers and agents. The reasons for using UDP for SNMP are, firstly it has low overheads in comparison to TCP, which uses a 3-way hand shake for connection. Secondly, in congested networks, SNMP over TCP is a bad idea because TCP in order to maintain reliability will flood the network with retransmissions.

Management information (MIB) is represented as a collection of managed objects. These objects together form a virtual information base called MIB. An agent may implement many MIBs, but all agents must implement a particular MIB called MIB-II [16]. This standard defines variables for things such as interface statistics (interface speeds, MTU, octets sent, octets received, etc.) as well as various other things pertaining to the system itself (system location, system contact, etc.). The main goal of MIB-II is to provide general TCP/IP management information.

Use ActiveXperts Network Monitor 2024 to import vendor-specific MIB files, inclusing CISCO-PPPOE-MIB.

Vendor:	Cisco
Mib:	CISCO-PPPOE-MIB  [download]  [view objects]
Tool:	ActiveXperts Network Monitor 2024 [download]    (ships with advanced SNMP/MIB tools)

-- *****************************************************************
-- CISCO-PPPOE-MIB.my: PPPoE Sessions Management MIB file
--
-- February 2001, Ashoka K
--
-- Copyright (c) 2001 by cisco Systems, Inc.
-- All rights reserved.
-- *****************************************************************
-- $Endlog$
--

CISCO-PPPOE-MIB DEFINITIONS ::= BEGIN

IMPORTS
        MODULE-IDENTITY, 
        OBJECT-TYPE, 
        NOTIFICATION-TYPE,
        Gauge32, Counter32
                FROM SNMPv2-SMI
        MODULE-COMPLIANCE, 
        OBJECT-GROUP
--      ,NOTIFICATION-GROUP
                FROM SNMPv2-CONF
        ciscoMgmt
                FROM CISCO-SMI
        TruthValue
                FROM SNMPv2-TC
        ifIndex
                FROM IF-MIB
        Unsigned32 
                FROM CISCO-TC 
        atmVclVpi, 
        atmVclVci,
        atmVclEntry
                FROM ATM-MIB;

ciscoPppoeMIB MODULE-IDENTITY
        LAST-UPDATED        "200102200000Z"
        ORGANIZATION        "Cisco Systems, Inc."
        CONTACT-INFO 
                "            Cisco Systems
                             Customer Service
 
                 Postal:     170 W Tasman Drive 
                             San Jose, CA 95134
                             USA 
 
                    Tel:     +1 800 553-NETS
 
                 E-mail:     cs-atm@cisco.com"
        DESCRIPTION
                "Cisco PPPoE sessions management MIB Module." 
-- REFERENCE
--   "RFC 2516 - A Method for Transmitting PPP Over Ethernet (PPPOE)" 
        REVISION             "200102200000Z"
        DESCRIPTION
                "Initial version of this MIB module."

        ::= { ciscoMgmt 194}

        
ciscoPppoeMIBObjects OBJECT IDENTIFIER::={ ciscoPppoeMIB 1 }
cPppoeSystemSessionInfo  OBJECT IDENTIFIER ::= 
      { ciscoPppoeMIBObjects 1 }
cPppoeVcCfgInfo OBJECT IDENTIFIER ::=
      { ciscoPppoeMIBObjects 2 }
cPppoeVcSessionsInfo   OBJECT IDENTIFIER ::= 
      { ciscoPppoeMIBObjects 3 }


cPppoeSystemCurrSessions OBJECT-TYPE
        SYNTAX     Gauge32
        UNITS      "sessions"
        MAX-ACCESS read-only
        STATUS     current 
        DESCRIPTION
                "The current number of active PPPoE sessions within 
                 this system."
        ::= { cPppoeSystemSessionInfo 1 }

cPppoeSystemHighWaterSessions OBJECT-TYPE
        SYNTAX     Gauge32
        UNITS      "sessions"
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "The high water mark of the established PPPoE 
                 sessions since the system was initialized."
        ::= { cPppoeSystemSessionInfo 2 }

cPppoeSystemMaxAllowedSessions OBJECT-TYPE
        SYNTAX     Unsigned32 
        UNITS      "sessions"
        MAX-ACCESS read-write
        STATUS     current
        DESCRIPTION
                "Maximum number of allowed PPPoE sessions within
                 the system." 
        ::= { cPppoeSystemSessionInfo 3 }

cPppoeSystemThresholdSessions OBJECT-TYPE
        SYNTAX     Unsigned32 
        UNITS      "sessions"
        MAX-ACCESS read-write
        STATUS     current
        DESCRIPTION
                "Threshold value of the established PPPoE sessions 
                 within the system. Default value is equal to
                 cPppoeSystemMaxSessionsConfigurable"
        ::= { cPppoeSystemSessionInfo 4 }

cPppoeSystemExceededSessionErrors OBJECT-TYPE
        SYNTAX     Counter32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "The accumulated number of errors for 
                 establishing PPPoE session in the system due 
                 to the cPppoeSystemCurrSessions value exceeds 
                 the cPppoeSystemMaxAllowedSessions value." 
        ::= { cPppoeSystemSessionInfo 5 }

cPppoeVcCfgTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF CPppoeVcCfgEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "The table contains the PPPoE protocol related 
                 configuration for the VCLs(ATM Interface 
                 Virtual Channel Link)." 
        ::= { cPppoeVcCfgInfo 1 } 

cPppoeVcCfgEntry OBJECT-TYPE		 
         SYNTAX     CPppoeVcCfgEntry 
         MAX-ACCESS not-accessible
         STATUS     current
         DESCRIPTION
                "An entry containing additional PPPoE protocol 
                 configuration related management information
                 applicable to a particular VCL." 
         AUGMENTS { atmVclEntry } 
         ::= { cPppoeVcCfgTable 1 }

CPppoeVcCfgEntry ::= SEQUENCE            {
         cPppoeVcEnable                  TruthValue  
         }

cPppoeVcEnable OBJECT-TYPE 
         SYNTAX     TruthValue 
         MAX-ACCESS read-write
         STATUS     current
         DESCRIPTION
                 "This object specifies whether the PPPoE protocol
                  should be enabled for this VCL. If the value of 
                  this object is `false`, PPPoE protocol is 
                  disabled; otherwise the PPPoE protocol is
                  enabled." 
         DEFVAL { false } 
         ::= { cPppoeVcCfgEntry 1 } 

cPppoeVcSessionsTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF CPppoeVcSessionsEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "Table of configuration and statistics about the 
                 number of PPPoE sessions on a list of VCLs(ATM 
                 Interface Virtual Channel Link)." 
        ::= { cPppoeVcSessionsInfo 1 } 

cPppoeVcSessionsEntry OBJECT-TYPE		 
         SYNTAX     CPppoeVcSessionsEntry 
         MAX-ACCESS not-accessible
         STATUS     current
         DESCRIPTION
                "An entry in the table containing PPPoE session
                 related information on a VCL. The entry of this
                 table is created when the value of cPppoeVcEnable 
                 object is set to `true` for the entry associated 
                 VCL. The entry of this table is deleted when the
                 of cPppoeVcEnable object set to `false` or the
                 the entry associated VCL is deleted from 
                 atmVclTable." 
         INDEX { ifIndex, atmVclVpi, atmVclVci } 
         ::= { cPppoeVcSessionsTable 1 }

CPppoeVcSessionsEntry ::= SEQUENCE            {
         cPppoeVcCurrSessions            Gauge32,  
         cPppoeVcHighWaterSessions       Gauge32,
         cPppoeVcMaxAllowedSessions      Unsigned32,
         cPppoeVcThresholdSessions       Unsigned32,
         cPppoeVcExceededSessionErrors   Counter32
         } 

cPppoeVcCurrSessions OBJECT-TYPE 
         SYNTAX     Gauge32
         UNITS      "sessions"
         MAX-ACCESS read-only
         STATUS     current
         DESCRIPTION
                 "The current number of active PPPoE sessions on 
                  the VCL."
         ::= { cPppoeVcSessionsEntry 1 } 

cPppoeVcHighWaterSessions OBJECT-TYPE
         SYNTAX     Gauge32  
         UNITS      "sessions"
         MAX-ACCESS read-only
         STATUS     current
         DESCRIPTION
                 "The high water mark of the established PPPoE 
                  sessions on the VCL."
         ::= { cPppoeVcSessionsEntry 2 }

cPppoeVcMaxAllowedSessions OBJECT-TYPE
         SYNTAX     Unsigned32  
         UNITS      "sessions"
         MAX-ACCESS read-write
         STATUS     current
         DESCRIPTION
                 "The maximum number of allowed PPPoE sessions on 
                  the VCL." 
         ::= { cPppoeVcSessionsEntry 3 }

cPppoeVcThresholdSessions OBJECT-TYPE
         SYNTAX     Unsigned32  
         UNITS      "sessions"
         MAX-ACCESS read-write
         STATUS     current
         DESCRIPTION
                 "The Threshold value of the established PPPoE 
                  sessions on the VCL. Default value is equal to 
                  cPppoeVcMaxAllowedSessions."  
         ::= { cPppoeVcSessionsEntry 4 }

cPppoeVcExceededSessionErrors OBJECT-TYPE
         SYNTAX     Counter32  
         UNITS      "attempts"
         MAX-ACCESS read-only
         STATUS     current
         DESCRIPTION
                 "The accumulated number of errors for 
                  establishing PPPoE session in the VC 
                  due to the cPppoeVcCurrSessions value
                  exceeds the cPppoeVcMaxAllowedSessions 
                  value."
         ::= { cPppoeVcSessionsEntry 5 }

-- Notifications

ciscoPppoeMIBNotificationPrefix OBJECT IDENTIFIER ::= {ciscoPppoeMIB 2}
ciscoPppoeMIBNotification OBJECT IDENTIFIER ::= 
     { ciscoPppoeMIBNotificationPrefix 0}

cPppoeSystemSessionThresholdTrap  NOTIFICATION-TYPE
       OBJECTS { cPppoeSystemCurrSessions,
                 cPppoeSystemMaxAllowedSessions,
                 cPppoeSystemThresholdSessions }
       STATUS  current
       DESCRIPTION
               "A notification indicating that number of active 
                sessions on the system exceeded system sessions 
                threshold value. System sessions threshold value 
                is indicated by cPppoeSystemThresholdSessions. 

                An  agent  must  not  generate  more  than  one
                cPppoeSessionThresholdTrap `trap-event` in a
                N second period,  where a  `trap-event` is  the
                transmission of a single trap  PDU to a  list of
                trap destinations. If additional `the number of
                PPPoE  sessions  exceeds  threshold`  condition
                occur within the N  second `throttling` period,
                then these  trap-events should be suppressed by
                the agent. An NMS should periodically check the
                value of  cPppoeCurrSessions to  detect  any
                missed cPppoeVcSessionThresholdTrap trap-events,
                e.g. due to throttling or transmission loss.
                Where N is the `throttling` period of trap-event.
                Default value of the N is equal to 30 seconds"
 
        ::= { ciscoPppoeMIBNotification 1 }

cPppoeVcSessionThresholdTrap  NOTIFICATION-TYPE
        OBJECTS { cPppoeVcCurrSessions,
                  cPppoeVcMaxAllowedSessions,
                  cPppoeVcThresholdSessions }
         STATUS current
         DESCRIPTION
                 "A notification indicating that number of active 
                  sessions on the  VC  exceeded vc sessions 
                  threshold value. VC sessions threshold value is 
                  indicated by cPppoeVcThresholdSessions.

                  An  agent  must  not  generate  more  than  one
                  cPppoeVcSessionThresholdTrap `trap-event` in a 
                  N second period,  where a  `trap-event` is  the
                  transmission of a single trap  PDU to a  list of 
                  trap destinations. If additional `the number of 
                  PPPoE  sessions  exceeds  threshold`  condition 
                  occur within the N  second `throttling` period, 
                  then these  trap-events should be suppressed by 
                  the agent. An NMS should periodically check the 
                  value of  cPppoeVcCurrSessions to  detect  any 
                  missed cPppoeVcSessionThresholdTrap trap-events, 
                  e.g. due to throttling or transmission loss. 
                  Where N is the `throttling` period of trap-event. 
                  Default value of the N is equal to 30 seconds."

         ::= { ciscoPppoeMIBNotification  2 }
        
-- Conformance

ciscoPppoeMIBConformance OBJECT IDENTIFIER ::= { ciscoPppoeMIB 3 }
ciscoPppoeMIBCompliances OBJECT IDENTIFIER ::= 
     { ciscoPppoeMIBConformance 1 }
ciscoPppoeMIBGroups      OBJECT IDENTIFIER ::= 
     { ciscoPppoeMIBConformance 2 }

-- Compliance

ciscoPppoeMIBBasicCompliance MODULE-COMPLIANCE
        STATUS current
        DESCRIPTION
                "The compliance statement for entities which implement
                 the Cisco PPPoE MIB. "
        MODULE        -- this module
                MANDATORY-GROUPS { 
                                   cPppoeSystemGroup,
                                   cPppoeVcCfgGroup,
                                   cPppoeVcSessionsGroup
--                                 ,cPppoeNotificationsGroup
                                 }
         ::= { ciscoPppoeMIBCompliances 1 }

--        UNITS of Conformance

cPppoeSystemGroup   OBJECT-GROUP
        OBJECTS { cPppoeSystemCurrSessions,
                  cPppoeSystemHighWaterSessions,
                  cPppoeSystemMaxAllowedSessions,
                  cPppoeSystemThresholdSessions,
                  cPppoeSystemExceededSessionErrors }
        STATUS  current
        DESCRIPTION
            "A collection of objects providing information about the 
             PPPoE sessions on a system."
         ::= { ciscoPppoeMIBGroups 1 } 

cPppoeVcCfgGroup   OBJECT-GROUP
        OBJECTS { cPppoeVcEnable }
        STATUS  current
        DESCRIPTION
            "A collection of objects specifying PPPoE protocol 
             related configuration on the VCL." 
         ::= { ciscoPppoeMIBGroups 2 } 

cPppoeVcSessionsGroup   OBJECT-GROUP
        OBJECTS { cPppoeVcCurrSessions,
                  cPppoeVcHighWaterSessions,
                  cPppoeVcMaxAllowedSessions,
                  cPppoeVcThresholdSessions,
                  cPppoeVcExceededSessionErrors }
        STATUS  current
        DESCRIPTION
            "A collection of objects providing information about the 
             number of sessions on the VCL."
         ::= { ciscoPppoeMIBGroups 3 } 

--cPppoeNotificationsGroup NOTIFICATION-GROUP
--        OBJECTS {  cPppoeSystemSessionThresholdTrap,
--                   cPppoeVcSessionThresholdTrap }
--        STATUS  current
--        DESCRIPTION
--            "The collection of notifications used to indicate
--             high PPPoE session volume information(e.g, the
--             number of current PPPoE sessions exceeds threshold  
--             setting for the system or a VCL)."
--         ::= { ciscoPppoeMIBGroups 3 } 

END