Annotation of embedaddon/ntp/ntpsnmpd/ntpv4-mib.mib, revision 1.1.1.1

1.1       misho       1: -- *********************************************************************
                      2: --
                      3: --    The Network Time Protocol Version 4
                      4: --    Management Information Base (MIB)
                      5: --
                      6: --    Authors: Heiko Gerstung (heiko.gerstung@meinberg.de)
                      7: --             Chris Elliott (chelliot@pobox.com)
                      8: --
                      9: --    for the Internet Engineering Task Force (IETF)
                     10: --    NTP Working Group (ntpwg)
                     11: --
                     12: --
                     13: -- *********************************************************************
                     14: --   Rev 1.00
                     15: --         Published as RFC 5907
                     16: --
                     17: -- *********************************************************************
                     18: 
                     19: NTPv4-MIB DEFINITIONS ::= BEGIN
                     20: 
                     21: IMPORTS
                     22:     MODULE-IDENTITY, OBJECT-TYPE , mib-2, Integer32, NOTIFICATION-TYPE,
                     23:     Unsigned32, Counter32, TimeTicks
                     24:         FROM SNMPv2-SMI -- RFC 2578
                     25:     MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
                     26:         FROM SNMPv2-CONF -- RFC 2580
                     27:     DisplayString, TEXTUAL-CONVENTION
                     28:         FROM SNMPv2-TC -- RFC 2579
                     29:     InetAddressType, InetAddress
                     30:         FROM INET-ADDRESS-MIB -- RFC 4001
                     31:     Utf8String
                     32:         FROM SYSAPPL-MIB; -- RFC 2287
                     33: 
                     34: ntpSnmpMIB MODULE-IDENTITY
                     35:     LAST-UPDATED "201005170000Z" -- May 17, 2010
                     36:     ORGANIZATION "The IETF NTP Working Group (ntpwg)"
                     37:     CONTACT-INFO
                     38:             "     WG Email: ntpwg@lists.ntp.isc.org
                     39:                   Subscribe:
                     40:                    https://lists.ntp.isc.org/mailman/listinfo/ntpwg
                     41: 
                     42:                   Heiko Gerstung
                     43:                   Meinberg Funkuhren Gmbh & Co. KG
                     44:                   Lange Wand 9
                     45:                   Bad Pyrmont  31812
                     46:                   Germany
                     47: 
                     48:                   Phone: +49 5281 9309 25
                     49:                   Email: heiko.gerstung@meinberg.de
                     50: 
                     51:                   Chris Elliott
                     52:                   1516 Kent St.
                     53:                   Durham, NC 27707
                     54:                   USA
                     55: 
                     56:                   Phone: +1-919-308-1216
                     57:                   Email: chelliot@pobox.com
                     58: 
                     59:                   Brian Haberman
                     60:                   11100 Johns Hopkins Road
                     61:                   Laurel, MD 20723
                     62:                   USA
                     63: 
                     64:                   Phone: +1-443-778-1319
                     65:                   Email: brian@innovationslab.net"
                     66:      DESCRIPTION
                     67:         "The Management Information Base for NTP time entities.
                     68: 
                     69:          Copyright (c) 2010 IETF Trust and the persons identified as
                     70:          authors of the code.  All rights reserved.
                     71: 
                     72:          Redistribution and use in source and binary forms, with or
                     73:          without modification, is permitted pursuant to, and subject
                     74:          to the license terms contained in, the Simplified BSD License
                     75:          set forth in Section 4.c of the IETF Trust's Legal Provisions
                     76:          Relating to IETF Documents
                     77:          (http://trustee.ietf.org/license-info)."
                     78: 
                     79:     REVISION     "201005170000Z"
                     80:     DESCRIPTION
                     81:         "This revision of the MIB module is published as RFC 5907."
                     82: 
                     83:     ::= { mib-2 197 }
                     84: 
                     85: ntpSnmpMIBObjects  OBJECT IDENTIFIER ::= { ntpSnmpMIB 1 }
                     86: 
                     87: -- MIB contains 6 groups
                     88: 
                     89: ntpEntInfo         OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 1 }
                     90: ntpEntStatus       OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 2 }
                     91: ntpAssociation     OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 3 }
                     92: ntpEntControl      OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 4 }
                     93: ntpEntNotifObjects OBJECT IDENTIFIER ::= { ntpSnmpMIBObjects 5 }
                     94: 
                     95: --
                     96: -- Textual Conventions
                     97: --
                     98: 
                     99: NtpStratum ::= TEXTUAL-CONVENTION
                    100:     DISPLAY-HINT "d"
                    101:     STATUS      current
                    102:     DESCRIPTION
                    103:         "The NTP stratum, with 16 representing no stratum."
                    104:     SYNTAX      Unsigned32 (1..16)
                    105: 
                    106: NtpDateTime ::= TEXTUAL-CONVENTION
                    107:     DISPLAY-HINT "4d:4d:4d.4d"
                    108:     STATUS      current
                    109:     DESCRIPTION
                    110:         "NTP date/time on the device, in 128-bit
                    111:          NTP date format.  If time is not syncronized, this
                    112:          field shall be a zero-length string.
                    113: 
                    114:          This trusted certificate (TC) is not to be used for objects
                    115:          that are used to set the time of the node querying this
                    116:          object.  NTP should be used for this -- or at least SNTP."
                    117:     REFERENCE "RFC 5905, section 6"
                    118:     SYNTAX      OCTET STRING (SIZE (0 | 16))
                    119: 
                    120: --
                    121: -- Section 1: General NTP Entity information objects
                    122: --            (relatively static information)
                    123: --
                    124: 
                    125: ntpEntSoftwareName OBJECT-TYPE
                    126:     SYNTAX      Utf8String
                    127:     MAX-ACCESS  read-only
                    128:     STATUS      current
                    129:     DESCRIPTION
                    130:         "The product name of the running NTP version, e.g., 'ntpd'."
                    131:     ::= { ntpEntInfo  1 }
                    132: 
                    133: ntpEntSoftwareVersion OBJECT-TYPE
                    134:     SYNTAX      Utf8String
                    135:     MAX-ACCESS  read-only
                    136:     STATUS      current
                    137:     DESCRIPTION
                    138:         "The software version of the installed NTP implementation
                    139:          as a full version string, e.g., 'ntpd-4.2.0b@1.1433 ...'"
                    140:     ::= { ntpEntInfo  2 }
                    141: 
                    142: ntpEntSoftwareVendor OBJECT-TYPE
                    143:     SYNTAX      Utf8String
                    144:     MAX-ACCESS  read-only
                    145:     STATUS      current
                    146:     DESCRIPTION
                    147:         "The vendor/author of the installed NTP version."
                    148:     ::= { ntpEntInfo  3 }
                    149: 
                    150: ntpEntSystemType OBJECT-TYPE
                    151:     SYNTAX      Utf8String
                    152:     MAX-ACCESS  read-only
                    153:     STATUS      current
                    154:     DESCRIPTION
                    155:         "General hardware/os platform information,
                    156:          e.g., 'Linux 2.6.12 / x86'."
                    157:     -- freely configurable, default is OS Version / Hardware platform
                    158:     ::= { ntpEntInfo  4 }
                    159: 
                    160: ntpEntTimeResolution OBJECT-TYPE
                    161:     SYNTAX      Unsigned32
                    162:     MAX-ACCESS  read-only
                    163:     STATUS      current
                    164:     DESCRIPTION
                    165:         "The time resolution in integer format, where the resolution
                    166:         is represented as divisions of a second, e.g., a value of 1000
                    167:         translates to 1.0 ms."
                    168:     ::= { ntpEntInfo  5 }
                    169: 
                    170: ntpEntTimePrecision OBJECT-TYPE
                    171:     SYNTAX      Integer32
                    172:     MAX-ACCESS  read-only
                    173:     STATUS      current
                    174:     DESCRIPTION
                    175:         "The entity's precision in integer format, shows the precision.
                    176:          A value of -5 would mean 2^-5 = 31.25 ms."
                    177:     ::= { ntpEntInfo  6 }
                    178: 
                    179: ntpEntTimeDistance OBJECT-TYPE
                    180:     SYNTAX      DisplayString
                    181:     MAX-ACCESS  read-only
                    182:     STATUS      current
                    183:     DESCRIPTION
                    184:         "The distance from this NTP entity to the root time reference
                    185:         (stratum 0) source including the unit, e.g., '13.243 ms'."
                    186:     ::= { ntpEntInfo  7 }
                    187: 
                    188: --
                    189: -- Section 2: Current NTP status (dynamic information)
                    190: --
                    191: 
                    192: ntpEntStatusCurrentMode OBJECT-TYPE
                    193:     SYNTAX      INTEGER {
                    194:                             notRunning(1),
                    195:                             notSynchronized(2),
                    196:                             noneConfigured(3),
                    197:                             syncToLocal(4),
                    198:                             syncToRefclock(5),
                    199:                             syncToRemoteServer(6),
                    200:                             unknown(99)
                    201:                         }
                    202:     MAX-ACCESS  read-only
                    203:     STATUS      current
                    204:     DESCRIPTION
                    205:         "The current mode of the NTP.  The definition of each possible
                    206:          value is:
                    207:             notRunning(1) - NTP is not running.
                    208:             notSynchronized(2) - NTP is not synchronized to any time
                    209:                                  source (stratum = 16).
                    210:             noneConfigured(3) - NTP is not synchronized and does not
                    211:                                 have a reference configured
                    212:                                 (stratum = 16).
                    213:             syncToLocal(4) - NTP is distributing time based on its
                    214:                              local clock (degraded accuracy and/or
                    215:                              reliability).
                    216:             syncToRefclock(5) - NTP is synchronized to a local
                    217:                                 hardware refclock (e.g., GPS).
                    218:             syncToRemoteServer(6) - NTP is synchronized to a remote
                    219:                                     NTP server ('upstream' server).
                    220:             unknown(99) - The state of NTP is unknown."
                    221:     ::= { ntpEntStatus 1 }
                    222: 
                    223: ntpEntStatusStratum OBJECT-TYPE
                    224:     SYNTAX      NtpStratum
                    225:     MAX-ACCESS  read-only
                    226:     STATUS      current
                    227:     DESCRIPTION
                    228:         "The NTP entity's own stratum value.  Should be a stratum of
                    229:          syspeer + 1 (or 16 if no syspeer)."
                    230:     ::= { ntpEntStatus 2 }
                    231: 
                    232: ntpEntStatusActiveRefSourceId OBJECT-TYPE
                    233:     SYNTAX      Unsigned32 ( 0..99999 )
                    234:     MAX-ACCESS  read-only
                    235:     STATUS      current
                    236:     DESCRIPTION
                    237:         "The association ID of the current syspeer."
                    238:     ::= { ntpEntStatus 3 }
                    239: 
                    240: ntpEntStatusActiveRefSourceName OBJECT-TYPE
                    241:     SYNTAX      Utf8String
                    242:     MAX-ACCESS  read-only
                    243:     STATUS      current
                    244:     DESCRIPTION
                    245:         "The hostname/descriptive name of the current reference source
                    246:          selected as syspeer, e.g., 'ntp1.ptb.de' or 'GPS' or
                    247:          'DCFi', ..."
                    248:     ::= { ntpEntStatus 4 }
                    249: 
                    250: ntpEntStatusActiveOffset OBJECT-TYPE
                    251:     SYNTAX      DisplayString
                    252:     MAX-ACCESS  read-only
                    253:     STATUS      current
                    254:     DESCRIPTION
                    255:         "The time offset to the current selected reference time source
                    256:          as a string including unit, e.g., '0.032 ms' or '1.232 s'."
                    257:     ::= { ntpEntStatus 5 }
                    258: 
                    259: ntpEntStatusNumberOfRefSources OBJECT-TYPE
                    260:     SYNTAX      Unsigned32 (0..99)
                    261:     MAX-ACCESS  read-only
                    262:     STATUS      current
                    263:     DESCRIPTION
                    264:         "The number of reference sources configured for NTP."
                    265:     ::= { ntpEntStatus 6 }
                    266: 
                    267: ntpEntStatusDispersion OBJECT-TYPE
                    268:     SYNTAX      DisplayString
                    269:     MAX-ACCESS  read-only
                    270:     STATUS      current
                    271:     DESCRIPTION
                    272:         "The root dispersion of the running NTP entity, e.g., '6.927'."
                    273:     ::= { ntpEntStatus 7 }
                    274: 
                    275: ntpEntStatusEntityUptime OBJECT-TYPE
                    276:     SYNTAX      TimeTicks
                    277:     MAX-ACCESS  read-only
                    278:     STATUS      current
                    279:     DESCRIPTION
                    280:         "The uptime of the NTP entity, (i.e., the time since ntpd was
                    281:          (re-)initialized not sysUptime!).  The time is represented in
                    282:          hundreds of seconds since Jan 1, 1970 (00:00:00.000) UTC."
                    283:     ::= { ntpEntStatus 8 }
                    284: 
                    285: ntpEntStatusDateTime OBJECT-TYPE
                    286:     SYNTAX      NtpDateTime
                    287:     MAX-ACCESS  read-only
                    288:     STATUS      current
                    289:     DESCRIPTION
                    290:         "The current NTP date/time on the device, in 128-bit
                    291:          NTP date format.  If time is not syncronized, this
                    292:          field shall be a zero-length string.
                    293: 
                    294:          This object can be used to timestamp events on this
                    295:          node and allow a management station to correlate
                    296:          different time objects.  For example, a management
                    297:          station could query this object and sysUpTime in
                    298:          the same operation to be able to relate sysUpTime
                    299:          to NTP time.
                    300: 
                    301:          This object is not to be used to set the time of
                    302:          the node querying this object.  NTP should be used
                    303:          for this -- or at least SNTP."
                    304:     REFERENCE "RFC 5905, section 6"
                    305:     ::= { ntpEntStatus 9 }
                    306: 
                    307: ntpEntStatusLeapSecond OBJECT-TYPE
                    308:     SYNTAX      NtpDateTime
                    309:     MAX-ACCESS  read-only
                    310:     STATUS      current
                    311:     DESCRIPTION
                    312:         "Date the next known leap second will occur.  If there is
                    313:          no leap second announced, then this object should be 0."
                    314:     ::= { ntpEntStatus 10 }
                    315: 
                    316: ntpEntStatusLeapSecDirection OBJECT-TYPE
                    317:     SYNTAX      Integer32 (-1..1)
                    318:     MAX-ACCESS  read-only
                    319:     STATUS      current
                    320:     DESCRIPTION
                    321:         "Direction of next known leap second.  If there is no
                    322:          leap second announced, then this object should be 0."
                    323:     ::= { ntpEntStatus 11 }
                    324: 
                    325: ntpEntStatusInPkts OBJECT-TYPE
                    326:     SYNTAX      Counter32
                    327:     UNITS       "packets"
                    328:     MAX-ACCESS  read-only
                    329:     STATUS      current
                    330:     DESCRIPTION
                    331:         "The total number of NTP messages delivered to the
                    332:          NTP entity from the transport service.
                    333:          Discountinuities in the value of this counter can occur
                    334:          upon cold start or reinitialization of the NTP entity, the
                    335:          management system and at other times as indicated by
                    336:          discontinuities in the value of sysUpTime."
                    337:     ::= { ntpEntStatus 12 }
                    338: 
                    339: ntpEntStatusOutPkts OBJECT-TYPE
                    340:     SYNTAX      Counter32
                    341:     UNITS       "packets"
                    342:     MAX-ACCESS  read-only
                    343:     STATUS      current
                    344:     DESCRIPTION
                    345:         "The total number of NTP messages delivered to the
                    346:          transport service by this NTP entity.
                    347:          Discountinuities in the value of this counter can occur
                    348:          upon cold start or reinitialization of the NTP entity, the
                    349:          management system and at other times as indicated by
                    350:          discontinuities in the value of sysUpTime."
                    351:     ::= { ntpEntStatus 13 }
                    352: 
                    353: ntpEntStatusBadVersion OBJECT-TYPE
                    354:     SYNTAX      Counter32
                    355:     UNITS       "packets"
                    356:     MAX-ACCESS  read-only
                    357:     STATUS      current
                    358:     DESCRIPTION
                    359:         "The total number of NTP messages that were delivered
                    360:          to this NTP entity and were for an unsupported NTP
                    361:          version.
                    362:          Discountinuities in the value of this counter can occur
                    363:          upon cold start or reinitialization of the NTP entity, the
                    364:          management system and at other times as indicated by
                    365:          discontinuities in the value of sysUpTime."
                    366:     ::= { ntpEntStatus 14 }
                    367: 
                    368: ntpEntStatusProtocolError OBJECT-TYPE
                    369:     SYNTAX      Counter32
                    370:     UNITS       "packets"
                    371:     MAX-ACCESS  read-only
                    372:     STATUS      current
                    373:     DESCRIPTION
                    374:         "The total number of NTP messages that were delivered
                    375:          to this NTP entity and this entity was not able to
                    376:          process due to an NTP protocol error.
                    377:          Discountinuities in the value of this counter can occur
                    378:          upon cold start or reinitialization of the NTP entity, the
                    379:          management system and at other times as indicated by
                    380:          discontinuities in the value of sysUpTime."
                    381:     ::= { ntpEntStatus 15 }
                    382: 
                    383: ntpEntStatusNotifications OBJECT-TYPE
                    384:     SYNTAX      Counter32
                    385:     UNITS       "notifications"
                    386:     MAX-ACCESS  read-only
                    387:     STATUS      current
                    388:     DESCRIPTION
                    389:         "The total number of SNMP notifications that this NTP
                    390:          entity has generated.
                    391:          Discountinuities in the value of this counter can occur
                    392:          upon cold start or reinitialization of the NTP entity, the
                    393:          management system and at other times as indicated by
                    394:          discontinuities in the value of sysUpTime."
                    395:     ::= { ntpEntStatus 16 }
                    396: 
                    397: ntpEntStatPktModeTable OBJECT-TYPE
                    398:     SYNTAX           SEQUENCE OF NtpEntStatPktModeEntry
                    399:     MAX-ACCESS       not-accessible
                    400:     STATUS           current
                    401:     DESCRIPTION
                    402:         "The number of packets sent and received by packet mode.
                    403:          One entry per packet mode."
                    404:     ::= { ntpEntStatus 17 }
                    405: 
                    406: ntpEntStatPktModeEntry OBJECT-TYPE
                    407:     SYNTAX      NtpEntStatPktModeEntry
                    408:     MAX-ACCESS  not-accessible
                    409:     STATUS      current
                    410:     DESCRIPTION
                    411:         "A statistical record of the number of packets sent and
                    412:          received for each packet mode."
                    413:     INDEX       { ntpEntStatPktMode }
                    414:     ::= { ntpEntStatPktModeTable 1 }
                    415: 
                    416: NtpEntStatPktModeEntry   ::= SEQUENCE {
                    417:         ntpEntStatPktMode              INTEGER,
                    418:         ntpEntStatPktSent              Counter32,
                    419:         ntpEntStatPktReceived          Counter32
                    420: }
                    421: 
                    422: ntpEntStatPktMode OBJECT-TYPE
                    423:     SYNTAX      INTEGER {
                    424:                     symetricactive(1),
                    425:                     symetricpassive(2),
                    426:                     client(3),
                    427:                     server(4),
                    428:                     broadcastserver(5),
                    429:                     broadcastclient(6)
                    430:                 }
                    431:     MAX-ACCESS  not-accessible
                    432:     STATUS      current
                    433:     DESCRIPTION
                    434:         "The NTP packet mode."
                    435:     ::= { ntpEntStatPktModeEntry 1 }
                    436: 
                    437: ntpEntStatPktSent OBJECT-TYPE
                    438:     SYNTAX      Counter32
                    439:     UNITS       "packets"
                    440:     MAX-ACCESS  read-only
                    441:     STATUS      current
                    442:     DESCRIPTION
                    443:         "The number of NTP packets sent with this packet mode.
                    444:          Discountinuities in the value of this counter can occur
                    445:          upon cold start or reinitialization of the NTP entity, the
                    446:          management system and at other times as indicated by
                    447:          discontinuities in the value of sysUpTime."
                    448:     ::= { ntpEntStatPktModeEntry 2 }
                    449: 
                    450: ntpEntStatPktReceived OBJECT-TYPE
                    451:     SYNTAX      Counter32
                    452:     UNITS       "packets"
                    453:     MAX-ACCESS  read-only
                    454:     STATUS      current
                    455:     DESCRIPTION
                    456:         "The number of NTP packets received with this packet mode.
                    457: 
                    458:          Discountinuities in the value of this counter can occur
                    459:          upon cold start or reinitialization of the NTP entity, the
                    460:          management system and at other times as indicated by
                    461:          discontinuities in the value of sysUpTime."
                    462:     ::= { ntpEntStatPktModeEntry 3 }
                    463: 
                    464: --
                    465: -- Section 3: The status of all currently mobilized associations
                    466: --
                    467: 
                    468: ntpAssociationTable OBJECT-TYPE
                    469:     SYNTAX           SEQUENCE OF NtpAssociationEntry
                    470:     MAX-ACCESS       not-accessible
                    471:     STATUS           current
                    472:     DESCRIPTION
                    473:         "The table of currently mobilized associations."
                    474:     ::= { ntpAssociation 1 }
                    475: 
                    476: ntpAssociationEntry OBJECT-TYPE
                    477:     SYNTAX      NtpAssociationEntry
                    478:     MAX-ACCESS  not-accessible
                    479:     STATUS      current
                    480:     DESCRIPTION
                    481:         "The table entry of currently mobilized associations."
                    482:     INDEX       { ntpAssocId }
                    483:     ::= { ntpAssociationTable 1 }
                    484: 
                    485: NtpAssociationEntry   ::= SEQUENCE {
                    486:         ntpAssocId                  Unsigned32,
                    487:         ntpAssocName                Utf8String,
                    488:         ntpAssocRefId               DisplayString,
                    489:         ntpAssocAddressType         InetAddressType,
                    490:         ntpAssocAddress             InetAddress,
                    491:         ntpAssocOffset              DisplayString,
                    492:         ntpAssocStratum             NtpStratum,
                    493:         ntpAssocStatusJitter        DisplayString,
                    494:         ntpAssocStatusDelay         DisplayString,
                    495:         ntpAssocStatusDispersion    DisplayString
                    496: }
                    497: 
                    498: ntpAssocId      OBJECT-TYPE
                    499:     SYNTAX      Unsigned32 ( 1..99999 )
                    500:     MAX-ACCESS  not-accessible
                    501:     STATUS      current
                    502:     DESCRIPTION
                    503:         "The association ID.  This is an internal, unique ID."
                    504:     ::= { ntpAssociationEntry 1 }
                    505: 
                    506: ntpAssocName    OBJECT-TYPE
                    507:     SYNTAX      Utf8String
                    508:     MAX-ACCESS  read-only
                    509:     STATUS      current
                    510:     DESCRIPTION
                    511:         "The hostname or other descriptive name for the association."
                    512:     ::= { ntpAssociationEntry 2 }
                    513: 
                    514: ntpAssocRefId   OBJECT-TYPE
                    515:     SYNTAX      DisplayString
                    516:     MAX-ACCESS  read-only
                    517:     STATUS      current
                    518:     DESCRIPTION
                    519:         "The refclock driver ID, if available."
                    520:     -- a refclock driver ID like "127.127.1.0" for non
                    521:     -- uni/multi/broadcast associations
                    522:     ::= { ntpAssociationEntry 3 }
                    523: 
                    524: ntpAssocAddressType OBJECT-TYPE
                    525:     SYNTAX      InetAddressType { ipv4(1), ipv6(2), ipv4z(3), ipv6z(4) }
                    526:     MAX-ACCESS  read-only
                    527:     STATUS      current
                    528:     DESCRIPTION
                    529:         "The type of address of the association.  Can be either IPv4 or
                    530:          IPv6 (both with or without zone index) and contains the type of
                    531:          address for unicast, multicast, and broadcast associations."
                    532:     ::= { ntpAssociationEntry 4 }
                    533: 
                    534: ntpAssocAddress OBJECT-TYPE
                    535:     SYNTAX      InetAddress (SIZE (4|8|16|20))
                    536:     MAX-ACCESS  read-only
                    537:     STATUS      current
                    538:     DESCRIPTION
                    539:         "The IP address (IPv4 or IPv6, with or without zone index) of
                    540:          the association.  The type and size depends on the
                    541:          ntpAssocAddressType object.  Represents the IP address of a
                    542:          uni/multi/broadcast association."
                    543:     ::= { ntpAssociationEntry 5 }
                    544: 
                    545: ntpAssocOffset  OBJECT-TYPE
                    546:     SYNTAX      DisplayString
                    547:     MAX-ACCESS  read-only
                    548:     STATUS      current
                    549:     DESCRIPTION
                    550:         "The time offset to the association as a string."
                    551:     -- including unit, e.g., "0.032 ms" or "1.232 s"
                    552:     ::= { ntpAssociationEntry 6 }
                    553: 
                    554: ntpAssocStratum OBJECT-TYPE
                    555:     SYNTAX      NtpStratum
                    556:     MAX-ACCESS  read-only
                    557:     STATUS      current
                    558:     DESCRIPTION
                    559:         "The association stratum value."
                    560:     ::= { ntpAssociationEntry 7 }
                    561: 
                    562: ntpAssocStatusJitter OBJECT-TYPE
                    563:     SYNTAX      DisplayString
                    564:     MAX-ACCESS  read-only
                    565:     STATUS      current
                    566:     DESCRIPTION
                    567:         "The jitter in milliseconds as a string."
                    568:     ::= { ntpAssociationEntry 8 }
                    569: 
                    570: ntpAssocStatusDelay OBJECT-TYPE
                    571:     SYNTAX      DisplayString
                    572:     MAX-ACCESS  read-only
                    573:     STATUS      current
                    574:     DESCRIPTION
                    575:         "The network delay in milliseconds as a string."
                    576:     ::= { ntpAssociationEntry 9 }
                    577: 
                    578: ntpAssocStatusDispersion OBJECT-TYPE
                    579:     SYNTAX      DisplayString
                    580:     MAX-ACCESS  read-only
                    581:     STATUS      current
                    582:     DESCRIPTION
                    583:         "The root dispersion of the association."
                    584:     -- e.g., "6.927"
                    585:     ::= { ntpAssociationEntry 10 }
                    586: 
                    587: ntpAssociationStatisticsTable OBJECT-TYPE
                    588:     SYNTAX           SEQUENCE OF NtpAssociationStatisticsEntry
                    589:     MAX-ACCESS       not-accessible
                    590:     STATUS           current
                    591:     DESCRIPTION
                    592:         "The table of statistics for current associations."
                    593:     ::= { ntpAssociation 2 }
                    594: 
                    595: ntpAssociationStatisticsEntry OBJECT-TYPE
                    596:     SYNTAX      NtpAssociationStatisticsEntry
                    597:     MAX-ACCESS  not-accessible
                    598:     STATUS      current
                    599:     DESCRIPTION
                    600:         "The table entry of statistics for current associations."
                    601:     INDEX       { ntpAssocId }
                    602:     ::= { ntpAssociationStatisticsTable 1 }
                    603: 
                    604: NtpAssociationStatisticsEntry   ::= SEQUENCE {
                    605:         ntpAssocStatInPkts          Counter32,
                    606:         ntpAssocStatOutPkts         Counter32,
                    607:         ntpAssocStatProtocolError   Counter32
                    608: }
                    609: 
                    610: ntpAssocStatInPkts OBJECT-TYPE
                    611:     SYNTAX      Counter32
                    612:     UNITS       "packets"
                    613:     MAX-ACCESS  read-only
                    614:     STATUS      current
                    615:     DESCRIPTION
                    616:         "The total number of NTP messages delivered to the
                    617:          NTP entity from this association.
                    618:          Discountinuities in the value of this counter can occur
                    619:          upon cold start or reinitialization of the NTP entity, the
                    620:          management system and at other times as indicated by
                    621:          discontinuities in the value of sysUpTime."
                    622:     ::= { ntpAssociationStatisticsEntry 1 }
                    623: 
                    624: ntpAssocStatOutPkts OBJECT-TYPE
                    625:     SYNTAX      Counter32
                    626:     UNITS       "packets"
                    627:     MAX-ACCESS  read-only
                    628:     STATUS      current
                    629:     DESCRIPTION
                    630:         "The total number of NTP messages delivered to the
                    631:          transport service by this NTP entity for this
                    632:          association.
                    633:          Discountinuities in the value of this counter can occur
                    634:          upon cold start or reinitialization of the NTP entity, the
                    635:          management system and at other times as indicated by
                    636:          discontinuities in the value of sysUpTime."
                    637:     ::= { ntpAssociationStatisticsEntry 2 }
                    638: 
                    639: ntpAssocStatProtocolError OBJECT-TYPE
                    640:     SYNTAX      Counter32
                    641:     UNITS       "packets"
                    642:     MAX-ACCESS  read-only
                    643:     STATUS      current
                    644:     DESCRIPTION
                    645:         "The total number of NTP messages that were delivered
                    646:          to this NTP entity from this association and this entity
                    647:          was not able to process due to an NTP protocol error.
                    648:          Discountinuities in the value of this counter can occur
                    649:          upon cold start or reinitialization of the NTP entity, the
                    650:          management system and at other times as indicated by
                    651:          discontinuities in the value of sysUpTime."
                    652:     ::= { ntpAssociationStatisticsEntry 3 }
                    653: 
                    654: --
                    655: -- Section 4: Control objects
                    656: --
                    657: 
                    658: ntpEntHeartbeatInterval OBJECT-TYPE
                    659:     SYNTAX      Unsigned32
                    660:     UNITS       "seconds"
                    661:     MAX-ACCESS  read-write
                    662:     STATUS      current
                    663:     DESCRIPTION
                    664:         "The interval at which the ntpEntNotifHeartbeat notification
                    665:          should be sent, in seconds.  If set to 0 and the
                    666:          entNotifHeartbeat bit in ntpEntNotifBits is 1, then
                    667:          ntpEntNotifHeartbeat is sent once.
                    668:          This value is stored persistently and will be restored to its
                    669:          last set value upon cold start or restart."
                    670:     DEFVAL { 60 }
                    671:     ::= { ntpEntControl 1 }
                    672: 
                    673: ntpEntNotifBits OBJECT-TYPE
                    674:     SYNTAX       BITS {
                    675:                      notUsed(0), -- Used to sync up bit and notification
                    676:                                  -- indices
                    677:                      entNotifModeChange(1),
                    678:                      entNotifStratumChange(2),
                    679:                      entNotifSyspeerChanged(3),
                    680:                      entNotifAddAssociation(4),
                    681:                      entNotifRemoveAssociation(5),
                    682:                      entNotifConfigChanged(6),
                    683:                      entNotifLeapSecondAnnounced(7),
                    684:                      entNotifHeartbeat(8)
                    685:     }
                    686:     MAX-ACCESS  read-write
                    687:     STATUS      current
                    688:     DESCRIPTION
                    689:         "A bit for each notification.  A 1 for a particular bit enables
                    690:          that particular notification, a 0 disables it.
                    691:          This value is stored persistently and will be restored to its
                    692:          last set value upon cold start or restart."
                    693:     ::= { ntpEntControl 2 }
                    694: 
                    695: --
                    696: -- Section 5: Notification objects
                    697: --
                    698: 
                    699: ntpEntNotifMessage OBJECT-TYPE
                    700:     SYNTAX      Utf8String
                    701:     MAX-ACCESS  accessible-for-notify
                    702:     STATUS      current
                    703:     DESCRIPTION
                    704:         "Used as a payload object for all notifications.  Holds a
                    705:          cleartext event message."
                    706:     DEFVAL { "no event" }
                    707:     ::= { ntpEntNotifObjects 1 }
                    708: 
                    709: --
                    710: -- SNMP notification definitions
                    711: --
                    712: 
                    713: ntpEntNotifications OBJECT IDENTIFIER ::= { ntpSnmpMIB 0 }
                    714: 
                    715: ntpEntNotifModeChange NOTIFICATION-TYPE
                    716:     OBJECTS     { ntpEntStatusCurrentMode }
                    717:     STATUS      current
                    718:     DESCRIPTION
                    719:         "The notification to be sent when the NTP entity changes mode,
                    720:          including starting and stopping (if possible)."
                    721:     ::= { ntpEntNotifications 1 }
                    722: 
                    723: ntpEntNotifStratumChange NOTIFICATION-TYPE
                    724:     OBJECTS     { ntpEntStatusDateTime, ntpEntStatusStratum,
                    725:                   ntpEntNotifMessage }
                    726:     STATUS      current
                    727:     DESCRIPTION
                    728:         "The notification to be sent when stratum level of NTP changes."
                    729:     ::= { ntpEntNotifications 2 }
                    730: 
                    731: ntpEntNotifSyspeerChanged NOTIFICATION-TYPE
                    732:     OBJECTS     { ntpEntStatusDateTime, ntpEntStatusActiveRefSourceId,
                    733:                   ntpEntNotifMessage }
                    734:     STATUS      current
                    735:     DESCRIPTION
                    736:         "The notification to be sent when a (new) syspeer has been
                    737:          selected."
                    738:     ::= { ntpEntNotifications 3 }
                    739: 
                    740: ntpEntNotifAddAssociation NOTIFICATION-TYPE
                    741:     OBJECTS  { ntpEntStatusDateTime, ntpAssocName, ntpEntNotifMessage }
                    742:     STATUS      current
                    743:     DESCRIPTION
                    744:         "The notification to be sent when a new association is
                    745:          mobilized."
                    746:     ::= { ntpEntNotifications 4 }
                    747: 
                    748: ntpEntNotifRemoveAssociation NOTIFICATION-TYPE
                    749:     OBJECTS  { ntpEntStatusDateTime, ntpAssocName,  ntpEntNotifMessage }
                    750:     STATUS      current
                    751:     DESCRIPTION
                    752:         "The notification to be sent when an association is
                    753:          demobilized."
                    754:     ::= { ntpEntNotifications 5 }
                    755: 
                    756: ntpEntNotifConfigChanged NOTIFICATION-TYPE
                    757:     OBJECTS     { ntpEntStatusDateTime, ntpEntNotifMessage }
                    758:     STATUS      current
                    759:     DESCRIPTION
                    760:         "The notification to be sent when the NTP configuration has
                    761:          changed, e.g., when the system connected to the Internet and
                    762:          was assigned a new IP address by the ISPs DHCP server."
                    763:     ::= { ntpEntNotifications 6 }
                    764: 
                    765: ntpEntNotifLeapSecondAnnounced NOTIFICATION-TYPE
                    766:     OBJECTS     { ntpEntStatusDateTime, ntpEntNotifMessage }
                    767:     STATUS      current
                    768:     DESCRIPTION
                    769:         "The notification to be sent when a leap second has been
                    770:          announced."
                    771:     ::= { ntpEntNotifications 7 }
                    772: 
                    773: ntpEntNotifHeartbeat NOTIFICATION-TYPE
                    774:     OBJECTS     { ntpEntStatusDateTime, ntpEntStatusCurrentMode,
                    775:                   ntpEntHeartbeatInterval, ntpEntNotifMessage }
                    776:     STATUS      current
                    777:     DESCRIPTION
                    778:         "The notification to be sent periodically (as defined by
                    779:          ntpEntHeartbeatInterval) to indicate that the NTP entity is
                    780:          still alive."
                    781:     ::= { ntpEntNotifications 8 }
                    782: 
                    783: --
                    784: -- Conformance/Compliance statements
                    785: --
                    786: 
                    787: ntpEntConformance OBJECT IDENTIFIER ::= { ntpSnmpMIB 2 }
                    788: 
                    789: ntpEntCompliances OBJECT IDENTIFIER ::= { ntpEntConformance 1 }
                    790: ntpEntGroups      OBJECT IDENTIFIER ::= { ntpEntConformance 2 }
                    791: 
                    792: ntpEntNTPCompliance MODULE-COMPLIANCE
                    793:     STATUS      current
                    794:     DESCRIPTION
                    795:         "The compliance statement for SNMP entities that use NTP and
                    796:          implement the NTP MIB."
                    797:     MODULE  -- this module
                    798:         MANDATORY-GROUPS {
                    799:                            ntpEntObjectsGroup1
                    800:         }
                    801:         ::= { ntpEntCompliances 1 }
                    802: 
                    803: ntpEntSNTPCompliance MODULE-COMPLIANCE
                    804:     STATUS      current
                    805:     DESCRIPTION
                    806:         "The compliance statement for SNMP entities that use SNTP and
                    807:          implement the NTP MIB."
                    808:     MODULE  -- this module
                    809:         MANDATORY-GROUPS {
                    810:                            ntpEntObjectsGroup1
                    811:         }
                    812:         GROUP ntpEntObjectsGroup2
                    813:         DESCRIPTION
                    814:                 "Optional object group."
                    815:         GROUP ntpEntNotifGroup
                    816:         DESCRIPTION
                    817:                 "Optional notifications for this MIB."
                    818:         ::= { ntpEntCompliances 2 }
                    819: 
                    820: ntpEntObjectsGroup1 OBJECT-GROUP
                    821:     OBJECTS {
                    822:               ntpEntSoftwareName,
                    823:               ntpEntSoftwareVersion,
                    824:               ntpEntSoftwareVendor,
                    825:               ntpEntSystemType,
                    826:               ntpEntStatusEntityUptime,
                    827:               ntpEntStatusDateTime,
                    828:               ntpAssocName,
                    829:               ntpAssocRefId,
                    830:               ntpAssocAddressType,
                    831:               ntpAssocAddress
                    832:     }
                    833:     STATUS      current
                    834:     DESCRIPTION
                    835:         "A collection of objects for the NTP MIB."
                    836:     ::= { ntpEntGroups 1 }
                    837: 
                    838: ntpEntObjectsGroup2 OBJECT-GROUP
                    839:     OBJECTS {
                    840:               ntpEntTimeResolution,
                    841:               ntpEntTimePrecision,
                    842:               ntpEntTimeDistance,
                    843:               ntpEntStatusCurrentMode,
                    844:               ntpEntStatusStratum,
                    845:               ntpEntStatusActiveRefSourceId,
                    846:               ntpEntStatusActiveRefSourceName,
                    847:               ntpEntStatusActiveOffset,
                    848:               ntpEntStatusNumberOfRefSources,
                    849:               ntpEntStatusDispersion,
                    850:               ntpEntStatusLeapSecond,
                    851:               ntpEntStatusLeapSecDirection,
                    852:               ntpEntStatusInPkts,
                    853:               ntpEntStatusOutPkts,
                    854:               ntpEntStatusBadVersion,
                    855:               ntpEntStatusProtocolError,
                    856:               ntpEntStatusNotifications,
                    857:               ntpEntStatPktSent,
                    858:               ntpEntStatPktReceived,
                    859:               ntpAssocOffset,
                    860:               ntpAssocStratum,
                    861:               ntpAssocStatusJitter,
                    862:               ntpAssocStatusDelay,
                    863:               ntpAssocStatusDispersion,
                    864:               ntpAssocStatInPkts,
                    865:               ntpAssocStatOutPkts,
                    866:               ntpAssocStatProtocolError,
                    867:               ntpEntHeartbeatInterval,
                    868:               ntpEntNotifBits,
                    869:               ntpEntNotifMessage
                    870:     }
                    871:     STATUS      current
                    872:     DESCRIPTION
                    873:         "A collection of objects for the NTP MIB."
                    874:     ::= { ntpEntGroups 2 }
                    875: 
                    876: ntpEntNotifGroup NOTIFICATION-GROUP
                    877:     NOTIFICATIONS {
                    878:                     ntpEntNotifModeChange,
                    879:                     ntpEntNotifStratumChange,
                    880:                     ntpEntNotifSyspeerChanged,
                    881:                     ntpEntNotifAddAssociation,
                    882:                     ntpEntNotifRemoveAssociation,
                    883:                     ntpEntNotifConfigChanged,
                    884:                     ntpEntNotifLeapSecondAnnounced,
                    885:                     ntpEntNotifHeartbeat
                    886:     }
                    887:     STATUS      current
                    888:     DESCRIPTION
                    889:         "A collection of notifications for the NTP MIB"
                    890:     ::= { ntpEntGroups 3 }
                    891: 
                    892: END

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>