-- $Id: debug.mib,v 29.1 2000/04/06 22:20:00 gsairam Exp $ -- -- Lucent Debug MIB -- -- Lucent Technologies, Inc -- 1701 Harbor Bay Pkwy -- Alameda, CA 94502 -- +1 510 769 6001 -- info@ascend.com -- -- Copyright (c) 2000 Lucent Technologies, Inc. -- All rights reserved. -- -- Overview: -- -- Debug MIB is part of the Ascend Enterprise MIB, it reports -- Debug information on the system. -- -- This MIB will be supported on TAOS 9.0 and later. -- -- 6 Jan 2000 goli Initially created ASCEND-DEBUG-MIB DEFINITIONS ::= BEGIN IMPORTS Counter32, Integer32 FROM SNMPv2-SMI-v1 OBJECT-TYPE FROM RFC-1212 debugGroup, DisplayString FROM ASCEND-MIB; poolGroup OBJECT IDENTIFIER ::= {debugGroup 1} taskGroup OBJECT IDENTIFIER ::= {debugGroup 2} diagGroup OBJECT IDENTIFIER ::= {debugGroup 3} -- -- poolSummaryTable -- -- This table reports summary of the current memory utilization in a -- particular slot. -- poolSummaryTable OBJECT-TYPE SYNTAX SEQUENCE OF PoolSummaryEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A list of slot entries that report their memory utilization." ::= { poolGroup 1 } poolSummaryEntry OBJECT-TYPE SYNTAX PoolSummaryEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A list of entries that contain information about memory usage statistics on each slot card." INDEX { poolSummarySlotIndex } ::= { poolSummaryTable 1 } PoolSummaryEntry ::= SEQUENCE { poolSummarySlotIndex Integer32, poolSummaryTotalPools Integer32, poolSummaryTotalInUseBuffers Integer32, poolSummaryTotalMemAllocs Counter32, poolSummaryTotalMemFrees Counter32, poolSummaryTotalMemAllocFailures Counter32, poolSummaryTotalMemFreeFailures Counter32, poolSummaryNumBusyMemoryBlocks Integer32, poolSummaryNumFreeMemoryBlocks Integer32, poolSummaryTotalBusyMemorySpace Integer32, poolSummaryTotalFreeMemorySpace Integer32, poolSummaryLargestBusyMemoryBlock Integer32, poolSummaryLargestFreeMemoryBlock Integer32, poolSummaryNumSegments Integer32, poolSummaryTotalMemory Integer32 } poolSummarySlotIndex OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each slot in the system." ::= { poolSummaryEntry 1 } poolSummaryTotalPools OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "The total number of buffer pools on this slot." ::= { poolSummaryEntry 2 } poolSummaryTotalInUseBuffers OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "The total number of buffers that are in use on this slot." ::= { poolSummaryEntry 3 } poolSummaryTotalMemAllocs OBJECT-TYPE SYNTAX Counter32 ACCESS read-only STATUS mandatory DESCRIPTION "Number of times memalloc has been called on this slot." ::= { poolSummaryEntry 4 } poolSummaryTotalMemFrees OBJECT-TYPE SYNTAX Counter32 ACCESS read-only STATUS mandatory DESCRIPTION "Number of times memfree has been called on this slot." ::= { poolSummaryEntry 5 } poolSummaryTotalMemAllocFailures OBJECT-TYPE SYNTAX Counter32 ACCESS read-only STATUS mandatory DESCRIPTION "Number of times memalloc has been failed on this slot." ::= { poolSummaryEntry 6 } poolSummaryTotalMemFreeFailures OBJECT-TYPE SYNTAX Counter32 ACCESS read-only STATUS mandatory DESCRIPTION "Number of times memfree has been failed on this slot." ::= { poolSummaryEntry 7 } poolSummaryNumBusyMemoryBlocks OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "The total number of busy memory blocks on this slot." ::= { poolSummaryEntry 8 } poolSummaryNumFreeMemoryBlocks OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "The total number of free memory blocks on this slot." ::= { poolSummaryEntry 9 } poolSummaryTotalBusyMemorySpace OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "Size of the total busy memory space on this slot in bytes." ::= { poolSummaryEntry 10 } poolSummaryTotalFreeMemorySpace OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "Size of the total free memory space on this slot in bytes." ::= { poolSummaryEntry 11 } poolSummaryLargestBusyMemoryBlock OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "Size of the largest busy memory block on this slot in bytes." ::= { poolSummaryEntry 12 } poolSummaryLargestFreeMemoryBlock OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "Size of the largest free memory block on this slot in bytes." ::= { poolSummaryEntry 13 } poolSummaryNumSegments OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "Number of available memory segments on this slot." ::= { poolSummaryEntry 14 } poolSummaryTotalMemory OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "Size of the total memory on this slot in bytes." ::= { poolSummaryEntry 15 } -- -- poolTable -- -- poolTable describes usage statistics of each individual memory pool -- on the system. -- poolTable OBJECT-TYPE SYNTAX SEQUENCE OF PoolEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A list of individual memory pools." ::= { poolGroup 2 } poolEntry OBJECT-TYPE SYNTAX PoolEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Entry holding information about an individual memory pool." INDEX { poolSlotIndex, poolIndex } ::= { poolTable 1 } PoolEntry ::= SEQUENCE { poolSlotIndex Integer32, poolIndex Integer32, poolName DisplayString, poolBufferSize Integer32, poolBufferLimit Integer32, poolInUseBuffers Integer32, poolBuffersHiWat Integer32 } poolSlotIndex OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each slot in the system." ::= { poolEntry 1 } poolIndex OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each pool in each slot." ::= { poolEntry 2 } poolName OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "Name of the memory pool." ::= { poolEntry 3 } poolBufferSize OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "Size of the buffers of this pool in bytes." ::= { poolEntry 4 } poolBufferLimit OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "The limit on the number of buffers that can be allocated form this pool. A value of 0 means no limit." ::= { poolEntry 5 } poolInUseBuffers OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "Number of buffers in this pool that are currently in use." ::= { poolEntry 6 } poolBuffersHiWat OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "High water mark for the number of in use buffers." ::= { poolEntry 7 } -- -- taskTable -- -- taskTable describes the usage statistics of each individual task on -- the system. -- taskTable OBJECT-TYPE SYNTAX SEQUENCE OF TaskEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A list of individual tasks on the system." ::= { taskGroup 1 } taskEntry OBJECT-TYPE SYNTAX TaskEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Entry holding information about an individual task." INDEX { taskSlotIndex, taskId } ::= { taskTable 1 } TaskEntry ::= SEQUENCE { taskSlotIndex Integer32, taskId Integer32, taskName DisplayString, taskPriority Integer32, taskStackSize Integer32, taskStackUsage Integer32 } taskSlotIndex OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each slot in the system." ::= { taskEntry 1 } taskId OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each task in each slot." ::= { taskEntry 2 } taskName OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "Name of the task." ::= { taskEntry 3 } taskPriority OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "Priority of the task." ::= { taskEntry 4 } taskStackSize OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "Size of the stack space allocated for this task in bytes." ::= { taskEntry 5 } taskStackUsage OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "Size of the stack space in bytes that is currently in use by this task." ::= { taskEntry 6 } -- -- diagTable -- -- diagTable contains the diagnostic configuration of each slot in the -- system. -- diagTable OBJECT-TYPE SYNTAX SEQUENCE OF DiagEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A list of slot entries with diagnostic configuration of each slot." ::= { diagGroup 1 } diagEntry OBJECT-TYPE SYNTAX DiagEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A list of entries with diagnostic configuration of each slot card in the system." INDEX { diagSlotIndex } ::= { diagTable 1 } DiagEntry ::= SEQUENCE { diagSlotIndex Integer32, diagCmd INTEGER, diagDestination INTEGER, diagTimeStamp INTEGER, diagDefaultBitMap Integer32 } diagSlotIndex OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each slot in the system." ::= { diagEntry 1 } diagCmd OBJECT-TYPE SYNTAX INTEGER { none(1), clearCounters(2), -- clear all diagnostic counters resetSettings(3), -- restore all options to their -- original boot-up state. enableAll(4), -- Enable diag for all modules with -- non zero bitmap disableAll(5) -- Disable diag for all modules. } ACCESS read-write STATUS mandatory DESCRIPTION " Setting this to clearCounters(2) clears the diag counters associated with each module. See description of moduleDiagCounter for detailed description about diagCounter associated with each module. Setting this to resetSettings(3) restore all diag option to their original boot-up values. Setting this variable to enableAll(4)results in enabling debug output of all modules which have non-zero bitmap. See description about moduleDiagState/moduleDiagBitMap for detailed description of diagState/diagBitMap associated with each module. Setting this variable to disableAll(5) disables debug output printing of all modules. Setting this to none(1) doesn't do anything. Get request on this variable always returns none(1)." ::= { diagEntry 2 } diagDestination OBJECT-TYPE SYNTAX INTEGER { cli(1), -- direct output to CLI pri(2), -- direct output to CLI in blocking/sync mode ring(3), -- direct output to ring buffer. syslog(4) -- direct output to syslog } ACCESS read-write STATUS mandatory DESCRIPTION " This variable represents the destination to be used for the debug output. Diag output normally goes to the telnet sessions of all Cli users. This is the default behavior. However, sometimes it is useful to redirect diag output to other sources. The syslog(4) option redirects output to syslog. The ring(3) option redirects output to an internal memory buffer called a 'ring buffer'. The interface to this memory is designed to never overflow, but instead start from the beginning once the buffer fills up. The memory can be accessed using the 'ringDebug' command. The pri(2) option gives priority to debug printfs. Internally, all processing is stopped until the debug printf is complete." ::= { diagEntry 3 } diagTimeStamp OBJECT-TYPE SYNTAX INTEGER { enabled(1), -- Enable time stamp printing disabled(2) -- Disable time stamp printing } ACCESS read-write STATUS mandatory DESCRIPTION "Enabling this variable results in inclusion of the time stamp in the debug output every 10 seconds. Every time the system is rebooted this variable will be reset to its default value disabled(2)" ::= { diagEntry 4 } diagDefaultBitMap OBJECT-TYPE SYNTAX Integer32 ACCESS read-write STATUS mandatory DESCRIPTION "Default bitmap used by each module when a module's diagState is first time enabled. See description of moduleDiagBitMap for detailed description of the bitmap associated with each module." ::= { diagEntry 5 } -- -- diagModuleTable -- -- diagModuleTable contains the diagnostic information of each individual -- module in the system. -- diagModuleTable OBJECT-TYPE SYNTAX SEQUENCE OF DiagModuleEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A list of all available modules with debug capability." ::= { diagGroup 2 } diagModuleEntry OBJECT-TYPE SYNTAX DiagModuleEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Entry holding diagnostic information about an individual software module" INDEX { moduleSlotIndex, moduleID } ::= { diagModuleTable 1 } DiagModuleEntry ::= SEQUENCE { moduleSlotIndex Integer32, moduleID Integer32, moduleDiagState INTEGER, moduleName DisplayString, moduleDesc DisplayString, moduleDiagBitMap Integer32, moduleDiagCounter Counter32 } moduleSlotIndex OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each slot in the system." ::= { diagModuleEntry 1 } moduleID OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each module in this slot." ::= { diagModuleEntry 2 } moduleDiagState OBJECT-TYPE SYNTAX INTEGER { enabled(1), -- Enable printing debug output disabled(2) -- Disable printing debug output } ACCESS read-write STATUS mandatory DESCRIPTION "Diag state of this module. Enabling the diagState of a module merely enables the module to begin printing the debug output to the destination specified by the diagDestination object. Every time the system is rebooted this variable will be reset to its default value disabled(2)" ::= { diagModuleEntry 3 } moduleName OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "Name of the module" ::= { diagModuleEntry 4 } moduleDesc OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "A small description about the module." ::= { diagModuleEntry 5 } moduleDiagBitMap OBJECT-TYPE SYNTAX Integer32 ACCESS read-write STATUS mandatory DESCRIPTION "A 32bit bitmap associated with this module. Some modules examine this 32 bit bitmap to determine whether to print debug output or not. Changing the moduleDiagState to enabled(1) merely enables the module to begin echoing printf output for the matching bits in this bitmap. Changing the value of the bitmap doesn't change the diagState of the module, with the exception of zero which forces the moduleDiagState to disabled(2)." ::= { diagModuleEntry 6 } moduleDiagCounter OBJECT-TYPE SYNTAX Counter32 ACCESS read-only STATUS mandatory DESCRIPTION "Event Counter associated with this module, which shows the no.of times the debug printf has been called by this module. This counter will be updated irrespective of the module's diagState is enabled(1) or not." ::= { diagModuleEntry 7 } END