home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / rfc / 3 / rfc1611.txt < prev    next >
Encoding:
Text File  |  2003-06-11  |  57.3 KB  |  1,684 lines
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  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.  
  1684.