contrib/bind9/doc/rfc/rfc1611.txt

   1
   2
   3
   4
   5
   6
   7 Network Working Group                                         R. Austein
   8 Request for Comments: 1611               Epilogue Technology Corporation
   9 Category: Standards Track                                     J. Saperia
  10                                            Digital Equipment Corporation
  11                                                                 May 1994
  12
  13                        DNS Server MIB Extensions
  14
  15 Status of this Memo
  16
  17    This document specifies an Internet standards track protocol for the
  18    Internet community, and requests discussion and suggestions for
  19    improvements.  Please refer to the current edition of the "Internet
  20    Official Protocol Standards" (STD 1) for the standardization state
  21    and status of this protocol.  Distribution of this memo is unlimited.
  22
  23 Table of Contents
  24
  25    1. Introduction ..............................................    1
  26    2. The SNMPv2 Network Management Framework ...................    2
  27    2.1 Object Definitions .......................................    2
  28    3. Overview ..................................................    2
  29    3.1 Resolvers ................................................    3
  30    3.2 Name Servers .............................................    3
  31    3.3 Selected Objects .........................................    4
  32    3.4 Textual Conventions ......................................    4
  33    4. Definitions ...............................................    5
  34    5. Acknowledgements ..........................................   28
  35    6. References ................................................   28
  36    7. Security Considerations ...................................   29
  37    8. Authors' Addresses ........................................   30
  38
  39 1.  Introduction
  40
  41    This memo defines a portion of the Management Information Base (MIB)
  42    for use with network management protocols in the Internet community.
  43    In particular, it describes a set of extensions which instrument DNS
  44    name server functions.  This memo was produced by the DNS working
  45    group.
  46
  47    With the adoption of the Internet-standard Network Management
  48    Framework [4,5,6,7], and with a large number of vendor
  49    implementations of these standards in commercially available
  50    products, it became possible to provide a higher level of effective
  51    network management in TCP/IP-based internets than was previously
  52    available.  With the growth in the use of these standards, it has
  53    become possible to consider the management of other elements of the
  54    infrastructure beyond the basic TCP/IP protocols.  A key element of
  55
  56
  57
  58 Austein & Saperia                                               [Page 1]
  59 \f
  60 RFC 1611               DNS Server MIB Extensions                May 1994
  61
  62
  63    the TCP/IP infrastructure is the DNS.
  64
  65    Up to this point there has been no mechanism to integrate the
  66    management of the DNS with SNMP-based managers.  This memo provides
  67    the mechanisms by which IP-based management stations can effectively
  68    manage DNS name server software in an integrated fashion.
  69
  70    We have defined DNS MIB objects to be used in conjunction with the
  71    Internet MIB to allow access to and control of DNS name server
  72    software via SNMP by the Internet community.
  73
  74 2.  The SNMPv2 Network Management Framework
  75
  76    The SNMPv2 Network Management Framework consists of four major
  77    components.  They are:
  78
  79       o  RFC 1442 which defines the SMI, the mechanisms used for
  80          describing and naming objects for the purpose of management.
  81
  82       o  STD 17, RFC 1213 defines MIB-II, the core set of managed objects
  83          for the Internet suite of protocols.
  84
  85       o  RFC 1445 which defines the administrative and other architectural
  86          aspects of the framework.
  87
  88       o  RFC 1448 which defines the protocol used for network access to
  89          managed objects.
  90
  91       The Framework permits new objects to be defined for the purpose of
  92       experimentation and evaluation.
  93
  94 2.1.  Object Definitions
  95
  96    Managed objects are accessed via a virtual information store, termed
  97    the Management Information Base or MIB.  Objects in the MIB are
  98    defined using the subset of Abstract Syntax Notation One (ASN.1)
  99    defined in the SMI.  In particular, each object object type is named
 100    by an OBJECT IDENTIFIER, an administratively assigned name.  The
 101    object type together with an object instance serves to uniquely
 102    identify a specific instantiation of the object.  For human
 103    convenience, we often use a textual string, termed the descriptor, to
 104    refer to the object type.
 105
 106 3.  Overview
 107
 108    In theory, the DNS world is pretty simple.  There are two kinds of
 109    entities: resolvers and name servers.  Resolvers ask questions.  Name
 110    servers answer them.  The real world, however, is not so simple.
 111
 112
 113
 114 Austein & Saperia                                               [Page 2]
 115 \f
 116 RFC 1611               DNS Server MIB Extensions                May 1994
 117
 118
 119    Implementors have made widely differing choices about how to divide
 120    DNS functions between resolvers and servers.  They have also
 121    constructed various sorts of exotic hybrids.  The most difficult task
 122    in defining this MIB was to accommodate this wide range of entities
 123    without having to come up with a separate MIB for each.
 124
 125    We divided up the various DNS functions into two, non-overlapping
 126    classes, called "resolver functions" and "name server functions."  A
 127    DNS entity that performs what we define as resolver functions
 128    contains a resolver, and therefore must implement the MIB groups
 129    required of all resolvers which are defined in a separate MIB Module.
 130    A DNS entity which implements name server functions is considered to
 131    be a name server, and must implement the MIB groups required for name
 132    servers in this module.  If the same piece of software performs both
 133    resolver and server functions, we imagine that it contains both a
 134    resolver and a server and would thus implement both the DNS Server
 135    and DNS Resolver MIBs.
 136
 137 3.1.  Resolvers
 138
 139    In our model, a resolver is a program (or piece thereof) which
 140    obtains resource records from servers.  Normally it does so at the
 141    behest of an application, but may also do so as part of its own
 142    operation.  A resolver sends DNS protocol queries and receives DNS
 143    protocol replies.  A resolver neither receives queries nor sends
 144    replies.  A full service resolver is one that knows how to resolve
 145    queries: it obtains the needed resource records by contacting a
 146    server authoritative for the records desired.  A stub resolver does
 147    not know how to resolve queries: it sends all queries to a local name
 148    server, setting the "recursion desired" flag to indicate that it
 149    hopes that the name server will be willing to resolve the query.  A
 150    resolver may (optionally) have a cache for remembering previously
 151    acquired resource records.  It may also have a negative cache for
 152    remembering names or data that have been determined not to exist.
 153
 154 3.2.  Name Servers
 155
 156    A name server is a program (or piece thereof) that provides resource
 157    records to resolvers.  All references in this document to "a name
 158    server" imply "the name server's role"; in some cases the name
 159    server's role and the resolver's role might be combined into a single
 160    program.  A name server receives DNS protocol queries and sends DNS
 161    protocol replies.  A name server neither sends queries nor receives
 162    replies.  As a consequence, name servers do not have caches.
 163    Normally, a name server would expect to receive only those queries to
 164    which it could respond with authoritative information.  However, if a
 165    name server receives a query that it cannot respond to with purely
 166    authoritative information, it may choose to try to obtain the
 167
 168
 169
 170 Austein & Saperia                                               [Page 3]
 171 \f
 172 RFC 1611               DNS Server MIB Extensions                May 1994
 173
 174
 175    necessary additional information from a resolver which may or may not
 176    be a separate process.
 177
 178 3.3.  Selected Objects
 179
 180    Many of the objects included in this memo have been created from
 181    information contained in the DNS specifications [1,2], as amended and
 182    clarified by subsequent host requirements documents [3].  Other
 183    objects have been created based on experience with existing DNS
 184    management tools, expected operational needs, the statistics
 185    generated by existing DNS implementations, and the configuration
 186    files used by existing DNS implementations.  These objects have been
 187    ordered into groups as follows:
 188
 189       o  Server Configuration Group
 190
 191       o  Server Counter Group
 192
 193       o  Server Optional Counter Group
 194
 195       o  Server Zone Group
 196
 197    This information has been converted into a standard form using the
 198    SNMPv2 SMI defined in [9].  For the most part, the descriptions are
 199    influenced by the DNS related RFCs noted above.  For example, the
 200    descriptions for counters used for the various types of queries of
 201    DNS records are influenced by the definitions used for the various
 202    record types found in [2].
 203
 204 3.4.  Textual Conventions
 205
 206    Several conceptual data types have been introduced as a textual
 207    conventions in this DNS MIB document.  These additions will
 208    facilitate the common understanding of information used by the DNS.
 209    No changes to the SMI or the SNMP are necessary to support these
 210    conventions.
 211
 212    Readers familiar with MIBs designed to manage entities in the lower
 213    layers of the Internet protocol suite may be surprised at the number
 214    of non-enumerated integers used in this MIB to represent values such
 215    as DNS RR class and type numbers.  The reason for this choice is
 216    simple: the DNS itself is designed as an extensible protocol,
 217    allowing new classes and types of resource records to be added to the
 218    protocol without recoding the core DNS software.  Using non-
 219    enumerated integers to represent these data types in this MIB allows
 220    the MIB to accommodate these changes as well.
 221
 222
 223
 224
 225
 226 Austein & Saperia                                               [Page 4]
 227 \f
 228 RFC 1611               DNS Server MIB Extensions                May 1994
 229
 230
 231 4.  Definitions
 232
 233    DNS-SERVER-MIB DEFINITIONS ::= BEGIN
 234
 235    IMPORTS
 236        mib-2
 237            FROM RFC-1213
 238        MODULE-IDENTITY, OBJECT-TYPE, OBJECT-IDENTITY,
 239        IpAddress, Counter32, Gauge32
 240            FROM SNMPv2-SMI
 241        TEXTUAL-CONVENTION, RowStatus, DisplayString, TruthValue
 242            FROM SNMPv2-TC
 243        MODULE-COMPLIANCE, OBJECT-GROUP
 244            FROM SNMPv2-CONF;
 245
 246    dns OBJECT-IDENTITY
 247        STATUS  current
 248        DESCRIPTION
 249                "The OID assigned to DNS MIB work by the IANA."
 250        ::= { mib-2 32 }
 251
 252    dnsServMIB MODULE-IDENTITY
 253        LAST-UPDATED "9401282251Z"
 254        ORGANIZATION "IETF DNS Working Group"
 255        CONTACT-INFO
 256                "       Rob Austein
 257                Postal: Epilogue Technology Corporation
 258                        268 Main Street, Suite 283
 259                        North Reading, MA 10864
 260                        US
 261                   Tel: +1 617 245 0804
 262                   Fax: +1 617 245 8122
 263                E-Mail: sra@epilogue.com
 264
 265                        Jon Saperia
 266                Postal: Digital Equipment Corporation
 267                        110 Spit Brook Road
 268                        ZKO1-3/H18
 269                        Nashua, NH 03062-2698
 270                        US
 271                   Tel: +1 603 881 0480
 272                   Fax: +1 603 881 0120
 273                 Email: saperia@zko.dec.com"
 274        DESCRIPTION
 275                "The MIB module for entities implementing the server side
 276                of the Domain Name System (DNS) protocol."
 277        ::= { dns 1 }
 278
 279
 280
 281
 282 Austein & Saperia                                               [Page 5]
 283 \f
 284 RFC 1611               DNS Server MIB Extensions                May 1994
 285
 286
 287    dnsServMIBObjects       OBJECT IDENTIFIER ::= { dnsServMIB 1 }
 288
 289    -- (Old-style) groups in the DNS server MIB.
 290
 291    dnsServConfig           OBJECT IDENTIFIER ::= { dnsServMIBObjects 1 }
 292    dnsServCounter          OBJECT IDENTIFIER ::= { dnsServMIBObjects 2 }
 293    dnsServOptCounter       OBJECT IDENTIFIER ::= { dnsServMIBObjects 3 }
 294    dnsServZone             OBJECT IDENTIFIER ::= { dnsServMIBObjects 4 }
 295
 296
 297    -- Textual conventions
 298
 299    DnsName ::= TEXTUAL-CONVENTION
 300        -- A DISPLAY-HINT would be nice, but difficult to express.
 301        STATUS  current
 302        DESCRIPTION
 303                "A DNS name is a sequence of labels.  When DNS names are
 304                displayed, the boundaries between labels are typically
 305                indicated by dots (e.g. `Acme' and `COM' are labels in
 306                the name `Acme.COM').  In the DNS protocol, however, no
 307                such separators are needed because each label is encoded
 308                as a length octet followed by the indicated number of
 309                octets of label.  For example, `Acme.COM' is encoded as
 310                the octet sequence { 4, 'A', 'c', 'm', 'e', 3, 'C', 'O',
 311                'M', 0 } (the final 0 is the length of the name of the
 312                root domain, which appears implicitly at the end of any
 313                DNS name).  This MIB uses the same encoding as the DNS
 314                protocol.
 315
 316                A DnsName must always be a fully qualified name.  It is
 317                an error to encode a relative domain name as a DnsName
 318                without first making it a fully qualified name."
 319        REFERENCE
 320                "RFC-1034 section 3.1."
 321        SYNTAX  OCTET STRING (SIZE (0..255))
 322
 323    DnsNameAsIndex ::= TEXTUAL-CONVENTION
 324        STATUS  current
 325        DESCRIPTION
 326                "This textual convention is like a DnsName, but is used
 327                as an index componant in tables.  Alphabetic characters
 328                in names of this type are restricted to uppercase: the
 329                characters 'a' through 'z' are mapped to the characters
 330                'A' through 'Z'.  This restriction is intended to make
 331                the lexical ordering imposed by SNMP useful when applied
 332                to DNS names.
 333
 334                Note that it is theoretically possible for a valid DNS
 335
 336
 337
 338 Austein & Saperia                                               [Page 6]
 339 \f
 340 RFC 1611               DNS Server MIB Extensions                May 1994
 341
 342
 343                name to exceed the allowed length of an SNMP object
 344                identifer, and thus be impossible to represent in tables
 345                in this MIB that are indexed by DNS name.  Sampling of
 346                DNS names in current use on the Internet suggests that
 347                this limit does not pose a serious problem in practice."
 348        REFERENCE
 349                "RFC-1034 section 3.1, RFC-1448 section 4.1."
 350        SYNTAX  DnsName
 351
 352    DnsClass ::= TEXTUAL-CONVENTION
 353        DISPLAY-HINT "2d"
 354        STATUS  current
 355        DESCRIPTION
 356                "This data type is used to represent the class values
 357                which appear in Resource Records in the DNS.  A 16-bit
 358                unsigned integer is used to allow room for new classes
 359                of records to be defined.  Existing standard classes are
 360                listed in the DNS specifications."
 361        REFERENCE
 362                "RFC-1035 section 3.2.4."
 363        SYNTAX  INTEGER (0..65535)
 364
 365    DnsType ::= TEXTUAL-CONVENTION
 366        DISPLAY-HINT "2d"
 367        STATUS  current
 368        DESCRIPTION
 369                "This data type is used to represent the type values
 370                which appear in Resource Records in the DNS.  A 16-bit
 371                unsigned integer is used to allow room for new record
 372                types to be defined.  Existing standard types are listed
 373                in the DNS specifications."
 374        REFERENCE
 375                "RFC-1035 section 3.2.2."
 376        SYNTAX  INTEGER (0..65535)
 377
 378    DnsQClass ::= TEXTUAL-CONVENTION
 379        DISPLAY-HINT "2d"
 380        STATUS  current
 381        DESCRIPTION
 382                "This data type is used to represent the QClass values
 383                which appear in Resource Records in the DNS.  A 16-bit
 384                unsigned integer is used to allow room for new QClass
 385                records to be defined.  Existing standard QClasses are
 386                listed in the DNS specification."
 387        REFERENCE
 388                "RFC-1035 section 3.2.5."
 389        SYNTAX  INTEGER (0..65535)
 390
 391
 392
 393
 394 Austein & Saperia                                               [Page 7]
 395 \f
 396 RFC 1611               DNS Server MIB Extensions                May 1994
 397
 398
 399    DnsQType ::= TEXTUAL-CONVENTION
 400        DISPLAY-HINT "2d"
 401        STATUS  current
 402        DESCRIPTION
 403                "This data type is used to represent the QType values
 404                which appear in Resource Records in the DNS.  A 16-bit
 405                unsigned integer is used to allow room for new QType
 406                records to be defined.  Existing standard QTypes are
 407                listed in the DNS specification."
 408        REFERENCE
 409                "RFC-1035 section 3.2.3."
 410        SYNTAX  INTEGER (0..65535)
 411
 412    DnsTime ::= TEXTUAL-CONVENTION
 413        DISPLAY-HINT "4d"
 414        STATUS  current
 415        DESCRIPTION
 416                "DnsTime values are 32-bit unsigned integers which
 417                measure time in seconds."
 418        REFERENCE
 419                "RFC-1035."
 420        SYNTAX  Gauge32
 421
 422
 423    DnsOpCode ::= TEXTUAL-CONVENTION
 424        STATUS  current
 425        DESCRIPTION
 426                "This textual convention is used to represent the DNS
 427                OPCODE values used in the header section of DNS
 428                messages.  Existing standard OPCODE values are listed in
 429                the DNS specifications."
 430        REFERENCE
 431                "RFC-1035 section 4.1.1."
 432        SYNTAX  INTEGER (0..15)
 433
 434    DnsRespCode ::= TEXTUAL-CONVENTION
 435        STATUS  current
 436        DESCRIPTION
 437                "This data type is used to represent the DNS RCODE value
 438                in DNS response messages.  Existing standard RCODE
 439                values are listed in the DNS specifications."
 440        REFERENCE
 441                "RFC-1035 section 4.1.1."
 442        SYNTAX  INTEGER (0..15)
 443
 444
 445
 446
 447
 448
 449
 450 Austein & Saperia                                               [Page 8]
 451 \f
 452 RFC 1611               DNS Server MIB Extensions                May 1994
 453
 454
 455    -- Server Configuration Group
 456
 457    dnsServConfigImplementIdent OBJECT-TYPE
 458        SYNTAX      DisplayString
 459        MAX-ACCESS  read-only
 460        STATUS      current
 461        DESCRIPTION
 462                "The implementation identification string for the DNS
 463                server software in use on the system, for example;
 464                `FNS-2.1'"
 465        ::= { dnsServConfig 1 }
 466
 467    dnsServConfigRecurs  OBJECT-TYPE
 468        SYNTAX      INTEGER { available(1),
 469                              restricted(2),
 470                              unavailable(3) }
 471        MAX-ACCESS  read-write
 472        STATUS      current
 473        DESCRIPTION
 474                "This represents the recursion services offered by this
 475                name server.  The values that can be read or written
 476                are:
 477
 478                available(1) - performs recursion on requests from
 479                clients.
 480
 481                restricted(2) - recursion is performed on requests only
 482                from certain clients, for example; clients on an access
 483                control list.
 484
 485                unavailable(3) - recursion is not available."
 486         ::= { dnsServConfig 2 }
 487
 488    dnsServConfigUpTime OBJECT-TYPE
 489        SYNTAX      DnsTime
 490        MAX-ACCESS  read-only
 491        STATUS      current
 492        DESCRIPTION
 493                "If the server has a persistent state (e.g., a process),
 494                this value will be the time elapsed since it started.
 495                For software without persistant state, this value will
 496                be zero."
 497        ::= { dnsServConfig 3 }
 498
 499    dnsServConfigResetTime OBJECT-TYPE
 500        SYNTAX      DnsTime
 501        MAX-ACCESS  read-only
 502        STATUS      current
 503
 504
 505
 506 Austein & Saperia                                               [Page 9]
 507 \f
 508 RFC 1611               DNS Server MIB Extensions                May 1994
 509
 510
 511        DESCRIPTION
 512                "If the server has a persistent state (e.g., a process)
 513                and supports a `reset' operation (e.g., can be told to
 514                re-read configuration files), this value will be the
 515                time elapsed since the last time the name server was
 516                `reset.'  For software that does not have persistence or
 517                does not support a `reset' operation, this value will be
 518                zero."
 519        ::= { dnsServConfig 4 }
 520
 521    dnsServConfigReset OBJECT-TYPE
 522        SYNTAX      INTEGER { other(1),
 523                              reset(2),
 524                              initializing(3),
 525                              running(4) }
 526        MAX-ACCESS  read-write
 527        STATUS      current
 528        DESCRIPTION
 529                "Status/action object to reinitialize any persistant name
 530                server state.  When set to reset(2), any persistant
 531                name server state (such as a process) is reinitialized as
 532                if the name server had just been started.  This value
 533                will never be returned by a read operation.  When read,
 534                one of the following values will be returned:
 535                    other(1) - server in some unknown state;
 536                    initializing(3) - server (re)initializing;
 537                    running(4) - server currently running."
 538        ::= { dnsServConfig 5 }
 539
 540
 541    -- Server Counter Group
 542
 543    dnsServCounterAuthAns OBJECT-TYPE
 544        SYNTAX      Counter32
 545        MAX-ACCESS  read-only
 546        STATUS      current
 547        DESCRIPTION
 548                "Number of queries which were authoritatively answered."
 549        ::= { dnsServCounter 2 }
 550
 551    dnsServCounterAuthNoNames OBJECT-TYPE
 552        SYNTAX      Counter32
 553        MAX-ACCESS  read-only
 554        STATUS      current
 555        DESCRIPTION
 556                "Number of queries for which `authoritative no such name'
 557                responses were made."
 558        ::= { dnsServCounter 3 }
 559
 560
 561
 562 Austein & Saperia                                              [Page 10]
 563 \f
 564 RFC 1611               DNS Server MIB Extensions                May 1994
 565
 566
 567    dnsServCounterAuthNoDataResps OBJECT-TYPE
 568        SYNTAX      Counter32
 569        MAX-ACCESS  read-only
 570        STATUS      current
 571        DESCRIPTION
 572                "Number of queries for which `authoritative no such data'
 573                (empty answer) responses were made."
 574        ::= { dnsServCounter 4 }
 575
 576    dnsServCounterNonAuthDatas OBJECT-TYPE
 577        SYNTAX      Counter32
 578        MAX-ACCESS  read-only
 579        STATUS      current
 580        DESCRIPTION
 581                "Number of queries which were non-authoritatively
 582                answered (cached data)."
 583        ::= { dnsServCounter 5 }
 584
 585    dnsServCounterNonAuthNoDatas OBJECT-TYPE
 586        SYNTAX      Counter32
 587        MAX-ACCESS  read-only
 588        STATUS      current
 589        DESCRIPTION
 590                "Number of queries which were non-authoritatively
 591                answered with no data (empty answer)."
 592        ::= { dnsServCounter 6 }
 593
 594    dnsServCounterReferrals OBJECT-TYPE
 595        SYNTAX      Counter32
 596        MAX-ACCESS  read-only
 597        STATUS      current
 598        DESCRIPTION
 599                "Number of requests that were referred to other servers."
 600        ::= { dnsServCounter 7 }
 601
 602    dnsServCounterErrors OBJECT-TYPE
 603        SYNTAX      Counter32
 604        MAX-ACCESS  read-only
 605        STATUS      current
 606        DESCRIPTION
 607                "Number of requests the server has processed that were
 608                answered with errors (RCODE values other than 0 and 3)."
 609        REFERENCE
 610                "RFC-1035 section 4.1.1."
 611        ::= { dnsServCounter 8 }
 612
 613    dnsServCounterRelNames OBJECT-TYPE
 614        SYNTAX      Counter32
 615
 616
 617
 618 Austein & Saperia                                              [Page 11]
 619 \f
 620 RFC 1611               DNS Server MIB Extensions                May 1994
 621
 622
 623        MAX-ACCESS  read-only
 624        STATUS      current
 625        DESCRIPTION
 626                "Number of requests received by the server for names that
 627                are only 1 label long (text form - no internal dots)."
 628        ::= { dnsServCounter 9 }
 629
 630    dnsServCounterReqRefusals OBJECT-TYPE
 631        SYNTAX      Counter32
 632        MAX-ACCESS  read-only
 633        STATUS      current
 634        DESCRIPTION
 635                "Number of DNS requests refused by the server."
 636        ::= { dnsServCounter 10 }
 637
 638    dnsServCounterReqUnparses OBJECT-TYPE
 639        SYNTAX      Counter32
 640        MAX-ACCESS  read-only
 641        STATUS      current
 642        DESCRIPTION
 643                "Number of requests received which were unparseable."
 644        ::= { dnsServCounter 11 }
 645
 646    dnsServCounterOtherErrors OBJECT-TYPE
 647        SYNTAX      Counter32
 648        MAX-ACCESS  read-only
 649        STATUS      current
 650        DESCRIPTION
 651                "Number of requests which were aborted for other (local)
 652                server errors."
 653        ::= { dnsServCounter 12 }
 654
 655    -- DNS Server Counter Table
 656
 657    dnsServCounterTable OBJECT-TYPE
 658        SYNTAX      SEQUENCE OF DnsServCounterEntry
 659        MAX-ACCESS  not-accessible
 660        STATUS      current
 661        DESCRIPTION
 662                "Counter information broken down by DNS class and type."
 663        ::= { dnsServCounter 13 }
 664
 665    dnsServCounterEntry OBJECT-TYPE
 666        SYNTAX      DnsServCounterEntry
 667        MAX-ACCESS  not-accessible
 668        STATUS      current
 669        DESCRIPTION
 670                "This table contains count information for each DNS class
 671
 672
 673
 674 Austein & Saperia                                              [Page 12]
 675 \f
 676 RFC 1611               DNS Server MIB Extensions                May 1994
 677
 678
 679                and type value known to the server.  The index allows
 680                management software to to create indices to the table to
 681                get the specific information desired, e.g., number of
 682                queries over UDP for records with type value `A' which
 683                came to this server.  In order to prevent an
 684                uncontrolled expansion of rows in the table; if
 685                dnsServCounterRequests is 0 and dnsServCounterResponses
 686                is 0, then the row does not exist and `no such' is
 687                returned when the agent is queried for such instances."
 688        INDEX     { dnsServCounterOpCode,
 689                    dnsServCounterQClass,
 690                    dnsServCounterQType,
 691                    dnsServCounterTransport }
 692        ::= { dnsServCounterTable 1 }
 693
 694    DnsServCounterEntry ::=
 695        SEQUENCE {
 696            dnsServCounterOpCode
 697                DnsOpCode,
 698            dnsServCounterQClass
 699                DnsClass,
 700            dnsServCounterQType
 701                DnsType,
 702            dnsServCounterTransport
 703                INTEGER,
 704            dnsServCounterRequests
 705                Counter32,
 706            dnsServCounterResponses
 707                Counter32
 708            }
 709
 710    dnsServCounterOpCode OBJECT-TYPE
 711        SYNTAX      DnsOpCode
 712        MAX-ACCESS  not-accessible
 713        STATUS      current
 714        DESCRIPTION
 715                "The DNS OPCODE being counted in this row of the table."
 716        ::= { dnsServCounterEntry 1 }
 717
 718    dnsServCounterQClass OBJECT-TYPE
 719        SYNTAX      DnsClass
 720        MAX-ACCESS  not-accessible
 721        STATUS      current
 722        DESCRIPTION
 723                "The class of record being counted in this row of the
 724                table."
 725        ::= { dnsServCounterEntry 2 }
 726
 727
 728
 729
 730 Austein & Saperia                                              [Page 13]
 731 \f
 732 RFC 1611               DNS Server MIB Extensions                May 1994
 733
 734
 735    dnsServCounterQType OBJECT-TYPE
 736        SYNTAX      DnsType
 737        MAX-ACCESS  not-accessible
 738        STATUS      current
 739        DESCRIPTION
 740                "The type of record which is being counted in this row in
 741                the table."
 742        ::= { dnsServCounterEntry 3 }
 743
 744    dnsServCounterTransport OBJECT-TYPE
 745        SYNTAX      INTEGER { udp(1), tcp(2), other(3) }
 746        MAX-ACCESS  not-accessible
 747        STATUS      current
 748        DESCRIPTION
 749                "A value of udp(1) indicates that the queries reported on
 750                this row were sent using UDP.
 751
 752                A value of tcp(2) indicates that the queries reported on
 753                this row were sent using TCP.
 754
 755                A value of other(3) indicates that the queries reported
 756                on this row were sent using a transport that was neither
 757                TCP nor UDP."
 758        ::= { dnsServCounterEntry 4 }
 759
 760    dnsServCounterRequests OBJECT-TYPE
 761        SYNTAX      Counter32
 762        MAX-ACCESS  read-only
 763        STATUS      current
 764        DESCRIPTION
 765                "Number of requests (queries) that have been recorded in
 766                this row of the table."
 767        ::= { dnsServCounterEntry 5 }
 768
 769    dnsServCounterResponses OBJECT-TYPE
 770        SYNTAX      Counter32
 771        MAX-ACCESS  read-only
 772        STATUS      current
 773        DESCRIPTION
 774                "Number of responses made by the server since
 775                initialization for the kind of query identified on this
 776                row of the table."
 777        ::= { dnsServCounterEntry 6 }
 778
 779
 780
 781
 782
 783
 784
 785
 786 Austein & Saperia                                              [Page 14]
 787 \f
 788 RFC 1611               DNS Server MIB Extensions                May 1994
 789
 790
 791    -- Server Optional Counter Group
 792
 793    -- The Server Optional Counter Group is intended for those systems
 794    -- which make distinctions between the different sources of the DNS
 795    -- queries as defined below.
 796    --
 797    -- Objects in this group are implemented on servers which distinguish
 798    -- between queries which originate from the same host as the server,
 799    -- queries from one of an arbitrary group of hosts that are on an
 800    -- access list defined by the server, and queries from hosts that do
 801    -- not fit either of these descriptions.
 802    --
 803    -- The objects found in the Server Counter group are totals.  Thus if
 804    -- one wanted to identify, for example, the number of queries from
 805    -- `remote' hosts which have been given authoritative answers, one
 806    -- would subtract the current values of ServOptCounterFriendsAuthAns
 807    -- and ServOptCounterSelfAuthAns from servCounterAuthAns.
 808    --
 809    -- The purpose of these distinctions is to allow for implementations
 810    -- to group queries and responses on this basis.  One way in which
 811    -- servers may make these distinctions is by looking at the source IP
 812    -- address of the DNS query.  If the source of the query is `your
 813    -- own' then the query should be counted as `yourself' (local host).
 814    -- If the source of the query matches an `access list,' the query
 815    -- came from a friend.  What constitutes an `access list' is
 816    -- implementation dependent and could be as simple as a rule that all
 817    -- hosts on the same IP network as the DNS server are classed
 818    -- `friends.'
 819    --
 820    -- In order to avoid double counting, the following rules apply:
 821    --
 822    -- 1. No host is in more than one of the three groups defined above.
 823    --
 824    -- 2. All queries from the local host are always counted in the
 825    --    `yourself' group regardless of what the access list, if any,
 826    --    says.
 827    --
 828    -- 3. The access list should not define `your friends' in such a way
 829    --    that it includes all hosts.   That is, not everybody is your
 830    --    `friend.'
 831
 832    dnsServOptCounterSelfAuthAns OBJECT-TYPE
 833        SYNTAX      Counter32
 834        MAX-ACCESS  read-only
 835        STATUS      current
 836        DESCRIPTION
 837                "Number of requests the server has processed which
 838                originated from a resolver on the same host for which
 839
 840
 841
 842 Austein & Saperia                                              [Page 15]
 843 \f
 844 RFC 1611               DNS Server MIB Extensions                May 1994
 845
 846
 847                there has been an authoritative answer."
 848        ::= { dnsServOptCounter 1 }
 849
 850    dnsServOptCounterSelfAuthNoNames OBJECT-TYPE
 851        SYNTAX      Counter32
 852        MAX-ACCESS  read-only
 853        STATUS      current
 854        DESCRIPTION
 855                "Number of requests the server has processed which
 856                originated from a resolver on the same host for which
 857                there has been an authoritative no such name answer
 858                given."
 859        ::= { dnsServOptCounter 2 }
 860
 861    dnsServOptCounterSelfAuthNoDataResps OBJECT-TYPE
 862        SYNTAX      Counter32
 863        MAX-ACCESS  read-only
 864        STATUS      current
 865        DESCRIPTION
 866                "Number of requests the server has processed which
 867                originated from a resolver on the same host for which
 868                there has been an authoritative no such data answer
 869                (empty answer) made."
 870        ::= { dnsServOptCounter 3 }
 871
 872    dnsServOptCounterSelfNonAuthDatas OBJECT-TYPE
 873        SYNTAX      Counter32
 874        MAX-ACCESS  read-only
 875        STATUS      current
 876        DESCRIPTION
 877                "Number of requests the server has processed which
 878                originated from a resolver on the same host for which a
 879                non-authoritative answer (cached data) was made."
 880        ::= { dnsServOptCounter 4 }
 881
 882    dnsServOptCounterSelfNonAuthNoDatas OBJECT-TYPE
 883        SYNTAX      Counter32
 884        MAX-ACCESS  read-only
 885        STATUS      current
 886        DESCRIPTION
 887                "Number of requests the server has processed which
 888                originated from a resolver on the same host for which a
 889                `non-authoritative, no such data' response was made
 890                (empty answer)."
 891        ::= { dnsServOptCounter 5 }
 892
 893    dnsServOptCounterSelfReferrals OBJECT-TYPE
 894        SYNTAX      Counter32
 895
 896
 897
 898 Austein & Saperia                                              [Page 16]
 899 \f
 900 RFC 1611               DNS Server MIB Extensions                May 1994
 901
 902
 903        MAX-ACCESS  read-only
 904        STATUS      current
 905        DESCRIPTION
 906                "Number of queries the server has processed which
 907                originated from a resolver on the same host and were
 908                referred to other servers."
 909        ::= { dnsServOptCounter 6 }
 910
 911    dnsServOptCounterSelfErrors OBJECT-TYPE
 912        SYNTAX      Counter32
 913        MAX-ACCESS  read-only
 914        STATUS      current
 915        DESCRIPTION
 916                "Number of requests the server has processed which
 917                originated from a resolver on the same host which have
 918                been answered with errors (RCODEs other than 0 and 3)."
 919        REFERENCE
 920                "RFC-1035 section 4.1.1."
 921        ::= { dnsServOptCounter 7 }
 922
 923    dnsServOptCounterSelfRelNames OBJECT-TYPE
 924        SYNTAX      Counter32
 925        MAX-ACCESS  read-only
 926        STATUS      current
 927        DESCRIPTION
 928                "Number of requests received for names that are only 1
 929                label long (text form - no internal dots) the server has
 930                processed which originated from a resolver on the same
 931                host."
 932        ::= { dnsServOptCounter 8 }
 933
 934    dnsServOptCounterSelfReqRefusals OBJECT-TYPE
 935        SYNTAX      Counter32
 936        MAX-ACCESS  read-only
 937        STATUS      current
 938        DESCRIPTION
 939                "Number of DNS requests refused by the server which
 940                originated from a resolver on the same host."
 941        ::= { dnsServOptCounter 9 }
 942
 943    dnsServOptCounterSelfReqUnparses OBJECT-TYPE
 944        SYNTAX      Counter32
 945        MAX-ACCESS  read-only
 946        STATUS      current
 947        DESCRIPTION
 948                "Number of requests received which were unparseable and
 949                which originated from a resolver on the same host."
 950        ::= { dnsServOptCounter 10 }
 951
 952
 953
 954 Austein & Saperia                                              [Page 17]
 955 \f
 956 RFC 1611               DNS Server MIB Extensions                May 1994
 957
 958
 959    dnsServOptCounterSelfOtherErrors OBJECT-TYPE
 960        SYNTAX      Counter32
 961        MAX-ACCESS  read-only
 962        STATUS      current
 963        DESCRIPTION
 964                "Number of requests which were aborted for other (local)
 965                server errors and which originated on the same host."
 966        ::= { dnsServOptCounter 11 }
 967
 968    dnsServOptCounterFriendsAuthAns OBJECT-TYPE
 969        SYNTAX      Counter32
 970        MAX-ACCESS  read-only
 971        STATUS      current
 972        DESCRIPTION
 973                "Number of queries originating from friends which were
 974                authoritatively answered.  The definition of friends is
 975                a locally defined matter."
 976        ::= { dnsServOptCounter 12 }
 977
 978    dnsServOptCounterFriendsAuthNoNames OBJECT-TYPE
 979        SYNTAX      Counter32
 980        MAX-ACCESS  read-only
 981        STATUS      current
 982        DESCRIPTION
 983                "Number of queries originating from friends, for which
 984                authoritative `no such name' responses were made.  The
 985                definition of friends is a locally defined matter."
 986        ::= { dnsServOptCounter 13 }
 987
 988    dnsServOptCounterFriendsAuthNoDataResps OBJECT-TYPE
 989        SYNTAX      Counter32
 990        MAX-ACCESS  read-only
 991        STATUS      current
 992        DESCRIPTION
 993                "Number of queries originating from friends for which
 994                authoritative no such data (empty answer) responses were
 995                made.  The definition of friends is a locally defined
 996                matter."
 997        ::= { dnsServOptCounter 14 }
 998
 999    dnsServOptCounterFriendsNonAuthDatas OBJECT-TYPE
1000        SYNTAX      Counter32
1001        MAX-ACCESS  read-only
1002        STATUS      current
1003        DESCRIPTION
1004                "Number of queries originating from friends which were
1005                non-authoritatively answered (cached data). The
1006                definition of friends is a locally defined matter."
1007
1008
1009
1010 Austein & Saperia                                              [Page 18]
1011 \f
1012 RFC 1611               DNS Server MIB Extensions                May 1994
1013
1014
1015        ::= { dnsServOptCounter 15 }
1016
1017    dnsServOptCounterFriendsNonAuthNoDatas OBJECT-TYPE
1018        SYNTAX      Counter32
1019        MAX-ACCESS  read-only
1020        STATUS      current
1021        DESCRIPTION
1022                "Number of queries originating from friends which were
1023                non-authoritatively answered with no such data (empty
1024                answer)."
1025        ::= { dnsServOptCounter 16 }
1026
1027    dnsServOptCounterFriendsReferrals OBJECT-TYPE
1028        SYNTAX      Counter32
1029        MAX-ACCESS  read-only
1030        STATUS      current
1031        DESCRIPTION
1032                "Number of requests which originated from friends that
1033                were referred to other servers.  The definition of
1034                friends is a locally defined matter."
1035        ::= { dnsServOptCounter 17 }
1036
1037    dnsServOptCounterFriendsErrors OBJECT-TYPE
1038        SYNTAX      Counter32
1039        MAX-ACCESS  read-only
1040        STATUS      current
1041        DESCRIPTION
1042                "Number of requests the server has processed which
1043                originated from friends and were answered with errors
1044                (RCODE values other than 0 and 3).  The definition of
1045                friends is a locally defined matter."
1046        REFERENCE
1047                "RFC-1035 section 4.1.1."
1048        ::= { dnsServOptCounter 18 }
1049
1050    dnsServOptCounterFriendsRelNames OBJECT-TYPE
1051        SYNTAX      Counter32
1052        MAX-ACCESS  read-only
1053        STATUS      current
1054        DESCRIPTION
1055                "Number of requests received for names from friends that
1056                are only 1 label long (text form - no internal dots) the
1057                server has processed."
1058        ::= { dnsServOptCounter 19 }
1059
1060    dnsServOptCounterFriendsReqRefusals OBJECT-TYPE
1061        SYNTAX      Counter32
1062        MAX-ACCESS  read-only
1063
1064
1065
1066 Austein & Saperia                                              [Page 19]
1067 \f
1068 RFC 1611               DNS Server MIB Extensions                May 1994
1069
1070
1071        STATUS      current
1072        DESCRIPTION
1073                "Number of DNS requests refused by the server which were
1074                received from `friends'."
1075        ::= { dnsServOptCounter 20 }
1076
1077    dnsServOptCounterFriendsReqUnparses OBJECT-TYPE
1078        SYNTAX      Counter32
1079        MAX-ACCESS  read-only
1080        STATUS      current
1081        DESCRIPTION
1082                "Number of requests received which were unparseable and
1083                which originated from `friends'."
1084        ::= { dnsServOptCounter 21 }
1085
1086    dnsServOptCounterFriendsOtherErrors OBJECT-TYPE
1087        SYNTAX      Counter32
1088        MAX-ACCESS  read-only
1089        STATUS      current
1090        DESCRIPTION
1091                "Number of requests which were aborted for other (local)
1092                server errors and which originated from `friends'."
1093        ::= { dnsServOptCounter 22 }
1094
1095
1096    -- Server Zone Group
1097
1098    -- DNS Management Zone Configuration Table
1099
1100    -- This table contains zone configuration information.
1101
1102    dnsServZoneTable OBJECT-TYPE
1103        SYNTAX      SEQUENCE OF DnsServZoneEntry
1104        MAX-ACCESS  not-accessible
1105        STATUS      current
1106        DESCRIPTION
1107                "Table of zones for which this name server provides
1108                information.  Each of the zones may be loaded from stable
1109                storage via an implementation-specific mechanism or may
1110                be obtained from another name server via a zone transfer.
1111
1112                If name server doesn't load any zones, this table is
1113                empty."
1114        ::= { dnsServZone 1 }
1115
1116    dnsServZoneEntry OBJECT-TYPE
1117        SYNTAX      DnsServZoneEntry
1118        MAX-ACCESS  not-accessible
1119
1120
1121
1122 Austein & Saperia                                              [Page 20]
1123 \f
1124 RFC 1611               DNS Server MIB Extensions                May 1994
1125
1126
1127        STATUS      current
1128        DESCRIPTION
1129                "An entry in the name server zone table.  New rows may be
1130                added either via SNMP or by the name server itself."
1131        INDEX     { dnsServZoneName,
1132                    dnsServZoneClass }
1133        ::= { dnsServZoneTable 1 }
1134
1135    DnsServZoneEntry ::=
1136        SEQUENCE {
1137            dnsServZoneName
1138                DnsNameAsIndex,
1139            dnsServZoneClass
1140                DnsClass,
1141            dnsServZoneLastReloadSuccess
1142                DnsTime,
1143            dnsServZoneLastReloadAttempt
1144                DnsTime,
1145            dnsServZoneLastSourceAttempt
1146                IpAddress,
1147            dnsServZoneStatus
1148                RowStatus,
1149            dnsServZoneSerial
1150                Counter32,
1151            dnsServZoneCurrent
1152                TruthValue,
1153            dnsServZoneLastSourceSuccess
1154                IpAddress
1155        }
1156
1157    dnsServZoneName OBJECT-TYPE
1158        SYNTAX      DnsNameAsIndex
1159        MAX-ACCESS  not-accessible
1160        STATUS      current
1161        DESCRIPTION
1162                "DNS name of the zone described by this row of the table.
1163                This is the owner name of the SOA RR that defines the
1164                top of the zone. This is name is in uppercase:
1165                characters 'a' through 'z' are mapped to 'A' through 'Z'
1166                in order to make the lexical ordering useful."
1167        ::= { dnsServZoneEntry 1 }
1168
1169    dnsServZoneClass OBJECT-TYPE
1170        SYNTAX      DnsClass
1171        MAX-ACCESS  not-accessible
1172        STATUS      current
1173        DESCRIPTION
1174                "DNS class of the RRs in this zone."
1175
1176
1177
1178 Austein & Saperia                                              [Page 21]
1179 \f
1180 RFC 1611               DNS Server MIB Extensions                May 1994
1181
1182
1183        ::= { dnsServZoneEntry 2 }
1184
1185    dnsServZoneLastReloadSuccess OBJECT-TYPE
1186        SYNTAX      DnsTime
1187        MAX-ACCESS  read-only
1188        STATUS      current
1189        DESCRIPTION
1190                "Elapsed time in seconds since last successful reload of
1191                this zone."
1192        ::= { dnsServZoneEntry 3 }
1193
1194    dnsServZoneLastReloadAttempt OBJECT-TYPE
1195        SYNTAX      DnsTime
1196        MAX-ACCESS  read-only
1197        STATUS      current
1198        DESCRIPTION
1199                "Elapsed time in seconds since last attempted reload of
1200                this zone."
1201        ::= { dnsServZoneEntry 4 }
1202
1203    dnsServZoneLastSourceAttempt OBJECT-TYPE
1204        SYNTAX      IpAddress
1205        MAX-ACCESS  read-only
1206        STATUS      current
1207        DESCRIPTION
1208                "IP address of host from which most recent zone transfer
1209                of this zone was attempted.  This value should match the
1210                value of dnsServZoneSourceSuccess if the attempt was
1211                succcessful.  If zone transfer has not been attempted
1212                within the memory of this name server, this value should
1213                be 0.0.0.0."
1214        ::= { dnsServZoneEntry 5 }
1215
1216    dnsServZoneStatus OBJECT-TYPE
1217        SYNTAX      RowStatus
1218        MAX-ACCESS  read-create
1219        STATUS      current
1220        DESCRIPTION
1221                "The status of the information represented in this row of
1222                the table."
1223        ::= { dnsServZoneEntry 6 }
1224
1225    dnsServZoneSerial OBJECT-TYPE
1226        SYNTAX      Counter32
1227        MAX-ACCESS  read-only
1228        STATUS      current
1229        DESCRIPTION
1230                "Zone serial number (from the SOA RR) of the zone
1231
1232
1233
1234 Austein & Saperia                                              [Page 22]
1235 \f
1236 RFC 1611               DNS Server MIB Extensions                May 1994
1237
1238
1239                represented by this row of the table.  If the zone has
1240                not been successfully loaded within the memory of this
1241                name server, the value of this variable is zero."
1242        ::= { dnsServZoneEntry 7 }
1243
1244    dnsServZoneCurrent OBJECT-TYPE
1245        SYNTAX      TruthValue
1246        MAX-ACCESS  read-only
1247        STATUS      current
1248        DESCRIPTION
1249                "Whether the server's copy of the zone represented by
1250                this row of the table is currently valid.  If the zone
1251                has never been successfully loaded or has expired since
1252                it was last succesfully loaded, this variable will have
1253                the value false(2), otherwise this variable will have
1254                the value true(1)."
1255        ::= { dnsServZoneEntry 8 }
1256
1257    dnsServZoneLastSourceSuccess OBJECT-TYPE
1258        SYNTAX      IpAddress
1259        MAX-ACCESS  read-only
1260        STATUS      current
1261        DESCRIPTION
1262                "IP address of host which was the source of the most
1263                recent successful zone transfer for this zone.  If
1264                unknown (e.g., zone has never been successfully
1265                transfered) or irrelevant (e.g., zone was loaded from
1266                stable storage), this value should be 0.0.0.0."
1267        ::= { dnsServZoneEntry 9 }
1268
1269    -- DNS Zone Source Table
1270
1271    dnsServZoneSrcTable OBJECT-TYPE
1272        SYNTAX      SEQUENCE OF DnsServZoneSrcEntry
1273        MAX-ACCESS  not-accessible
1274        STATUS      current
1275        DESCRIPTION
1276                "This table is a list of IP addresses from which the
1277                server will attempt to load zone information using DNS
1278                zone transfer operations.  A reload may occur due to SNMP
1279                operations that create a row in dnsServZoneTable or a
1280                SET to object dnsServZoneReload.  This table is only
1281                used when the zone is loaded via zone transfer."
1282        ::= { dnsServZone 2 }
1283
1284    dnsServZoneSrcEntry OBJECT-TYPE
1285        SYNTAX      DnsServZoneSrcEntry
1286        MAX-ACCESS  not-accessible
1287
1288
1289
1290 Austein & Saperia                                              [Page 23]
1291 \f
1292 RFC 1611               DNS Server MIB Extensions                May 1994
1293
1294
1295        STATUS      current
1296        DESCRIPTION
1297                "An entry in the name server zone source table."
1298        INDEX     { dnsServZoneSrcName,
1299                    dnsServZoneSrcClass,
1300                    dnsServZoneSrcAddr }
1301        ::= { dnsServZoneSrcTable 1 }
1302
1303    DnsServZoneSrcEntry ::=
1304        SEQUENCE {
1305            dnsServZoneSrcName
1306                DnsNameAsIndex,
1307            dnsServZoneSrcClass
1308                DnsClass,
1309            dnsServZoneSrcAddr
1310                IpAddress,
1311            dnsServZoneSrcStatus
1312                RowStatus
1313        }
1314
1315    dnsServZoneSrcName OBJECT-TYPE
1316        SYNTAX      DnsNameAsIndex
1317        MAX-ACCESS  not-accessible
1318        STATUS      current
1319        DESCRIPTION
1320                "DNS name of the zone to which this entry applies."
1321        ::= { dnsServZoneSrcEntry 1 }
1322
1323    dnsServZoneSrcClass OBJECT-TYPE
1324        SYNTAX      DnsClass
1325        MAX-ACCESS  not-accessible
1326        STATUS      current
1327        DESCRIPTION
1328                "DNS class of zone to which this entry applies."
1329        ::= { dnsServZoneSrcEntry 2 }
1330
1331    dnsServZoneSrcAddr OBJECT-TYPE
1332        SYNTAX      IpAddress
1333        MAX-ACCESS  not-accessible
1334        STATUS      current
1335        DESCRIPTION
1336                "IP address of name server host from which this zone
1337                might be obtainable."
1338        ::= { dnsServZoneSrcEntry 3 }
1339
1340    dnsServZoneSrcStatus OBJECT-TYPE
1341        SYNTAX      RowStatus
1342        MAX-ACCESS  read-create
1343
1344
1345
1346 Austein & Saperia                                              [Page 24]
1347 \f
1348 RFC 1611               DNS Server MIB Extensions                May 1994
1349
1350
1351        STATUS      current
1352        DESCRIPTION
1353                "The status of the information represented in this row of
1354                the table."
1355        ::= { dnsServZoneSrcEntry 4 }
1356
1357
1358    -- SNMPv2 groups.
1359
1360    dnsServMIBGroups        OBJECT IDENTIFIER ::= { dnsServMIB 2 }
1361
1362    dnsServConfigGroup OBJECT-GROUP
1363        OBJECTS   { dnsServConfigImplementIdent,
1364                    dnsServConfigRecurs,
1365                    dnsServConfigUpTime,
1366                    dnsServConfigResetTime,
1367                    dnsServConfigReset }
1368        STATUS      current
1369        DESCRIPTION
1370                "A collection of objects providing basic configuration
1371                control of a DNS name server."
1372        ::= { dnsServMIBGroups 1 }
1373
1374    dnsServCounterGroup OBJECT-GROUP
1375        OBJECTS   { dnsServCounterAuthAns,
1376                    dnsServCounterAuthNoNames,
1377                    dnsServCounterAuthNoDataResps,
1378                    dnsServCounterNonAuthDatas,
1379                    dnsServCounterNonAuthNoDatas,
1380                    dnsServCounterReferrals,
1381                    dnsServCounterErrors,
1382                    dnsServCounterRelNames,
1383                    dnsServCounterReqRefusals,
1384                    dnsServCounterReqUnparses,
1385                    dnsServCounterOtherErrors,
1386                    dnsServCounterOpCode,
1387                    dnsServCounterQClass,
1388                    dnsServCounterQType,
1389                    dnsServCounterTransport,
1390                    dnsServCounterRequests,
1391                    dnsServCounterResponses }
1392        STATUS      current
1393        DESCRIPTION
1394                "A collection of objects providing basic instrumentation
1395                of a DNS name server."
1396        ::= { dnsServMIBGroups 2 }
1397
1398
1399
1400
1401
1402 Austein & Saperia                                              [Page 25]
1403 \f
1404 RFC 1611               DNS Server MIB Extensions                May 1994
1405
1406
1407    dnsServOptCounterGroup OBJECT-GROUP
1408        OBJECTS   { dnsServOptCounterSelfAuthAns,
1409                    dnsServOptCounterSelfAuthNoNames,
1410                    dnsServOptCounterSelfAuthNoDataResps,
1411                    dnsServOptCounterSelfNonAuthDatas,
1412                    dnsServOptCounterSelfNonAuthNoDatas,
1413                    dnsServOptCounterSelfReferrals,
1414                    dnsServOptCounterSelfErrors,
1415                    dnsServOptCounterSelfRelNames,
1416                    dnsServOptCounterSelfReqRefusals,
1417                    dnsServOptCounterSelfReqUnparses,
1418                    dnsServOptCounterSelfOtherErrors,
1419                    dnsServOptCounterFriendsAuthAns,
1420                    dnsServOptCounterFriendsAuthNoNames,
1421                    dnsServOptCounterFriendsAuthNoDataResps,
1422                    dnsServOptCounterFriendsNonAuthDatas,
1423                    dnsServOptCounterFriendsNonAuthNoDatas,
1424                    dnsServOptCounterFriendsReferrals,
1425                    dnsServOptCounterFriendsErrors,
1426                    dnsServOptCounterFriendsRelNames,
1427                    dnsServOptCounterFriendsReqRefusals,
1428                    dnsServOptCounterFriendsReqUnparses,
1429                    dnsServOptCounterFriendsOtherErrors }
1430        STATUS      current
1431        DESCRIPTION
1432                "A collection of objects providing extended
1433                instrumentation of a DNS name server."
1434        ::= { dnsServMIBGroups 3 }
1435
1436    dnsServZoneGroup OBJECT-GROUP
1437        OBJECTS   { dnsServZoneName,
1438                    dnsServZoneClass,
1439                    dnsServZoneLastReloadSuccess,
1440                    dnsServZoneLastReloadAttempt,
1441                    dnsServZoneLastSourceAttempt,
1442                    dnsServZoneLastSourceSuccess,
1443                    dnsServZoneStatus,
1444                    dnsServZoneSerial,
1445                    dnsServZoneCurrent,
1446                    dnsServZoneSrcName,
1447                    dnsServZoneSrcClass,
1448                    dnsServZoneSrcAddr,
1449                    dnsServZoneSrcStatus }
1450        STATUS      current
1451        DESCRIPTION
1452                "A collection of objects providing configuration control
1453                of a DNS name server which loads authoritative zones."
1454        ::= { dnsServMIBGroups 4 }
1455
1456
1457
1458 Austein & Saperia                                              [Page 26]
1459 \f
1460 RFC 1611               DNS Server MIB Extensions                May 1994
1461
1462
1463    -- Compliances.
1464
1465    dnsServMIBCompliances OBJECT IDENTIFIER ::= { dnsServMIB 3 }
1466
1467    dnsServMIBCompliance MODULE-COMPLIANCE
1468        STATUS      current
1469        DESCRIPTION
1470                "The compliance statement for agents implementing the DNS
1471                name server MIB extensions."
1472        MODULE -- This MIB module
1473            MANDATORY-GROUPS { dnsServConfigGroup, dnsServCounterGroup }
1474            GROUP   dnsServOptCounterGroup
1475            DESCRIPTION
1476                "The server optional counter group is unconditionally
1477                optional."
1478            GROUP   dnsServZoneGroup
1479            DESCRIPTION
1480                "The server zone group is mandatory for any name server
1481                that acts as an authoritative server for any DNS zone."
1482            OBJECT  dnsServConfigRecurs
1483            MIN-ACCESS      read-only
1484            DESCRIPTION
1485                "This object need not be writable."
1486            OBJECT  dnsServConfigReset
1487            MIN-ACCESS      read-only
1488            DESCRIPTION
1489                "This object need not be writable."
1490        ::= { dnsServMIBCompliances 1 }
1491
1492    END
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514 Austein & Saperia                                              [Page 27]
1515 \f
1516 RFC 1611               DNS Server MIB Extensions                May 1994
1517
1518
1519 5.  Acknowledgements
1520
1521    This document is the result of work undertaken the by DNS working
1522    group.  The authors would particularly like to thank the following
1523    people for their contributions to this document: Philip Almquist,
1524    Frank Kastenholz (FTP Software), Joe Peck (DEC), Dave Perkins
1525    (SynOptics), Win Treese (DEC), and Mimi Zohar (IBM).
1526
1527 6.  References
1528
1529    [1] Mockapetris, P., "Domain Names -- Concepts and Facilities", STD
1530        13, RFC 1034, USC/Information Sciences Institute, November 1987.
1531
1532    [2] Mockapetris, P., "Domain Names -- Implementation and
1533        Specification", STD 13, RFC 1035, USC/Information Sciences
1534        Institute, November 1987.
1535
1536    [3] Braden, R., Editor, "Requirements for Internet Hosts --
1537        Application and Support, STD 3, RFC 1123, USC/Information
1538        Sciences Institute, October 1989.
1539
1540    [4] Rose, M., and K. McCloghrie, "Structure and Identification of
1541        Management Information for TCP/IP-based internets", STD 16, RFC
1542        1155, Performance Systems International, Hughes LAN Systems, May
1543        1990.
1544
1545    [5] McCloghrie, K., and M. Rose, "Management Information Base for
1546        Network Management of TCP/IP-based internets", RFC 1156, Hughes
1547        LAN Systems, Performance Systems International, May 1990.
1548
1549    [6] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
1550        Network Management Protocol", STD 15, RFC 1157, SNMP Research,
1551        Performance Systems International, Performance Systems
1552        International, MIT Laboratory for Computer Science, May 1990.
1553
1554    [7] Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
1555        STD 16, RFC 1212, Performance Systems International, Hughes LAN
1556        Systems, March 1991.
1557
1558    [8] McCloghrie, K., and M. Rose, Editors, "Management Information
1559        Base for Network Management of TCP/IP-based internets: MIB-II",
1560        STD 17, RFC 1213, Hughes LAN Systems, Performance Systems
1561        International, March 1991.
1562
1563    [9] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure
1564        of Management Information for version 2 of the Simple Network
1565        Management Protocol (SNMPv2)", RFC 1442, SNMP Research, Inc.,
1566        Hughes LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon
1567
1568
1569
1570 Austein & Saperia                                              [Page 28]
1571 \f
1572 RFC 1611               DNS Server MIB Extensions                May 1994
1573
1574
1575        University, April 1993.
1576
1577   [10] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Textual
1578        Conventions for version 2 of the the Simple Network Management
1579        Protocol (SNMPv2)", RFC 1443, SNMP Research, Inc., Hughes LAN
1580        Systems, Dover Beach Consulting, Inc., Carnegie Mellon
1581        University, April 1993.
1582
1583   [11] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
1584        "Conformance Statements for version 2 of the the Simple Network
1585        Management Protocol (SNMPv2)", RFC 1444, SNMP Research, Inc.,
1586        Hughes LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon
1587        University, April 1993.
1588
1589   [12] Galvin, J., and K. McCloghrie, "Administrative Model for version
1590        2 of the Simple Network Management Protocol (SNMPv2)", RFC 1445,
1591        Trusted Information Systems, Hughes LAN Systems, April 1993.
1592
1593   [13] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol
1594        Operations for version 2 of the Simple Network Management
1595        Protocol (SNMPv2)", RFC 1448, SNMP Research, Inc., Hughes LAN
1596        Systems, Dover Beach Consulting, Inc., Carnegie Mellon
1597        University, April 1993.
1598
1599   [14] "Information processing systems - Open Systems Interconnection -
1600        Specification of Abstract Syntax Notation One (ASN.1)",
1601        International Organization for Standardization, International
1602        Standard 8824, December 1987.
1603
1604 7.  Security Considerations
1605
1606    Security issues are not discussed in this memo.
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626 Austein & Saperia                                              [Page 29]
1627 \f
1628 RFC 1611               DNS Server MIB Extensions                May 1994
1629
1630
1631 8.  Authors' Addresses
1632
1633    Rob Austein
1634    Epilogue Technology Corporation
1635    268 Main Street, Suite 283
1636    North Reading, MA 01864
1637    USA
1638
1639    Phone: +1-617-245-0804
1640    Fax:   +1-617-245-8122
1641    EMail: sra@epilogue.com
1642
1643
1644    Jon Saperia
1645    Digital Equipment Corporation
1646    110 Spit Brook Road
1647    ZKO1-3/H18
1648    Nashua, NH 03062-2698
1649    USA
1650
1651    Phone: +1-603-881-0480
1652    Fax:   +1-603-881-0120
1653    EMail: saperia@zko.dec.com
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682 Austein & Saperia                                              [Page 30]
1683 \f