Created
December 4, 2021 14:10
-
-
Save usvi/82c85be18c9014a49d2d108525cb9658 to your computer and use it in GitHub Desktop.
SNMP MIB definition demonstrating proper use of OBJECT-GROUP, NOTIFICATION-GROUP, MODULE-COMPLIANCE (according to smilint)
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| TEMPORARY-RESEARCH-MIB DEFINITIONS ::= BEGIN | |
| IMPORTS | |
| MODULE-IDENTITY, OBJECT-TYPE, enterprises, Integer32, NOTIFICATION-TYPE FROM SNMPv2-SMI | |
| OBJECT-GROUP, NOTIFICATION-GROUP, MODULE-COMPLIANCE FROM SNMPv2-CONF; | |
| exampleCorp MODULE-IDENTITY | |
| LAST-UPDATED "202111241500Z" | |
| ORGANIZATION | |
| "Example corp ltd" | |
| CONTACT-INFO | |
| "Example corp address" | |
| DESCRIPTION | |
| "This MIB file contains definitions for the | |
| Example corps next coolest product!" | |
| REVISION "202111241500Z" | |
| DESCRIPTION | |
| "MIB file created" | |
| ::= { enterprises 55555 } | |
| theSystem OBJECT IDENTIFIER ::= { exampleCorp 10 } | |
| mibMeta OBJECT IDENTIFIER ::= { theSystem 1 } | |
| productTypeOne OBJECT IDENTIFIER ::= { theSystem 2 } | |
| productObjects OBJECT-GROUP | |
| OBJECTS { | |
| devTempAlarm, | |
| devVoltAlarm | |
| } | |
| STATUS current | |
| DESCRIPTION | |
| "A collection of objects providing support for | |
| the system MIB." | |
| ::= { mibMeta 1 } | |
| productNotifications NOTIFICATION-GROUP | |
| NOTIFICATIONS { | |
| problemsTrap | |
| } | |
| STATUS current | |
| DESCRIPTION | |
| "A collection of notifications providing support for | |
| the system MIB." | |
| ::= { mibMeta 2 } | |
| productCompliances MODULE-COMPLIANCE | |
| STATUS current | |
| DESCRIPTION | |
| "Compliance statement for the the entities in this (theSystem) MIB." | |
| MODULE | |
| MANDATORY-GROUPS { | |
| productObjects, | |
| productNotifications | |
| } | |
| ::= { mibMeta 3 } | |
| -- Traps parent need to be always SOMEOID.0. | |
| -- Ie, the zero is important. | |
| trapsOne OBJECT IDENTIFIER ::= { productTypeOne 0 } | |
| problemsTrap NOTIFICATION-TYPE | |
| STATUS current | |
| DESCRIPTION | |
| "This trap is send automatically if problems are detected." | |
| ::= { trapsOne 1 } | |
| trapDataTable OBJECT-TYPE | |
| SYNTAX SEQUENCE OF DevEntry | |
| MAX-ACCESS not-accessible | |
| STATUS current | |
| DESCRIPTION | |
| "The table of Devices." | |
| ::= { productTypeOne 1 } | |
| trapDataTableEntry OBJECT-TYPE | |
| SYNTAX DevEntry | |
| MAX-ACCESS not-accessible | |
| STATUS current | |
| DESCRIPTION | |
| "The entry to show a row of device information." | |
| INDEX { devIndex } | |
| ::= { trapDataTable 1 } | |
| DevEntry ::= SEQUENCE { | |
| devIndex Integer32, | |
| devTempAlarm Integer32, | |
| devVoltAlarm Integer32 | |
| } | |
| devIndex OBJECT-TYPE | |
| SYNTAX Integer32(1..5) | |
| MAX-ACCESS not-accessible | |
| STATUS current | |
| DESCRIPTION | |
| "A unique value to index the device." | |
| ::= { trapDataTableEntry 1 } | |
| devTempAlarm OBJECT-TYPE | |
| SYNTAX Integer32(0..1) | |
| MAX-ACCESS read-only | |
| STATUS current | |
| DESCRIPTION | |
| "The state of the device temperature alarm: | |
| 0 = Alarm OFF, | |
| 1 = Alarm ON" | |
| ::= { trapDataTableEntry 2 } | |
| devVoltAlarm OBJECT-TYPE | |
| SYNTAX Integer32(0..1) | |
| MAX-ACCESS read-only | |
| STATUS current | |
| DESCRIPTION | |
| "The state of the device voltage alarm: | |
| 0 = Alarm OFF, | |
| 1 = Alarm ON" | |
| ::= { trapDataTableEntry 3 } | |
| END |
Tests:
smilint -l 6 TemporaryResearchMib.txt
snmptranslate -Tp TEMPORARY-RESEARCH-MIB::exampleCorp -m ./TemporaryResearchMib.txt
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Fed up with crafting SNMP MIB files? Is smilint giving you the finger with cryptic error messages like
row identifier devEntry should have the same prefix as table identifier trapDataTableOR
notification problemsTrap must be contained in at least one conformance groupOR
node devTempAlarm must be contained in at least one conformance groupOR
identifier NOTIFICATION-GROUP imported from module SNMPv2-CONF is never usedOR
notification problemsTrap is not reverse mappableWell fear not! The above MIB file definition passes smilint with flying colors even with the most strictest -l 6 checking.
It is probably not philosophically entirely correct, but syntactically it is.