Internet Draft - DNS MIB - June 30, 1992 DNS MIB Extensions 30-June-1992 DNS Working Group Jon Saperia Digital Equipment Corporation saperia@tcpjon.ogo.dec.com Status of this Memo This document is an Internet Draft. Internet Drafts are working documents of the Internet Engineering Task Force (IETF), its Areas, and its Working Groups. Note that other groups may also distribute working documents as Internet Drafts). Internet Drafts are draft documents valid for a maximum of six months. Internet Drafts may be updated, replaced, or obsoleted by other documents at any time. It is not appropriate to use Internet Drafts as reference material or to cite them other than as a "working draft" or "work in progress." Please check the I-D abstract listing contained in each Internet Draft directory to learn the current status of this or any other Internet Draft. This draft document will be submitted to the RFC editor as a proposed extension to the SNMP MIB. Distribution of this document is unlimited. Please send comments or corrections to the editor. Abstract This memo defines a set of DNS (Domain Name System) exten- sions that have been created for the Internet MIB. When used in conjunction with the Structure of Management Information (RFC 1155), the Management Information Base for Network Management of TCP/IP-based internets (RFC 1213) and the Simple Network Management Protocol (RFC 1157), it will be possible to provide Internet Draft - DNS MIB - June 30, 1992 integrated network management of DNS client and server soft- ware in standard TCP/IP based environments. This document was produced by the DNS working group. Digital Equipment Corporation Maynard, Massachusetts ii Document Expiration Date - January 5, 1993 - Jon Saperia CONTENTS 1 Introduction......................................... 1 2 Selected Objects..................................... 1 3 Objects.............................................. 2 3.1 Format of Definitions............................. 3 3.2 Textual Conventions............................... 4 4 Object Definitions................................... 4 5 Acknowledgements..................................... 63 6 References........................................... 63 iii Internet Draft - DNS MIB - June 15, 1992 1 Introduction With the adoption of The Simple Network Management Protocol (RFC 1157), the Management Information Base for network management of TCP/IP-based internets (RFC 1213), and the Structure of Manage- ment Information (RFC 1155) by the Internet, and a large number of vendor implementations of these standards in commercially available products, it became possible to provide a higher level of effective network management in TCP/IP-based internets than previously available. With the growth in the use of these stan- dards, it has become possible to consider the management of other elements of the infrastructure beyond the basic TCP/IP protocols. A key element of the TCP/IP infrastructure is the DNS. Up to this point there has been no mechanism to integrate the management of the DNS with SNMP-based managers. This memo pro- vides the mechanisms by which IP-based management stations can effectively manage DNS client and server software in an inte- grated fashion through the use of the standard Internet SMI, MIB and Simple Network Management Protocol. New DNS objects have been defined to be used in conjunction with the Internet MIB to allow access and control of these new objects by the Internet community. 2 Selected Objects The objects included in this memo have been created from infor- mation contained in the relevant DNS related RFCs which include: Domain Administrators Guide (RFC 1032), Domain Administrators Operations Guide (RFC 1033) Domain Names - Concepts and Facili- ties (RFC 1034), Domain Names - Implementation and Specification (RFC 1035), and Requirements for Internet Hosts - Application and Support (RFC 1123). In addition, objects have been created Document Expiration Date - January 5, 1993 - Saperia 1 Internet Draft - DNS MIB - June 15, 1992 based on expected operational need and from the example of ex- isting DNS specific tools. These objects have be ordered into groups as follows: o General Configuration Group o Resolver Configuration Group o Server Configuration Group o Resolver Counters Group o Server Counters Group o Records Group o Resolver Cache Group o Resolver Negative Cache Group o Resolver Statistics Group o Server Management Group Many of the objects defined in this memo have been created from information contained in existing configuration files used by many DNS implementations. This information has been converted into a standard form using the Internet Standard SMI defined in RFC 1155. 3 Objects The objects in this memo are described using the standard Inter- net SMI and BER of RFC 1155. Each object description includes the objects name, its syntax and encoding. Just as with objects supported in the MIB (RFC 1156), an object name is identified with an object identifier which has been administratively as- signed. This identifies an Object Type. When an object type is combined with a specific instance - the particular object is uniquely identified. Use of Object Descriptors in this memo is consistent with that of RFC 1156 - meaning that they are 2 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 text strings meant to be read by humans. The descriptors have been created from a variety of sources. For the most part, the descriptions are influenced by by the DNS related RFCs noted above. For example, the descriptors for counters used for the various types of queries of DNS records are influenced by the definitions used for the various record types found in Domain Concepts and Facilities - RFC 1034. 3.1 Format of Definitions An object in this memo is specified by five fields of informa- tion: Object, Syntax, Definition, Access, and Status. The OBJECT is a textual name (OBJECT DESCRIPTOR) for that ob- ject type combined with an administratively obtained OBJECT IDENTIFIER. SYNTAX : For each object type, its abstract syntax is presented using the ASN.1 specified in RFC 1155. DEFINITION: A general description of the object type. ACCESS : The standard access keywords supported in RFC 1156 are used. The keywords used in this MIB are: read-only, read-write, and, not-accessible. STATUS : The status field is used to describe with a single keyword whether the object type is mandatory or optional. Status keywords of obsolete and deprecated are not used in this memo since this is the first version of the DNS MIB. Document Expiration Date - January 5, 1993 - Saperia 3 Internet Draft - DNS MIB - June 15, 1992 3.2 Textual Conventions Several datatypes have been introduced as a textual conven- tions in this DNS MIB document. These additions will facilitate the common understanding of information used by the DNS. No changes to the SMI or the SNMP are necessary to support these conventions which are described in 4.0 (Object Definitions). 4 Object Definitions RFCxxxx-dnsMIB DEFINITIONS ::= BEGIN IMPORTS mgmt, OBJECT-TYPE, NetworkAddress, IpAddress, Counter, Gauge, TimeTicks FROM RFC1155-SMI DisplayString FROM RFC1213; -- DNS MIB dns OBJECT IDENTIFIER ::= { experimental xx } -- textual conventions DnsDate ::= DisplayString -- This data type is intended to provide a consistent -- method of reporting date information. The first four -- octets represent the year, the next two month of the year -- expressed numerically, the next four octets represent the day -- followed by hour of the day using a 24 hour clock followed by a -- decimal point. The next two octets represent tenths and -- hundreths of a second. The final 5 octets provide a mechanism -- to relate the host's time to Coordinated Universal Time. Tuesday -- May 26, 1992 at 1:30 PM EDT would be represented as: -- 199205261330.00-500. 4 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 DnsName ::= OCTET STRING -- A DNS name is a sequence of octets with internal length encoding. -- While it is often the case that the printed form of a DNS name is -- a dotted-format Internet hostname, this is not always the case. -- All occurrences of DNS names in this MIB us the internal format -- used by the DNS protocols embedded within an OCTET STRING. DnsClass ::= INTEGER (0..65535) -- This data type is used to represent the class values which appear -- in Resource Records in the DNS. A 16-bit unsigned integer is -- used to allow room for new types of Class records to be defined. -- Existing classes are listed in RFC 1035. DnsType ::= INTEGER (0..65535) -- This data type is used to represent the type values which appear -- in Resource Records in the DNS. A 16-bit unsigned integer is -- used to allow room for new record types to be defined. -- Existing types are listed in RFC 1035. DnsQClass ::= INTEGER (0..65535) -- This data type is used to represent the QClass values which appear -- in Resource Records in the DNS. A 16-bit unsigned integer is -- used to allow room for new types of QClass records to be defined. -- Existing Q classes are listed in RFC 1035. DnsQType ::= INTEGER (0..65535) -- This data type is used to represent the QType values which appear -- in Resource Records in the DNS. A 16-bit unsigned integer is -- used to allow room for new record types to be defined. -- Existing QTypes are listed in RFC 1035. DnsTime ::= INTEGER -- DnsTime values are 32-bit unsigned integers which measure time in -- seconds. DnsValid ::= INTEGER { valid (1), clear (2) } -- Many of the tables in this MIB have as one of their columns, an -- object which can be set to a value of 2 to delete that -- row of the table. If a read operation is performed on this -- object, a value of 1 is returned to indicate a valid row in the -- table. Document Expiration Date - January 5, 1993 - Saperia 5 Internet Draft - DNS MIB - June 15, 1992 -- groups in the dns mib dnsGenConfig OBJECT IDENTIFIER ::= { dns 1 } dnsResConfig OBJECT IDENTIFIER ::= { dns 2 } dnsServerConfig OBJECT IDENTIFIER ::= { dns 3 } dnsResCounters OBJECT IDENTIFIER ::= { dns 4 } dnsServerCounters OBJECT IDENTIFIER ::= { dns 5 } dnsRecords OBJECT IDENTIFIER ::= { dns 6 } dnsResCache OBJECT IDENTIFIER ::= { dns 7 } dnsResNCache OBJECT IDENTIFIER ::= { dns 8 } dnsResStats OBJECT IDENTIFIER ::= { dns 9 } dnsServerManagement OBJECT IDENTIFIER ::= { dns 10 } -- General Configuration Group -- The implementation of the General Configuration group is -- mandatory for all systems. dnsGenConfigDnsUse OBJECT-TYPE SYNTAX INTEGER { primary (1), not_primary (2), not_used (3) } ACCESS read-write STATUS mandatory DESCRIPTION "A value of 1 indicates that the DNS is used as the primary mechanism for name resolution on this system. A 2 indicates that some other mechanism is used as the primary mechanism for name resolution and that the DNS is used as a back-up. A value of 3 indicates that DNS is not used for name resolution." ::= { dnsGenConfig 1 } 6 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 -- Resolver Configuration Group -- The implementation of the Resolver Configuration group is -- mandatory for all systems which implement any resolver software -- functions. dnsResConfigId OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "Name and version identification of DNS resolver software " ::= { dnsResConfig 1 } dnsResConfigService OBJECT-TYPE SYNTAX INTEGER { recursive-only (1), iterative-only (2), recursive-and-iterative (3) } ACCESS read-only STATUS mandatory DESCRIPTION "Kind of DNS resolution service provided. RECURSIVE-ONLY is a stub resolver. ITERATIVE-ONLY is a normal full service resolver. RECURSIVE-AND-ITERATIVE is a full service resolver which performs a mix of recursive and iterative queries." ::= { dnsResConfig 2 } dnsResConfigMaxCnames OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "Limit on how many CNAMEs the resolver should allow before deciding that there's a CNAME loop. Zero means that resolver has no explicit CNAME limit." ::= { dnsResConfig 3 } Document Expiration Date - January 5, 1993 - Saperia 7 Internet Draft - DNS MIB - June 15, 1992 dnsResConfigSeatBeltTable OBJECT-TYPE SYNTAX SEQUENCE OF DnsResSeatBeltEntry ACCESS read-write STATUS mandatory DESCRIPTION "Table of safety belt information used by the resolver when it hasn't got any better idea of where to send a query, such as when the resolver is booting." ::= { dnsResConfig 4 } dnsResSealtBeltEntry OBJECT-TYPE SYNTAX DnsResSeatBeltEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry in the resolver's seatbelt table." INDEX { dnsResSeatBeltAddr, dnsResSeatBeltSubTree, dnsResSeatBeltClass } ::= { dnsResSeatBeltTable 1 } DnsResSeatBeltEntry ::= SEQUENCE { dnsResSeatBeltAddr IpAddress, dnsResSeatBeltName DnsName, dnsResSeatBeltTOS INTEGER, dnsResSeatBeltPref INTEGER, dnsResSeatBeltSubTree DnsName, dnsResSeatBeltClass DnsClass, dnsResSeatBeltFile OCTET STRING, dnsResSeatBeltDate DnsDate, 8 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsResSeatBeltValid DnsValid } dnsResSeatBeltAddr OBJECT-TYPE SYNTAX IpAddress ACCESS read-only STATUS mandatory DESCRIPTION "IP address of a SeatBelt name server." ::= { dnsResSeatBeltEntry 1 } dnsResSeatBeltName OBJECT-TYPE SYNTAX DnsName -- OCTET STRING ACCESS read-only STATUS mandatory DESCRIPTION "DNS name of a SeatBelt nameserver, if known, otherwise it is null." ::= { dnsResSeatBeltEntry 2 } dnsResSeatBeltTOS OBJECT-TYPE SYNTAX INTEGER { iterative (1), recursive (2) } ACCESS read-only STATUS mandatory DESCRIPTION "Type-Of-Service resolver expects from seatbelt nameserver. ITERATIVE indicates that resolver will be directing iterative queries to this name server (RD bit turned off), while RECURSIVE indicates that resolver will be directing recursive queries to this name server (RD bit turned on)." ::= { dnsResSeatBeltEntry 3 } Document Expiration Date - January 5, 1993 - Saperia 9 Internet Draft - DNS MIB - June 15, 1992 dnsResSeatBeltPref OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "This value identifies the preference for the server identified in this row of the table. The lower the value, the higher the preference for the particular server." ::= { dnsResSeatBeltEntry 4 } dnsResSeatBeltSubTree OBJECT-TYPE SYNTAX DnsName -- OCTET STRING ACCESS read-only STATUS mandatory DESCRIPTION "The DNS sub tree name for queries sent to the name server identified by dnsResSeatBeltName." ::= { dnsResSeatBeltEntry 5 } dnsResSeatBeltClass OBJECT-TYPE SYNTAX DnsClass -- INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The class of DNS queries that will be sent to the server identified by dnsResSeatBeltName." ::= { dnsResSeatBeltEntry 6 } dnsResSeatBeltFile OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "The name of the source file which contains information read by the resolver at initialization." ::= { dnsResSeatBeltEntry 7 } 10 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsResSeatBeltDate OBJECT-TYPE SYNTAX DnsDate -- DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "This is the date information found in dnsResSeatBeltFile was last changed." ::= { dnsResSeatBeltEntry 8 } dnsResSeatBeltValid OBJECT-TYPE SYNTAX DnsValid { valid (1), clear (2) } ACCESS read-write STATUS mandatory DESCRIPTION "Setting this variable to CLEAR deletes this SeatBelt server." ::= { dnsResSeatBeltEntry 9 } -- Server Configuration Group -- The implementation of the Server Configuration Group is -- mandatory for all systems which implement DNS server software -- functions. dnsServerImplementIdent OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "The implementation identification string for the DNS software in use on the system, for example; FNS2.1" ::= { dnsServerConfig 1 } Document Expiration Date - January 5, 1993 - Saperia 11 Internet Draft - DNS MIB - June 15, 1992 dnsServerConfigRecurs OBJECT-TYPE SYNTAX INTEGER { available (1), restricted (2), unavailable (3) } ACCESS read-write STATUS mandatory DESCRIPTION "This represents the recursion status of requests made to this server. The possible values are: available - performs recursion on requests from clients. Restricted - recursion is performed on requests from clients which are on an access control list. Unavailable - recursion is not available." ::= { dnsServerConfig 2 } -- Resolver Counters Group -- The implementation of the Resolver Counters Group is mandatory for -- all systems which implement resolver functions dnsResCounterUpTime OBJECT-TYPE SYNTAX DnsTime ACCESS read-only STATUS mandatory DESCRIPTION "If the resolver has a persistent state, e.g., a process; this value will be the time elapsed since it started. For software that does not have persistence, this value will be 0." ::= { dnsResCounter 1 } 12 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsResCounterResetTime OBJECT-TYPE SYNTAX DnsTime ACCESS read-only STATUS mandatory DESCRIPTION "Elapsed time since cache was reloaded." ::= { dnsResCounter 2 } dnsResCounterUPktsIn OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of UDP packets received by the resolver process(s)." ::= { dnsResCounter 3 } dnsResCounterUPktsOut OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of UDP packets sent by the resolver process(s)." ::= { dnsResCounter 4 } dnsResCounterTCPInitiated OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of attempts to initiate TCP connections with servers." ::= { dnsResCounter 5 } Document Expiration Date - January 5, 1993 - Saperia 13 Internet Draft - DNS MIB - June 15, 1992 dnsResCounterTCPMesgsIn OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of received DNS messages over TCP by the resolver process." ::= { dnsResCounter 6 } dnsResCounterTCPMesgsOut OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of out bound DNS messages sent over TCP by the resolver." ::= { dnsResCounter 7 } dnsResCounterTable OBJECT-TYPE SYNTAX SEQUENCE OF DnsResCounterTableEntry ACCESS read-write STATUS mandatory DESCRIPTION "Table of the current count of resolver queries and answers." ::= { dnsResCounter 8 } dnsResCounterTableEntry OBJECT-TYPE SYNTAX DnsResCounterTableEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Entry in the resolver counter table. Entries are indexed by dns opcode." INDEX { dnsResCounterOpCode } ::= { dnsResCounterTable 1 } 14 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 DnsResCounterTableEntry ::= SEQUENCE { dnsResCounterOpCode INTEGER, dnsResCounterQueries Counter, dnsResCounterResponses Counter } dnsResCounterOpCode OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The index to this table. The opcodes that have already been defined are found in RFC1035." ::= { dnsResCounterTableEntry 1 } dnsResCounterQueries SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The total number of queries that have sent out by the resolver since initialization for the opcode which is index to this row of the table." ::= { dnsResCounterTableEntry 2 } dnsResCounterResponses SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The total number of responses that have been received by the resolver since initialization for the opcode which is the index to this row of the table." ::= { dnsResCounterTableEntry 3 } -- Additional DNS Resolver Counter Objects Document Expiration Date - January 5, 1993 - Saperia 15 Internet Draft - DNS MIB - June 15, 1992 dnsResCounterNonAuthData OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests made by the resolver for which a non-authoritative answer (cached data) was made by the local server." ::= { dnsResCounter 9 } dnsResCounterNonAuthNoData OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests made by the resolver for which a non-authoritative answer - no such data response was made (empty answer) by the local server." ::= { dnsResCounter 10 } dnsResCounterMartians OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of responses received which were received from servers that the resolver does not think it asked." ::= { dnsResCounter 11 } dnsResCounterResponsesRecd OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of responses received to all queries." ::= { dnsResCounter 12 } 16 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsResCounterDuplicates OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of responses received which were duplicates and ignored by the resolver." ::= { dnsResCounter 13 } dnsResCounterUnparse OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of responses received which were unparseable." ::= { dnsResCounter 14 } dnsResCounterServerFail OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of responses received which were server failed responses." ::= { dnsResCounter 15 } dnsResCounterOtherFail OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of responses received which where for all other bad responses." ::= { dnsResCounter 16 } Document Expiration Date - January 5, 1993 - Saperia 17 Internet Draft - DNS MIB - June 15, 1992 dnsResCounterTCPAttempts OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of attempts over TCP made by the resolver to connect with root servers." ::= { dnsResCounter 17 } dnsResCounterUDPAttempts OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of out bound UDP packets sent by the resolver resolver to root servers." ::= { dnsResCounter 18 } dnsResCounterNoLocalData OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries that have been sent because they could not be answered with local information by the resolver." ::= { dnsResCounter 19 } dnsResCounterReferals OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of responses which were received from servers redirecting query to another server." ::= { dnsResCounter 20 } 18 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsResCounterRetrans OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number requests retransmitted for all reasons." ::= { dnsResCounter 21 } dnsResCounterNoResponse OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries that were retransmitted because of no response." ::= { dnsResCounter 22 } dnsResCounterRootRetrans OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries that were retransmitted that were to root servers." ::= { dnsResCounter 23 } dnsResCounterLateRetrans OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries that were retransmitted as a result of late responses." ::= { dnsResCounter 24 } Document Expiration Date - January 5, 1993 - Saperia 19 Internet Draft - DNS MIB - June 15, 1992 dnsReSCounterLocalTrunc OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of truncated responses due to local truncation for forwarded queries." ::= { dnsResCounter 25 } dnsResSCounterTruncRemote OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of truncated responses from remote servers for forwarded queries." ::= { dnsResCounter 26 } dnsResCounterInternal OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests internally generated by the resolver." ::= { dnsResCounter 27 } dnsResCounterInternalTimeOut OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests internally generated which timed out." ::= { dnsResCounter 28 } 20 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 -- Server Counter Group -- The implementation of the Server Counter Group is mandatory for -- all systems which offer either recursive or non recursive server -- software functions. -- Several of the objects in this group make distinctions between -- queries which originate with the local host, within the same -- zone as the local host or come from outside the zone of the -- server. The purpose of these distinctions is to allow for -- implementations to group queries and responses on this basis. -- One way in which servers may make these distinctions is by -- looking at the source IP address of the DNS query. If the -- source of the query is 'your own' then the query should be -- counted as 'yourself' - local host. If the source of the query -- matches an 'access list' - the the query came from a friend, -- that is; within the local zone. What constitutes an 'access -- list' is implementation dependent and could be as simple as all -- hosts on the same IP network as the DNS server are classed as in -- the local zone and are 'friends'. In order to avoid double -- counting, the following rules apply: -- 1. No host is in more than one of the three groups defined above. -- 2. All queries from the local host are always counted in the -- 'yourself' group regardless of what the access list, if any, -- says. -- 3. The access list should not define 'your friends' in such a way -- that it includes all hosts, that is 'not everybody is your -- friend'. Document Expiration Date - January 5, 1993 - Saperia 21 Internet Draft - DNS MIB - June 15, 1992 dnsServCounterUTime OBJECT-TYPE SYNTAX DnsTime ACCESS read-only STATUS mandatory DESCRIPTION "If the server has a persistent state, e.g., a process; this value will be the time elapsed since it started. For software that does not have persistence, this value will be 0." " ::= { dnsServCounter 1 } dnsServCounterResetTime OBJECT-TYPE SYNTAX DnsTime ACCESS read-only STATUS mandatory DESCRIPTION "Elapsed time since cache was last reloaded for any reason." ::= { dnsServCounter 2 } dnsServCounterUPktsIn OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of UDP packets received by the server process(s)." ::= { dnsServCounter 3 } dnsServCounterUPktsOut OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of UDP packets sent by the server process(s)." ::= { dnsServCounter 4 } 22 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsServCounterTCPConns OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of TCP connections received by the server processes(s)." ::= { dnsServCounter 5 } dnsServCounterTCPInitiated OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of attempt to initiate TCP connections with other servers." ::= { dnsServCounter 6 } dnsServCounterTCPMesgsIn OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of received DNS messages over TCP by the server process." ::= { dnsServCounter 7 } dnsServCounterTCPMesgsOut OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of out bound DNS messages over TCP sent by the server." ::= { dnsServCounter 8 } Document Expiration Date - January 5, 1993 - Saperia 23 Internet Draft - DNS MIB - June 15, 1992 dnsServCounterOpCodeTable OBJECT-TYPE SYNTAX SEQUENCE OF DnsServCounterOpCodeTableEntry ACCESS read-write STATUS mandatory DESCRIPTION "Table of the current count of queries answered by the server." ::= { dnsServCounter 9 } dnsServCounterOpCodeTableEntry OBJECT-TYPE SYNTAX DnsServCounterOpCodeTableEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Entry in the server counter OpCode table. Entries are indexed by dns opcode." INDEX { dnsServCounterOpCode } ::= { dnsServCounterOpCodeTable 1 } DnsServCounterOpCodeTableEntry ::= SEQUENCE { dnsServCounterOpCode INTEGER, dnsServCounterQueries Counter, dnsServCounterResponses Counter } dnsServCounterOpCode OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The index to this table. Opcodes that have already been defined are found in RFC1035." ::= { dnsServCounterOpCodeTableEntry 1 } 24 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsServCounterQueries OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries that have been received since initialization for the type of query identified on this row of the table." ::= { dnsServCounterOpCodeTableEntry 2 } dnsServCounterResponses OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of responses made by the server since initialization for the type of query identified on this row of the table." ::= { dnsServCounterOpCodeTableEntry 3 } -- Additional DNS Server Counter Objects dnsServCounterSelfAuth OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests the server has processed with authoritative data which originated from a resolver on the same host." ::= { dnsServCounter 10 } Document Expiration Date - January 5, 1993 - Saperia 25 Internet Draft - DNS MIB - June 15, 1992 dnsServCounterSelfAuthNoName OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests the server has processed which originated from a resolver on the same host for which there has been an authoritative no such name answer (NXDOMAIN) given." ::= { dnsServCounter 11 } dnsServCounterSelfAuthNoData OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests the server has processed which originated from a resolver on the same host for which there has been an authoritative no such data answer (empty answer) made." ::= { dnsServCounter 12 } dnsServCounterSelfNonAuthData OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests the server has processed which originated from a resolver on the same host for which a non-authoritative answer (cached data) was made." ::= { dnsServCounter 13 } 26 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsServCounterSelfNonAuthNoData OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests the server has processed which originated from a resolver on the same host for which a non-authoritative answer - no such data response was made (empty answer)." ::= { dnsServCounter 14 } dnsServCounterSelfCAny OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests the server has processed which originated from a resolver on the same host which were answers to C_ANY queries." ::= { dnsServCounter 15 } dnsServCounterSelfIAns OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of inverse queries the server has processed which originated from a resolver on the same host which were answered with local information." ::= { dnsServCounter 16 } Document Expiration Date - January 5, 1993 - Saperia 27 Internet Draft - DNS MIB - June 15, 1992 dnsServCounterSelfNonRecurs OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of non recursive queries the server has processed which originated from a resolver on the same host and were referred to other servers." ::= { dnsServCounter 17 } dnsServCounterSelfErrors OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests the server has processed which originated from a resolver on the same host which have been answered with error responses (e.g., malformed query)." ::= { dnsServCounter 18 } dnsServCounterSelfRelNames OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests received for relative names the server has processed which originated from a resolver on the same host." ::= { dnsServCounter 19 } 28 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsServCounterFriendsAuth OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries originating from friends which were authoritatively answered. The definition of friends is a locally defined matter." ::= { dnsServCounter 20 } dnsServCounterFriendsNoSuch OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries originating from friends, for which authoritative no such name (NXDOMAIN) responses were made. The definition of friends is a locally defined matter." ::= { dnsServCounter 21 } dnsServCounterFriendsZoneNoData OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries originating from friends for which authoritative no such data (empty answer) responses were made. The definition of friends is a locally defined matter." ::= { dnsServCounter 22 } Document Expiration Date - January 5, 1993 - Saperia 29 Internet Draft - DNS MIB - June 15, 1992 dnsServCounterFriendsCached OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries originating from friends which were non-authoritatively answered (cached data). The definition of friends is a locally defined matter." ::= { dnsServCounter 23 } dnsServCounterFriendsCachedNoSuch OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries originating from friends for were non-authoritatively answered with no such data (empty answer)." ::= { dnsServCounter 24 } dnsServCounterFriendsCAny OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of answers to C_ANY queries which originated from friends. The definition of friends is a locally defined matter." ::= { dnsServCounter 25 } dnsServCounterFriendsInverse OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of answers to inverse queries which originated from friends. The definition of friends is a locally defined matter." ::= { dnsServCounter 26 } 30 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsServCounterFriendsForwards OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests which originated from friends that were forwarded to other servers. The definition of friends is a locally defined matter." ::= { dnsServCounter 27 } dnsServCounterFriendsRecurs OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of non recursive queries which originated from friends which have been referred to other servers. The definition of friends is a locally defined matter." ::= { dnsServCounter 28 } dnsServCounterFriendsErrors OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries which originated from friends which were answered with error responses. The definition of friends is a locally defined matter." ::= { dnsServCounter 29 } dnsServCounterFriendsRel OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests received for relative names from friends." ::= { dnsServCounter 30 } Document Expiration Date - January 5, 1993 - Saperia 31 Internet Draft - DNS MIB - June 15, 1992 dnsServCounterRemoteAuth OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries originating from systems which have not been defined as friends, which were authoritatively answered." ::= { dnsServCounter 31 } dnsServCounterRemoteNoSuch OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries originating from systems which have not been defined as friends, for which authoritative no such name (NXDOMAIN) responses were made." ::= { dnsServCounter 32 } dnsServCounterRemoteNoData OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries originating from systems which have not been defined as friends, for which authoritative no such data (empty answer) responses were made." ::= { dnsServCounter 33 } 32 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsServCounterRemoteCached OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries originating from systems which have not been defined as friends, which were non-authoritatively answered (cached data)." ::= { dnsServCounter 34 } dnsServCounterRemoteCachedNoSuch OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries originating from systems which have not been defined as friends, which were non-authoritatively answered with no such data (empty answer)." ::= { dnsServCounter 35 } dnsServCounterRemoteAny OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of answers to C_ANY queries which originated from systems which have not been defined as friends." ::= { dnsServCounter 36 } dnsServCounterRemoteInverse OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of answers to inverse queries which originated from systems which have not been defined as friends." ::= { dnsServCounter 37 } Document Expiration Date - January 5, 1993 - Saperia 33 Internet Draft - DNS MIB - June 15, 1992 dnsServCounterRemoteForwards OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests which originated from systems which have not been defined as friends that were forwarded to other servers." ::= { dnsServCounter 38 } dnsServCounterRemoteRecurs OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of non recursive queries which originated from systems which have not been defined as friends that have been referred other servers." ::= { dnsServCounter 39 } dnsServCounterRemoteErrors OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries which originated from systems which have not been defined as friends that were answered with error responses." ::= { dnsServCounter 40 } dnsServCounterReqRef OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of DNS requests refused by the local server process." ::= { dnsServCounter 41 } 34 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsServCounterReqUnparse OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests received which were unparseable." ::= { dnsServCounter 42 } dnsServCounterLocalErrors OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests which were aborted for other (local) server errors." ::= { dnsServCounter 43 } dnsServCounterDuplicates OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of duplicate requests which were received and not forwarded." ::= { dnsServCounter 44 } dnsServCounterTruncLocal OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of truncated responses due to local truncation for local queries." ::= { dnsServCounter 45 } Document Expiration Date - January 5, 1993 - Saperia 35 Internet Draft - DNS MIB - June 15, 1992 dnsServCounterRelRemote OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of requests received for relative names form hosts outside of the server zone." ::= { dnsServCounter 46 } -- DNS Server Counter Table dnsCounterTable OBJECT-TYPE SYNTAX SEQUENCE OF DnsCounterEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Counter information based on DNS class and record type." ::= { dnsServCounter 47 } dnsServCounterEntry OBJECT-TYPE SYNTAX dnsServCounterEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This table contains count information for each DNS record and class type known to the server. The index allows management software to to create indices to the table to get the specific information desired, e.g., number or A record queries over UDP which came to this server from a specific IP address." INDEX { dnsServCounterClass, dnsServCounterQueryType, dnsServCounterQuerySource, dnsServCounterTransport } ::= { dnsServCounterTable 1 } 36 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 DnsServCounterEntry ::= SEQUENCE { dnsServCounterClass DnsClass, dnsServCounterQueryType DnsType, dnsServCounterQuerySource INTEGER, dnsServCounterTransport INTEGER, dnsServCounterNumber Counter } dnsServCounterClass OBJECT-TYPE SYNTAX DnsClass -- INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The class of the record type being counted in this row the table. For classes defined in RFC 1035, the values are the same. ::= { dnsServCounterEntry 1 } dnsServCounterQueryType OBJECT-TYPE SYNTAX DnsType -- INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The type of record which is being counted in this row in the table. For types defined in RFC 1035, the values are the same as those specified in the RFC." ::= { dnsServCounterEntry 2 } Document Expiration Date - January 5, 1993 - Saperia 37 Internet Draft - DNS MIB - June 15, 1992 dnsServCounterQuerySource OBJECT-TYPE SYNTAX INTEGER { self (1), friend (2), remote (3) } ACCESS read-only STATUS mandatory DESCRIPTION "The source of the queries being counted in this row of the table. A value of 1 indicates that the queries reported on this row came from a resolver which resides on the same system as the server. A value of 2 indicates the queries originated from fiends of the server - the definition of friends is a locally defined matter. A value of 3 indicates that the queries counted on this row of the table came from systems which have not been defined as friends.." ::= { dnsServCounterEntry 3 } dnsServCounterTransport OBJECT-TYPE SYNTAX INTEGER { udp (1), tcp (2), other (3) } ACCESS read-only STATUS mandatory DESCRIPTION "A value of 1 indicates that the queries reported on this row were sent using UDP. A value of 2 indicates that TCP was used. 3 is for any transport other than TCP or UDP." ::= { dnsServCounterEntry 4 } 38 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsServCounterNumber OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of queries that have been recorded in this row of the table." ::= { dnsServCounterEntry 5 } -- Records Group -- The implementation of the Records Group is mandatory for all -- systems which implement DNS server software functions. -- Records Table -- The records default table contains information about records -- that the DNS software reads at initialization. dnsRecDefaultTable OBJECT-TYPE SYNTAX SEQUENCE OF DnsRecDefaultEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Configuration information about all RR records for the DNS software." ::= { dnsRecord 1 } dnsRecDefaultEntry OBJECT-TYPE SYNTAX DnsRecDefaultEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This table contains Resource Record configuration information." INDEX { dnsRecDefaultIndex } ::= { dnsRecDefaultTable 1 } Document Expiration Date - January 5, 1993 - Saperia 39 Internet Draft - DNS MIB - June 15, 1992 DnsRecDefaultEntry ::= SEQUENCE { dnsRecDefaultIndex INTEGER, dnsRecDefaultDomain OCTET STRING, dnsRecDefaultClass DnsClass, dnsRecDefaultType DnsType, dnsRecDefaultTTL INTEGER, dnsRecDefaultLength INTEGER, dnsRecDefaultData OCTET STRING } dnsRecDefaultIndex OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "A unique index value which identifies each entry in this table." ::= { dnsRecDefaultEntry 1 } dnsRecDefaultDomain OBJECT-TYPE SYNTAX DnsName -- OCTET STRING ACCESS read-only STATUS mandatory DESCRIPTION "The DNS domain to which this entry belongs." ::= { dnsRecDefaultEntry 2 } 40 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsRecDefaultClass OBJECT-TYPE SYNTAX DnsClasss -- INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The class of the record contained in this row. For classes defined in RFC 1035, the values are the same." ::= { dnsRecDefaultEntry 3 } dnsRecDefaultType OBJECT-TYPE SYNTAX DnsType -- INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The type of the record contained in this row. For types defined in RFC 1035, the values are the same." ::= { dnsRecDefaultEntry 3 } dnsRecDefaultTTL OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The default Time to Live value for this record which is read in on initialization." ::= { dnsRecDefaultEntry 4 } dnsRecDefaultLength OBJECT-TYPE SYNTAX INTEGER (1..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The length in octets of the data in dnsRecDefaultData." ::= { dnsRecDefaultEntry 5 } Document Expiration Date - January 5, 1993 - Saperia 41 Internet Draft - DNS MIB - June 15, 1992 dnsRecDefaultData OBJECT-TYPE SYNTAX OCTET STRING ACCESS read-only STATUS mandatory DESCRIPTION "Variable length of octets. The length is defined in dnsRecDefaultLength. The Type and Class information provided in this row of the table along with this data tell the management station how to interpret the date. For information on the details of DNS Resource Records and their formats, see RFC1035." ::= { dnsRecDefaultEntry 6 } -- Resolver Cache Group -- The implementation of the Resolver Cache Group is mandatory for -- all systems which implement a cache. dnsResCacheTablednsResCacheStatus OBJECT-TYPE SYNTAX INTEGER { enabled (1), disabled (2) } ACCESS read-only STATUS mandatory DESCRIPTION "Status of the resolver's cache. ENABLED means that the use of the cache is allowed. DISABLED means that the cache is not being used." ::= { dnsResCache 1 } 42 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsResCacheValid OBJECT-TYPE SYNTAX DnsValid { valid (1), clear (2) } ACCESS read-write STATUS mandatory DESCRIPTION "Setting this to CLEAR deletes the resolver's entire cache." ::= { dnsResCache 2 } dnsResCacheMaxTTL OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "Maximum Time-To-Live for RRs in this cache. If the resolver does not implement a TTL ceiling, the value of this field should be hexadecimal FFFFFFFF." " ::= { dnsResCache 3 } -- Resolver Cache Table -- The Resolver Cache Table contains information about Resource -- Records currently in the resolver's cache. OBJECT-TYPE SYNTAX SEQUENCE OF DnsResCacheEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The entire contents of the resolver's cache." ::= { dnsResCache 4 } Document Expiration Date - January 5, 1993 - Saperia 43 Internet Draft - DNS MIB - June 15, 1992 dnsResCacheEntry OBJECT-TYPE SYNTAX DnsResCacheEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A single entry in the resolvers's cache." INDEX { dnsResCacheIndex, dnsResCacheRRName, dnsResCacheRRClass, dnsResCacheRRType } ::= { dnsResCacheTable 1 } DnsResCacheEntry ::= SEQUENCE { dnsResCacheIndex, INTEGER, dnsResCacheRRName DnsName, dnsResCacheRRClass DnsClass, dnsResCacheRRType DnsType, dnsResCacheRRTTL DnsTime, dnsResCacheRRElapsedTTL DnsTime, dnsResCacheRRSource IpAddress, dnsResCacheRRRData OCTET STRING, dnsResCacheRRValid DnsValid } dnsResCacheRRIndex OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION 44 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 "A unique index value which indentifies each entry in this table." ::= { dnsResCacheEntry 1 } dnsResCacheRRName OBJECT-TYPE SYNTAX DnsName -- OCTET STRING ACCESS read-only STATUS mandatory DESCRIPTION "Owner name of the Resource Record in the cache which is identified in this row of the table. As described in RFC1034, the owner of the record is the domain name were the RR is found." ::= { dnsResCacheEntry 2 } dnsResCacheRRClass OBJECT-TYPE SYNTAX DnsClass -- INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "DNS class of the Resource Record in the cache which is identified in this row of the table." ::= { dnsResCacheEntry 3 } dnsResCacheRRType OBJECT-TYPE SYNTAX DnsType -- INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "DNS type of the Resource Record in the cache which is identified in this row of the table." ::= { dnsResCacheEntry 4 } Document Expiration Date - January 5, 1993 - Saperia 45 Internet Draft - DNS MIB - June 15, 1992 dnsResCacheRRTTL OBJECT-TYPE SYNTAX DnsTime ACCESS read-only STATUS mandatory DESCRIPTION "Time-To-Live of RR in DNS cache. This is the initial TTL value which was received with the RR when it was originally received." ::= { dnsResCacheEntry 5 } dnsResCacheRRElapsedTTL OBJECT-TYPE SYNTAX DnsTime ACCESS read-only STATUS mandatory DESCRIPTION "Elapsed seconds since RR was received." ::= { dnsResCacheEntry 6 } dnsResCacheRRSource OBJECT-TYPE SYNTAX IpAddress ACCESS read-only STATUS mandatory DESCRIPTION "Host from which RR was received, 0.0.0.0 if unknown." ::= { dnsResCacheEntry 7 } dnsResCacheRRRData OBJECT-TYPE SYNTAX OCTET STRING ACCESS read-only STATUS mandatory DESCRIPTION "RDATA portion of a cached RR." ::= { dnsResCacheEntry 8 } 46 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsResCacheRRValid OBJECT-TYPE SYNTAX DnsValid { valid (1), clear (2) } ACCESS read-write STATUS mandatory DESCRIPTION "Set to CLEAR to delete this RR entry from the cache table." ::= { dnsResCacheEntry 9 } -- Resolver Negative Cache Group -- The implementation of the Resolver Negative Cache group is -- mandatory for all systems which implement negative a negative -- cache function. dnsResNCacheStatus OBJECT-TYPE SYNTAX INTEGER { enabled (1), disabled (2) } ACCESS read-only STATUS mandatory DESCRIPTION "Status of the resolver's negative cache. ENABLED means that the use of the negative cache is allowed. DISABLED means that the negative caching is not being used." ::= { dnsNResCache 1 } Document Expiration Date - January 5, 1993 - Saperia 47 Internet Draft - DNS MIB - June 15, 1992 dnsResNCacheValid OBJECT-TYPE SYNTAX DnsValid { valid (1), clear (2) } ACCESS read-write STATUS mandatory DESCRIPTION "Setting this to CLEAR deletes the resolver's entire negative response cache." ::= { dnsNResCache 2 } dnsResNCacheMaxTTL OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "Maximum Time-To-Live for cached authoritative errors. If the resolver does not implement a TTL ceiling, the value of this field should be hexadecimal FFFFFFFF." ::= { dnsNResCache 3 } -- Resolver Negative Cache Table -- The Resolver Negative Cache Table contains information about -- Resource Records currently in the resolver's cache. dnsResNCacheTable OBJECT-TYPE SYNTAX SEQUENCE OF DnsResNCacheEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The resolver's negative response cache." ::= { dnsResNCache 4 } 48 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsResNCacheEntry OBJECT-TYPE SYNTAX DnsResNCacheEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry in the resolver's negative response cache." INDEX { dnsResNCacheIndex, dnsResNCacheErrQName, dnsResNCacheErrQClass, dnsResNCacheErrQType } ::= { dnsResNCacheTable 1 } DnsResNCacheEntry ::= SEQUENCE { dnsResNCacheIndex, INTEGER, dnsResNCacheErrQName DnsName, dnsResNCacheErrQClass DnsQClass, dnsResNCacheErrQType DnsQType, dnsResNCacheErrTTL DnsTime, dnsResNCacheErrElapsedTTL DnsTime, dnsResNCacheErrSource IpAddress, dnsResNCacheErrCode INTEGER, dnsResNCacheErrValid DnsValid } dnsResNCacheIndex OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION Document Expiration Date - January 5, 1993 - Saperia 49 Internet Draft - DNS MIB - June 15, 1992 "A unique index value which indentifies each entry in the Negative Cache table." ::= { dnsResNCacheEntry 1 } dnsResNCacheErrQName OBJECT-TYPE SYNTAX DnsName -- OCTET STRING ACCESS read-only STATUS mandatory DESCRIPTION "QNAME associated with a cached authoritative error." ::= { dnsResNCacheEntry 2 } dnsResNCacheErrQClass OBJECT-TYPE SYNTAX DnsQClass -- INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "DNS QCLASS associated with a cached authoritative error." ::= { dnsResNCacheEntry 3 } dnsResNCacheErrQType OBJECT-TYPE SYNTAX DnsQType -- INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "DNS QTYPE associated with a cached authoritative error." ::= { dnsResNCacheEntry 4 } dnsResNCacheErrTTL OBJECT-TYPE SYNTAX DnsTime ACCESS read-only STATUS mandatory DESCRIPTION "Time-To-Live of a cached authoritative error. This should be the TTL as copied from the MINIMUM field of the SOA that accompanied the authoritative error." ::= { dnsResNCacheEntry 5 } 50 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsResNCacheErrElapsedTTL OBJECT-TYPE SYNTAX DnsTime ACCESS read-only STATUS mandatory DESCRIPTION "Elapsed seconds since authoritative error was received." ::= { dnsResNCacheEntry 6 } dnsResNCacheErrSource OBJECT-TYPE SYNTAX IpAddress ACCESS read-only STATUS mandatory DESCRIPTION "Host which sent the authoritative error, 0.0.0.0 if unknown." ::= { dnsResNCacheEntry 7 } dnsResNCacheErrCode OBJECT-TYPE SYNTAX INTEGER { nonexistantName (1), noData (2), other (3) } ACCESS read-only STATUS mandatory DESCRIPTION "The authoritative error that has been cached. NonexistantName indicates a cached authoritative name error. NoData indicates a cached authoritative response with no error and no relevant data." ::= { dnsResNCacheEntry 8 } Document Expiration Date - January 5, 1993 - Saperia 51 Internet Draft - DNS MIB - June 15, 1992 dnsResNCacheErrValid OBJECT-TYPE SYNTAX DnsValid { valid (1), clear (2) } ACCESS read-write STATUS mandatory DESCRIPTION "Set to CLEAR to delete this cached error." ::= { dnsResNCacheEntry 9 } -- Resolver Statistics Group -- The implementation of the Resolver Statistics Group is -- mandatory for all systems which implement resolver functions. dnsResStatGoodCaches OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of RRs the resolver has cached successfully." ::= { dnsResStats 1 } dnsResStatBadCaches OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of RRs the resolver has refused to cache because they appear to be dangerous or irrelevant. Eg, RRs with suspiciously high TTLs, unsolicited root information, or that just don't appear to be relevant to the question the resolver asked." ::= { dnsResStats 2 } 52 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsResStatGoodNCaches OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of authoritative errors the resolver has cached successfully." ::= { dnsResStats 3 } dnsResStatBadNCaches OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Number of authoritative errors the resolver would have liked to cache but was unable to because the appropriate SOA RR was not supplied or looked suspicious." ::= { dnsResStats 4 } -- Lame Delegation Table dnsResLameDelegationTable OBJECT-TYPE SYNTAX SEQUENCE OF DnsResLameDelegationEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Table of name servers returning lame delegations." ::= { dnsResStats 5 } dnsResLameDelegationEntry OBJECT-TYPE SYNTAX DnsResLameDelegationEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Entry in lame delegation table." INDEX { dnsResLameDelegationSource, dnsResLameDelegationName, dnsResLameDelegationClass } ::= { dnsResLameDelegationTable 1 } Document Expiration Date - January 5, 1993 - Saperia 53 Internet Draft - DNS MIB - June 15, 1992 DnsResLameDelegationEntry ::= SEQUENCE { dnsResLameDelegationSource IpAddress, dnsResLameDelegationName DnsName, dnsResLameDelegationClass DnsClass, dnsResLameDelegationCount Counter, dnsResLameDelegationValid DnsValid } dnsResLameDelegationSource OBJECT-TYPE SYNTAX IpAddress ACCESS read-only STATUS mandatory DESCRIPTION "Source of lame delegation." ::= { dnsResLameDelegationEntry 1 } dnsResLameDelegationName OBJECT-TYPE SYNTAX DnsName ACCESS read-only STATUS mandatory DESCRIPTION "DNS name for which lame delegation was received." ::= { dnsResLameDelegationEntry 2 } dnsResLameDelegationClass OBJECT-TYPE SYNTAX DnsClass -- INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "DNS class of received lame delegation." ::= { dnsResLameDelegationEntry 3 } 54 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsResLameDelegationCount OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "How many times this lame delegation has been received." ::= { dnsResLameDelegationEntry 4 } dnsResLameDelegationValid OBJECT-TYPE SYNTAX DnsValid { valid (1), clear (2) } ACCESS read-write STATUS mandatory DESCRIPTION "Set to CLEAR to delete this lame delegation entry." ::= { dnsResLameDelegationEntry 5 } -- Server Management Group -- The implementation of the Server Management Group is mandatory -- for all systems which implement DNS server software functions. dnsMgmtVersion OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "Name and version information for name server software." ::= { dnsMgmt 1 } Document Expiration Date - January 5, 1993 - Saperia 55 Internet Draft - DNS MIB - June 15, 1992 dnsMgmtReload OBJECT-TYPE SYNTAX INTEGER { reload (1), other (2) } ACCESS read-write STATUS mandatory DESCRIPTION "This read-write variable is used to force a database reload with a restart of the name server process When set to the values above, the following actions are taken: reload - Reload and restart name server process(s). Other is returned when a read operation is performed on this object." ::= { dnsMgmt 2 } -- DNS Managment Zone Configuration Table dnsMgmtZoneTable OBJECT-TYPE SYNTAX SEQUENCE OF DnsNsZoneEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Table of zones for which this name server is configured. If name server doesn't load any zones, this table is empty." ::= { dnsMgmt 3 } dnsMgmtZoneEntry OBJECT-TYPE SYNTAX DnsMgmtZoneEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry in the name server zone table." INDEX { dnsMgmtZoneName, dnsMgmtZoneClass } ::= { dnsMgmtZoneTable 1 } 56 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 DnsMgmtZoneEntry ::= SEQUENCE { dnsMgmtZoneName DnsName, dnsMgmtZoneLoad DisplayString, dnsMgmtZoneDate DnsDate, dnsMgmtZoneClass DnsClass, dnsMgmtZoneLastReload DnsTime, dnsMgmtZoneLastReloadAttempt DnsTime, dnsMgmtZoneLastSource IpAddress, dnsMgmtZoneSerial INTEGER, dnsMgmtZoneRefresh DnsTime dnsMgmtZoneRetry DnsTime, dnsMgmtZoneExpire DnsTime, dnsMgmtZoneMin, INTEGER, dnsMgmtZoneValid DnsValid } dnsMgmtZoneName OBJECT-TYPE SYNTAX DnsName ACCESS read-only STATUS mandatory DESCRIPTION "DNS name of SOA RR defining top of this zone." ::= { dnsMgmtZoneEntry 1 } Document Expiration Date - January 5, 1993 - Saperia 57 Internet Draft - DNS MIB - June 15, 1992 dnsMgmtZoneLoad OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "This is the name of the file that is read in for the initial load of zone information on startup." ::= { dnsMgmtZoneEntry 2 } dnsMgmtZoneDate OBJECT-TYPE SYNTAX DnsDate -- DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "This is the date that the information found in dnsMgmtZoneLoad was last changed." ::= { dnsMgmtZoneEntry 3 } dnsMgmtZoneClass OBJECT-TYPE SYNTAX DnsClass -- INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "DNS class of the RRs in this zone." ::= { dnsMgmtZoneEntry 4 } dnsMgmtZoneLastReload OBJECT-TYPE SYNTAX DnsTime ACCESS read-only STATUS mandatory DESCRIPTION "Elapsed seconds since last successful reload of this zone." ::= { dnsMgmtZoneEntry 5 } 58 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsMgmtZoneLastReloadAttempt OBJECT-TYPE SYNTAX DnsTime ACCESS read-only STATUS mandatory DESCRIPTION "Elapsed seconds since last attempted reload of this zone." ::= { dnsMgmtZoneEntry 6 } dnsMgmtZoneLastSource OBJECT-TYPE SYNTAX IpAddress ACCESS read-only STATUS mandatory DESCRIPTION "IP address of host from which most recent reload of this zone was received. If unknown or irrelevant, value should be 0.0.0.0." ::= { dnsMgmtZoneEntry 7 } dnsMgmtSerial OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "The current serial number of the SOA record in the file specified by dnsServMgmtBootLoad." ::= { dnsMgmtZoneEntry 8 } dnsMgmtZoneRefresh OBJECT-TYPE SYNTAX DnsTime ACCESS read-only STATUS mandatory DESCRIPTION "REFRESH interval for zone. This is the REFRESH field of the zone's SOA RR, if known, otherwise whatever value the name server is using in place of the SOA REFRESH value." ::= { dnsMgmtZoneEntry 9 } Document Expiration Date - January 5, 1993 - Saperia 59 Internet Draft - DNS MIB - June 15, 1992 dnsMgmtZoneRetry OBJECT-TYPE SYNTAX DnsTime ACCESS read-only STATUS mandatory DESCRIPTION "RETRY interval for zone. This is the RETRY field of the zone's SOA RR, if known, otherwise whatever value the name server is using in place of the SOA RETRY value." ::= { dnsMgmtZoneEntry 10 } dnsMgmtZoneExpire OBJECT-TYPE SYNTAX DnsTime ACCESS read-only STATUS mandatory DESCRIPTION "EXPIRE interval for zone. This is the EXPIRE field of the zone's SOA RR, if known, otherwise whatever value the name server is using in place of the SOA EXPIRE value." ::= { dnsMgmtZoneEntry 11 } dnsMgmtZoneMin OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "This value is the TTL field which will be exported with any RR from this zone and is specified in the SOA record identified by dnsServMgmtBootLoad." ::= { dnsServMgmtBootEntry 12 } 60 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 dnsMgmtZoneValid OBJECT-TYPE SYNTAX DnsValid { valid (1), clear (2) } ACCESS write-only STATUS mandatory DESCRIPTION "Set to CLEAR to delete this zone entry." ::= { dnsMgmtZoneEntry 13 } -- DNS Management Server Table dnsMgmtServTable OBJECT-TYPE SYNTAX SEQUENCE OF DnsMgmtServEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Table of IP addresses of name server hosts from which this name server might obtain particular zones. Typically this indicates the addresses of the primary name servers of zones for which the SNMP agent's host is a secondary name server." ::= { dnsMgmt 4 } dnsMgmtServEntry OBJECT-TYPE SYNTAX DnsMgmtServEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry in the name server server (sic) table." INDEX { dnsMgmtServName, dnsMgmtServClass, dnsMgmtServAddr } ::= { dnsMgmtServTable 1 } Document Expiration Date - January 5, 1993 - Saperia 61 Internet Draft - DNS MIB - June 15, 1992 DnsMgmtServEntry ::= SEQUENCE { dnsMgmtServName DnsName, dnsMgmtServClass DnsClass, dnsMgmtServAddr IpAddress } dnsMgmtServName OBJECT-TYPE SYNTAX DnsName ACCESS read-only STATUS mandatory DESCRIPTION "DNS name of the zone to which this entry applies." ::= { dnsMgmtServ 1 } dnsMgmtServClass OBJECT-TYPE SYNTAX DnsClass -- INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "DNS class of zone to which this entry applies." ::= { dnsMgmtServ 2 } dnsMgmtServAddr OBJECT-TYPE SYNTAX IpAddress ACCESS read-only STATUS mandatory DESCRIPTION "IP address of name server host from which this zone might be obtainable." ::= { dnsMgmtServ 3 } END 62 Document Expiration Date - January 5, 1993 - Saperia Internet Draft - DNS MIB - June 15, 1992 5 Acknowledgements This document is the result of work undertaken the by DNS work- ing group. Special thanks are due to Rob Austein of Epilogue Technology for the major contributions he has made in the orga- nization of the MIB as well as authoring many of the objects. In addition, the contributions and comments of the following members are also specially acknowledged: Win Treese, Digital Equipment Corporation Philip Almquist, Computer Communication consultant Joe Peck, Digital Equipment Corporation 6 References J. Reynolds and J. Postel, Assigned Numbers. Internet Working Group Request for Comments 1010. Network Information Center, SRI International, Menlo Park, California, (May, 1987). M. Stahl, Domain Administrators Guide. Internet Working Group Request for Comments 1032. Network Information Center, SRI International, Menlo Park, California, (November, 1987). M. Lottor, Domain Administrators Operations Guide, Internet Working Group Request for Comments 1033. Network Information Center, SRI International, Menlo Park, California, (November, 1987). P. Mockapetris, Domain Names - Concepts and Facilities, Internet Working Group Request for Comments 1034. Network Information Center, SRI International, Menlo Park, California, (November, 1987). P. Mockapetris, Domain Names - Implementation and Specifica- tion, Internet Working Group Request for Comments 1035. Network Information Center, SRI International, Menlo Park, California, (November, 1987). Document Expiration Date - January 5, 1993 - Saperia 63 Internet Draft - DNS MIB - June 15, 1992 V. Cerf, IAB Recommendations for the Development of Internet Network Management Standards. Internet Working Group Request for Comments 1052. Network Information Center, SRI International, Menlo Park, California, (April, 1988). R. Braden (editor) Requirements for Internet Hosts-Application and Support, Internet Working Group Request for Comments 1123. Network Information Center, SRI International,Menlo Park, Cali- fornia, (October, 1989). M.T. Rose and K. McCloghrie, Structure and Identification of Management Information for TCP/IP-based internets, Internet Working Group Request for Comments 1155. Network Information Center, SRI International, Menlo Park, California, (May, 1990). K. McCloghrie and M.T. Rose, Management Information Base for Network Management of TCP/IP-based internets, Internet Working Group Request for Comments 1156, Network Information Center, SRI International, Menlo Park, California, (May, 1990). J.D. Case, M.S. Fedor, M.L. Schoffstall, and J.R. Davin, Simple Network Management Protocol, Internet Working Group Request for Comments 1157. Network Information Center, SRI International, Menlo Park, California, (May, 1990). M.T. Rose, The Open Book, A Practical Perspective on OSI. Pren- tice Hall, Englewood Cliffs, New Jersey, (1990). M.T. Rose and K. McCloghrie (editors) Concise MIB Definitions, Internet Working Group Request for Comments 1212, Network In- formation Center, SRI International, Menlo Park, California, (March, 1991). K. McCloghrie and M.T. Rose (editors), Management Information Base for Network Management of TCP/IP-based internets: MIB- II, Internet Working Group Request for Comments 1213. Network Information Center, SRI International, Menlo Park, California, (March, 1991). 64 Document Expiration Date - January 5, 1993 - Saperia