idnits 2.17.1 draft-ietf-dns-mibext-02.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** Cannot find the required boilerplate sections (Copyright, IPR, etc.) in this document. Expected boilerplate is as follows today (2024-04-23) according to https://trustee.ietf.org/license-info : IETF Trust Legal Provisions of 28-dec-2009, Section 6.a: This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. IETF Trust Legal Provisions of 28-dec-2009, Section 6.b(i), paragraph 2: Copyright (c) 2024 IETF Trust and the persons identified as the document authors. All rights reserved. IETF Trust Legal Provisions of 28-dec-2009, Section 6.b(i), paragraph 3: This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- ** Missing document type: Expected "INTERNET-DRAFT" in the upper left hand corner of the first page ** Missing expiration date. The document expiration date should appear on the first and last page. ** The document seems to lack a 1id_guidelines paragraph about Internet-Drafts being working documents. ** The document seems to lack a 1id_guidelines paragraph about 6 months document validity. ** The document seems to lack a 1id_guidelines paragraph about the list of current Internet-Drafts. ** The document seems to lack a 1id_guidelines paragraph about the list of Shadow Directories. ** Expected the document's filename to be given on the first page, but didn't find any == No 'Intended status' indicated for this document; assuming Proposed Standard == The page length should not exceed 58 lines per page, but there was 1 longer page, the longest (page 5) being 62 lines Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** The document seems to lack a Security Considerations section. ** The document seems to lack an IANA Considerations section. (See Section 2.2 of https://www.ietf.org/id-info/checklist for how to handle the case when there are no actions for IANA.) ** The document seems to lack an Authors' Addresses Section. ** The document seems to lack separate sections for Informative/Normative References. All references will be assumed normative when checking for downward references. ** There are 149 instances of too long lines in the document, the longest one being 8 characters in excess of 72. == There are 1 instance of lines with non-RFC2606-compliant FQDNs in the document. Miscellaneous warnings: ---------------------------------------------------------------------------- == Couldn't figure out when the document was first submitted -- there may comments or warnings related to the use of a disclaimer for pre-RFC5378 work that could not be issued because of this. Please check the Legal Provisions document at https://trustee.ietf.org/license-info to determine if you need the pre-RFC5378 disclaimer. -- The document date (September 2, 1992) is 11556 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) No issues found here. Summary: 13 errors (**), 0 flaws (~~), 4 warnings (==), 1 comment (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Internet Draft - DNS MIB - September 2, 1992 4 DNS MIB Extensions 6 2-September-1992 8 DNS Working Group 10 Jon Saperia 11 Digital Equipment Corporation 12 saperia@tcpjon.ogo.dec.com 14 Status of this Memo 16 This document is an Internet Draft. Internet Drafts are working 17 documents of the Internet Engineering Task Force (IETF), its 18 Areas, and its Working Groups. Note that other groups may also 19 distribute working documents as Internet Drafts). Internet 20 Drafts are draft documents valid for a maximum of six months. 21 Internet Drafts may be updated, replaced, or obsoleted by other 22 documents at any time. It is not appropriate to use Internet 23 Drafts as reference material or to cite them other than as a 24 "working draft" or "work in progress." Please check the I-D 25 abstract listing contained in each Internet Draft directory to 26 learn the current status of this or any other Internet Draft. 28 This draft document will be submitted to the RFC editor as 29 a proposed extension to the SNMP MIB. Distribution of this 30 document is unlimited. Please send comments or corrections to 31 the editor. 33 Abstract 35 This memo defines a set of DNS (Domain Name System) exten- 36 sions that have been created for the Internet MIB. When used 37 in conjunction with the Structure of Management Information (RFC 38 1155), the Management Information Base for Network Management 39 of TCP/IP-based internets (RFC 1213) and the Simple Network 40 Management Protocol (RFC 1157), it will be possible to provide 41 integrated network management of DNS client and server soft- 42 ware in standard TCP/IP based environments. This document was 43 produced by the DNS working group. 45 Digital Equipment Corporation 46 Maynard, Massachusetts 48 ii Document Expiration Date - March 7, 1993 - Jon Saperia 49 CONTENTS 51 1 Introduction......................................... 1 53 2 Selected Objects..................................... 1 55 3 Objects.............................................. 2 57 3.1 Format of Definitions............................. 3 59 3.2 Textual Conventions............................... 4 61 4 Object Definitions................................... 4 63 5 Acknowledgements..................................... 60 65 6 References........................................... 60 67 iii 68 1 Introduction 70 With the adoption of The Simple Network Management Protocol (RFC 71 1157), the Management Information Base for network management of 72 TCP/IP-based internets (RFC 1213), and the Structure of Manage- 73 ment Information (RFC 1155) by the Internet, and a large number 74 of vendor implementations of these standards in commercially 75 available products, it became possible to provide a higher level 76 of effective network management in TCP/IP-based internets than 77 previously available. With the growth in the use of these stan- 78 dards, it has become possible to consider the management of 79 other elements of the infrastructure beyond the basic TCP/IP 80 protocols. A key element of the TCP/IP infrastructure is the 81 DNS. 83 Up to this point there has been no mechanism to integrate the 84 management of the DNS with SNMP-based managers. This memo pro- 85 vides the mechanisms by which IP-based management stations can 86 effectively manage DNS client and server software in an inte- 87 grated fashion through the use of the standard Internet SMI, MIB 88 and Simple Network Management Protocol. 90 New DNS MIB objects have been defined to be used in conjunction 91 with the Internet MIB to allow access and control of the DNS via 92 SNMP by the Internet community. 94 2 Selected Objects 96 The objects included in this memo have been created from infor- 97 mation contained in the relevant DNS related RFCs which include: 98 Domain Administrators Guide (RFC 1032), Domain Administrators 99 Operations Guide (RFC 1033) Domain Names - Concepts and Facili- 100 ties (RFC 1034), Domain Names - Implementation and Specification 101 (RFC 1035), and Requirements for Internet Hosts - Application 102 and Support (RFC 1123). In addition, objects have been created 104 Document Expiration Date - March 7, 1993 - Saperia 1 105 based on expected operational need and from the example of ex- 106 isting DNS specific tools. These objects have be ordered into 107 groups as follows: 109 o General Configuration Group 111 o Resolver Configuration Group 113 o Server Configuration Group 115 o Resolver Counter Group 117 o Server Counter Group 119 o Records Group 121 o Resolver Cache Group 123 o Resolver Negative Cache Group 125 o Resolver Statistics Group 127 o Server Management Group 129 Many of the objects defined in this memo have been created from 130 information contained in existing configuration files used by 131 many DNS implementations. This information has been converted 132 into a standard form using the Internet Standard SMI defined in 133 RFC 1155. 135 3 Objects 137 The objects in this memo are described using the standard Inter- 138 net SMI and BER of RFC 1155. Each object description includes 139 the objects name, its syntax and encoding. Just as with objects 140 supported in the MIB (RFC 1156), an object name is identified 141 with an object identifier which has been administratively as- 142 signed. This identifies an Object Type. When an object type 143 is combined with a specific instance - the particular object 144 is uniquely identified. Use of Object Descriptors in this memo 145 is consistent with that of RFC 1156 - meaning that they are 147 2 Document Expiration Date - March 7, 1993 - Saperia 148 text strings meant to be read by humans. The descriptors have 149 been created from a variety of sources. For the most part, the 150 descriptions are influenced by by the DNS related RFCs noted 151 above. For example, the descriptors for counters used for the 152 various types of queries of DNS records are influenced by the 153 definitions used for the various record types found in Domain 154 Names - Implementation and Specification RFC 1035. 156 3.1 Format of Definitions 158 An object in this memo is specified by five fields of informa- 159 tion: Object, Syntax, Description, Access, and Status. 161 The OBJECT is a textual name (OBJECT DESCRIPTOR) for that ob- 162 ject type combined with an administratively obtained OBJECT 163 IDENTIFIER. 165 SYNTAX : For each object type, its abstract syntax is presented 166 using the ASN.1 specified in RFC 1155. 168 DESCRIPTION: A general description of the object type. 170 ACCESS : The standard access keywords supported in RFC 1156 are 171 used. The keywords used in this MIB are: read-only, read-write, 172 and, not-accessible. 174 STATUS : The status field is used to describe with a single 175 keyword whether the object type is mandatory or optional. Status 176 keywords of obsolete and deprecated are not used in this memo 177 since this is the first version of the DNS MIB. 179 Document Expiration Date - March 7, 1993 - Saperia 3 180 3.2 Textual Conventions 182 Several datatypes have been introduced as a textual conven- 183 tions in this DNS MIB document. These additions will facilitate 184 the common understanding of information used by the DNS. No 185 changes to the SMI or the SNMP are necessary to support these 186 conventions which are described in 4.0 (Object Definitions). 188 4 Object Definitions 190 RFCxxxx-dnsMIB 191 DEFINITIONS ::= BEGIN 193 IMPORTS 194 mgmt, OBJECT-TYPE, NetworkAddress, IpAddress, 195 Counter, Gauge, TimeTicks 196 FROM RFC1155-SMI 197 DisplayString 198 FROM RFC1213; 200 -- DNS MIB 202 dns OBJECT IDENTIFIER ::= { experimental 9999 } 204 -- textual conventions 206 DnsDate ::= DisplayString 207 -- This data type is intended to provide a consistent 208 -- method of reporting date information. The first four 209 -- octets represent the year, the next two month of the year 210 -- expressed numerically, the next four octets represent the day 211 -- followed by hour of the day using a 24 hour clock followed by a 212 -- decimal point. The next two octets represent tenths and 213 -- hundreths of a second. The final 5 octets provide a mechanism 214 -- to relate the host's time to Coordinated Universal Time. Tuesday 215 -- May 26, 1992 at 1:30 PM EDT would be represented as: 216 -- 199205261330.00-400. 218 4 Document Expiration Date - March 7, 1993 - Saperia 219 DnsName ::= OCTET STRING 220 -- A DNS name is a sequence of octets with internal length encoding. 221 -- While it is often the case that the printed form of a DNS name is 222 -- a dotted-format Internet hostname, this is not always the case. 223 -- All occurrences of DNS names in this MIB us the internal format 224 -- used by the DNS protocols embedded within an OCTET STRING. 226 DnsClass ::= INTEGER (0..65535) 227 -- This data type is used to represent the class values which appear 228 -- in Resource Records in the DNS. A 16-bit unsigned integer is 229 -- used to allow room for new classes records to be defined. 230 -- Existing classes are listed in RFC 1035. 232 DnsType ::= INTEGER (0..65535) 233 -- This data type is used to represent the type values which appear 234 -- in Resource Records in the DNS. A 16-bit unsigned integer is 235 -- used to allow room for new record types to be defined. 236 -- Existing types are listed in RFC 1035. 238 DnsQClass ::= INTEGER (0..65535) 239 -- This data type is used to represent the QClass values which appear 240 -- in Resource Records in the DNS. A 16-bit unsigned integer is 241 -- used to allow room for new QClass records to be defined. Existing 242 -- Q classes are listed in RFC 1035. 244 DnsQType ::= INTEGER (0..65535) 245 -- This data type is used to represent the QType values which appear 246 -- in Resource Records in the DNS. A 16-bit unsigned integer is 247 -- used to allow room for new QType records to be defined. 248 -- Existing QTypes are listed in RFC 1035. 250 DnsTime ::= INTEGER 251 -- DnsTime values are 32-bit unsigned integers which measure time in 252 -- seconds. 254 DnsValid ::= INTEGER { valid (1), clear (2) } 255 -- Many of the tables in this MIB have as one of their columns, an 256 -- object which can be set to a value of 2 to delete that 257 -- row of the table. If a read operation is performed on this 258 -- object, a value of 1 is returned to indicate a valid row in the 259 -- table. 261 Document Expiration Date - March 7, 1993 - Saperia 5 262 DnsOpCode ::= INTEGER (0..15) 263 -- This data type is used to represent the DNS OPCODE used in the 264 -- header section of DNS messages. Existing OPCODE vales are listed 265 -- in RFC 1035. 267 DnsRespCode ::= INTEGER (0..15) 268 -- This data type is used to represent the DNS RCODE value in response 269 -- messages. Existing RCODE valeus are listed in RFC 1035. 271 -- groups in the dns mib 273 dnsGenConfig OBJECT IDENTIFIER ::= { dns 1 } 274 dnsResConfig OBJECT IDENTIFIER ::= { dns 2 } 275 dnsServerConfig OBJECT IDENTIFIER ::= { dns 3 } 276 dnsResCounter OBJECT IDENTIFIER ::= { dns 4 } 277 dnsServCounter OBJECT IDENTIFIER ::= { dns 5 } 278 dnsRec OBJECT IDENTIFIER ::= { dns 6 } 279 dnsResCache OBJECT IDENTIFIER ::= { dns 7 } 280 dnsResNCache OBJECT IDENTIFIER ::= { dns 8 } 281 dnsResStats OBJECT IDENTIFIER ::= { dns 9 } 282 dnsMgmt OBJECT IDENTIFIER ::= { dns 10 } 284 -- General Configuration Group 286 -- The implementation of the General Configuration group is 287 -- mandatory for all systems. 289 dnsGenConfigDnsUse OBJECT-TYPE 290 SYNTAX INTEGER { 291 primary (1), 292 not-primary (2), 293 not-used (3) 294 } 295 ACCESS read-write 296 STATUS mandatory 297 DESCRIPTION 298 "A value of 1 indicates that the DNS is used as the 299 primary mechanism for name resolution on this system. 300 A 2 indicates that some other mechanism is used as the 301 primary mechanism for name resolution and that the DNS 303 6 Document Expiration Date - March 7, 1993 - Saperia 304 is used as a back-up. A value of 3 indicates that DNS 305 is not used for name resolution." 306 ::= { dnsGenConfig 1 } 308 -- Resolver Configuration Group 310 -- The implementation of the Resolver Configuration group is 311 -- mandatory for all systems which implement any resolver software 312 -- functions. 314 dnsResConfigId OBJECT-TYPE 315 SYNTAX DisplayString 316 ACCESS read-only 317 STATUS mandatory 318 DESCRIPTION 319 "Name and version identification of DNS resolver software." 320 ::= { dnsResConfig 1 } 322 dnsResConfigService OBJECT-TYPE 323 SYNTAX INTEGER { 324 recursive-only (1), 325 iterative-only (2), 326 recursive-and-iterative (3) 327 } 328 ACCESS read-only 329 STATUS mandatory 330 DESCRIPTION 331 "Kind of DNS resolution service provided. 332 RECURSIVE-ONLY is a stub resolver. 333 ITERATIVE-ONLY is a normal full service resolver. 334 RECURSIVE-AND-ITERATIVE is a full service resolver which 335 performs a mix of recursive and iterative queries." 336 ::= { dnsResConfig 2 } 338 Document Expiration Date - March 7, 1993 - Saperia 7 339 dnsResConfigMaxCnames OBJECT-TYPE 340 SYNTAX INTEGER 341 ACCESS read-write 342 STATUS mandatory 343 DESCRIPTION 344 "Limit on how many CNAMEs the resolver should allow before 345 deciding that there's a CNAME loop. Zero means that 346 resolver has no explicit CNAME limit." 347 ::= { dnsResConfig 3 } 349 -- DNS Resolver Seat Belt Table 351 dnsResConfigSeatBeltTable OBJECT-TYPE 352 SYNTAX SEQUENCE OF DnsResConfigSeatBeltEntry 353 ACCESS not-accessible 354 STATUS mandatory 355 DESCRIPTION 356 "Table of safety belt information used by the resolver 357 when it hasn't got any better idea of where to send a 358 query, such as when the resolver is booting." 359 ::= { dnsResConfig 4 } 361 dnsResConfigSeatBeltEntry OBJECT-TYPE 362 SYNTAX DnsResConfigSeatBeltEntry 363 ACCESS not-accessible 364 STATUS mandatory 365 DESCRIPTION 366 "An entry in the resolver's seatbelt table." 367 INDEX { dnsResConfigSeatBeltAddr, 368 dnsResConfigSeatBeltSubTree, 369 dnsResConfigSeatBeltClass } 370 ::= { dnsResConfigSeatBeltTable 1 } 372 8 Document Expiration Date - March 7, 1993 - Saperia 373 DnsResConfigSeatBeltEntry ::= 374 SEQUENCE { 375 dnsResConfigSeatBeltAddr 376 IpAddress, 377 dnsResConfigSeatBeltName 378 DnsName, 379 dnsResConfigSeatBeltSvc 380 INTEGER, 381 dnsResConfigSeatBeltPref 382 INTEGER, 383 dnsResConfigSeatBeltSubTree 384 DnsName, 385 dnsResConfigSeatBeltClass 386 DnsClass, 387 dnsResConfigSeatBeltFile 388 OCTET STRING, 389 dnsResConfigSeatBeltDate 390 DnsDate, 391 dnsResConfigSeatBeltValid 392 DnsValid 393 } 394 dnsResConfigSeatBeltAddr OBJECT-TYPE 395 SYNTAX IpAddress 396 ACCESS read-only 397 STATUS mandatory 398 DESCRIPTION 399 "IP address of a SeatBelt name server." 400 ::= { dnsResConfigSeatBeltEntry 1 } 402 dnsResConfigSeatBeltName OBJECT-TYPE 403 SYNTAX DnsName -- OCTET STRING 404 ACCESS read-only 405 STATUS mandatory 406 DESCRIPTION 407 "DNS name of a SeatBelt nameserver, if known, otherwise 408 it is null." 409 ::= { dnsResConfigSeatBeltEntry 2 } 411 Document Expiration Date - March 7, 1993 - Saperia 9 412 dnsResConfigSeatBeltSvc OBJECT-TYPE 413 SYNTAX INTEGER { 414 iterative (1), 415 recursive (2) 416 } 417 ACCESS read-only 418 STATUS mandatory 419 DESCRIPTION 420 "Type-Of-Service resolver expects from seatbelt 421 nameserver. ITERATIVE indicates that resolver will be 422 directing iterative queries to this name server (RD 423 bit turned off), while RECURSIVE indicates that 424 resolver will be directing recursive queries to this 425 name server (RD bit turned on)." 426 ::= { dnsResConfigSeatBeltEntry 3 } 428 dnsResConfigSeatBeltPref OBJECT-TYPE 429 SYNTAX INTEGER 430 ACCESS read-only 431 STATUS mandatory 432 DESCRIPTION 433 "This value identifies the preference for the server 434 identified in this row of the table. The lower the 435 value, the more desirable the particular server is 436 considered." 437 ::= { dnsResConfigSeatBeltEntry 4 } 439 dnsResConfigSeatBeltSubTree OBJECT-TYPE 440 SYNTAX DnsName -- OCTET STRING 441 ACCESS read-only 442 STATUS mandatory 443 DESCRIPTION 444 "The DNS sub tree name for queries sent to the name 445 server identified by dnsResConfigSeatBeltName." 446 ::= { dnsResConfigSeatBeltEntry 5 } 448 10 Document Expiration Date - March 7, 1993 - Saperia 449 dnsResConfigSeatBeltClass OBJECT-TYPE 450 SYNTAX DnsClass -- INTEGER (0..65535) 451 ACCESS read-only 452 STATUS mandatory 453 DESCRIPTION 454 "The class of DNS queries that will be sent to the 455 server identified by dnsResConfigSeatBeltName." 456 ::= { dnsResConfigSeatBeltEntry 6 } 458 dnsResConfigSeatBeltFile OBJECT-TYPE 459 SYNTAX DisplayString 460 ACCESS read-only 461 STATUS mandatory 462 DESCRIPTION 463 "The name of the source file which contains information 464 read by the resolver at initialization." 465 ::= { dnsResConfigSeatBeltEntry 7 } 467 dnsResConfigSeatBeltDate OBJECT-TYPE 468 SYNTAX DnsDate -- DisplayString 469 ACCESS read-only 470 STATUS mandatory 471 DESCRIPTION 472 "This is the date information found in 473 dnsResConfigSeatBeltFile was last changed." 474 ::= { dnsResConfigSeatBeltEntry 8 } 476 dnsResConfigSeatBeltValid OBJECT-TYPE 477 SYNTAX DnsValid 478 ACCESS read-write 479 STATUS mandatory 480 DESCRIPTION 481 "Setting this variable to CLEAR deletes this SeatBelt 482 server." 483 ::= { dnsResConfigSeatBeltEntry 9 } 485 Document Expiration Date - March 7, 1993 - Saperia 11 486 -- Server Configuration Group 488 -- The implementation of the Server Configuration Group is 489 -- mandatory for all systems which implement DNS server software 490 -- functions. 492 dnsServerConfigImplementIdent OBJECT-TYPE 493 SYNTAX DisplayString 494 ACCESS read-only 495 STATUS mandatory 496 DESCRIPTION 497 "The implementation identification string for the DNS 498 software in use on the system, for example; FNS2.1" 499 ::= { dnsServerConfig 1 } 501 dnsServerConfigRecurs OBJECT-TYPE 502 SYNTAX INTEGER { 503 available (1), 504 restricted (2), 505 unavailable (3) 506 } 507 ACCESS read-write 508 STATUS mandatory 509 DESCRIPTION 510 "This represents the recursion status of requests made 511 to this server. The possible values are: available - 512 performs recursion on requests from clients. 513 Restricted - recursion is performed on requests from 514 clients which are on an access control list. 515 Unavailable - recursion is not available." 516 ::= { dnsServerConfig 2 } 518 -- Resolver Counters Group 520 -- The implementation of the Resolver Counters Group is mandatory for 521 -- all systems which implement resolver functions 523 12 Document Expiration Date - March 7, 1993 - Saperia 524 dnsResCounterUpTime OBJECT-TYPE 525 SYNTAX DnsTime 526 ACCESS read-only 527 STATUS mandatory 528 DESCRIPTION 529 "If the resolver has a persistent state, e.g., a 530 process; this value will be the time elapsed since it 531 started. For software that does not have persistence, 532 this value will be 0." 533 ::= { dnsResCounter 1 } 535 dnsResCounterResetTime OBJECT-TYPE 536 SYNTAX DnsTime 537 ACCESS read-only 538 STATUS mandatory 539 DESCRIPTION 540 "Elapsed time since cache was reloaded." 541 ::= { dnsResCounter 2 } 543 dnsResCounterInUpkts OBJECT-TYPE 544 SYNTAX Counter 545 ACCESS read-only 546 STATUS mandatory 547 DESCRIPTION 548 "Number of UDP packets received by the resolver 549 process(s)." 550 ::= { dnsResCounter 3 } 552 dnsResCounterOutUPkts OBJECT-TYPE 553 SYNTAX Counter 554 ACCESS read-only 555 STATUS mandatory 556 DESCRIPTION 557 "Number of UDP packets sent by the resolver 558 process(s)." 559 ::= { dnsResCounter 4 } 561 Document Expiration Date - March 7, 1993 - Saperia 13 562 dnsResCounterTCPInitiatns OBJECT-TYPE 563 SYNTAX Counter 564 ACCESS read-only 565 STATUS mandatory 566 DESCRIPTION 567 "Number of attempts to initiate TCP connections with 568 servers." 569 ::= { dnsResCounter 5 } 571 dnsResCounterInTCPMesgs OBJECT-TYPE 572 SYNTAX Counter 573 ACCESS read-only 574 STATUS mandatory 575 DESCRIPTION 576 "Number of received DNS messages over TCP by the 577 resolver process." 578 ::= { dnsResCounter 6 } 580 dnsResCounterOutTCPMesgs OBJECT-TYPE 581 SYNTAX Counter 582 ACCESS read-only 583 STATUS mandatory 584 DESCRIPTION 585 "Number of out bound DNS messages sent over TCP by the 586 resolver." 587 ::= { dnsResCounter 7 } 589 -- Resolver Counter Table 591 dnsResCounterTable OBJECT-TYPE 592 SYNTAX SEQUENCE OF DnsResCounterTableEntry 593 ACCESS not-accessible 594 STATUS mandatory 595 DESCRIPTION 596 "Table of the current count of resolver queries and 597 answers." 598 ::= { dnsResCounter 8 } 600 14 Document Expiration Date - March 7, 1993 - Saperia 601 dnsResCounterTableEntry OBJECT-TYPE 602 SYNTAX DnsResCounterTableEntry 603 ACCESS not-accessible 604 STATUS mandatory 605 DESCRIPTION 606 "Entry in the resolver counter table. Entries are 607 indexed by dns OpCode." 608 INDEX { dnsResCounterOpCode } 609 ::= { dnsResCounterTable 1 } 611 DnsResCounterTableEntry ::= 612 SEQUENCE { 613 dnsResCounterOpCode 614 DnsOpCode, 615 dnsResCounterQueries 616 Counter, 617 dnsResCounterResponses 618 Counter 619 } 620 dnsResCounterOpCode OBJECT-TYPE 621 SYNTAX DnsOpCode -- INTEGER (0..15) 622 ACCESS read-only 623 STATUS mandatory 624 DESCRIPTION 625 "The index to this table. The OpCodes that have 626 already been defined are found in RFC1035." 627 ::= { dnsResCounterTableEntry 1 } 629 dnsResCounterQueries OBJECT-TYPE 630 SYNTAX Counter 631 ACCESS read-only 632 STATUS mandatory 633 DESCRIPTION 634 "Number of queries [total] that have sent out by the 635 resolver since initialization for the OpCode which is 636 the index to this row of the table." 637 ::= { dnsResCounterTableEntry 2 } 639 Document Expiration Date - March 7, 1993 - Saperia 15 640 dnsResCounterResponses OBJECT-TYPE 641 SYNTAX Counter 642 ACCESS read-only 643 STATUS mandatory 644 DESCRIPTION 645 "Number of responses [total] that have been received 646 by the resolver since initialization for the OpCode 647 which is the index to this row of the table." 648 ::= { dnsResCounterTableEntry 3 } 650 -- Resolver Response Code Counter Table 652 dnsResResponseTable OBJECT-TYPE 653 SYNTAX SEQUENCE OF DnsResResponseTableEntry 654 ACCESS not-accessible 655 STATUS mandatory 656 DESCRIPTION 657 "Table of the current count of responses to resolver 658 queries." 659 ::= { dnsResCounter 9 } 661 dnsResResponseTableEntry OBJECT-TYPE 662 SYNTAX DnsResResponseTableEntry 663 ACCESS not-accessible 664 STATUS mandatory 665 DESCRIPTION 666 "Entry in the resolver response table. Entries are 667 indexed by DNS response code." 668 INDEX { dnsResResponseCode } 669 ::= { dnsResResponseTable 1 } 671 16 Document Expiration Date - March 7, 1993 - Saperia 672 DnsResResponseTableEntry ::= 673 SEQUENCE { 674 dnsResResponseCode 675 DnsRespCode, 676 dnsResResponses 677 Counter 678 } 679 dnsResResponseCode OBJECT-TYPE 680 SYNTAX DnsRespCode -- INTEGER (0..15) 681 ACCESS read-only 682 STATUS mandatory 683 DESCRIPTION 684 "The index to this table. The Response Codes that have 685 already been defined are found in RFC1035." 686 ::= { dnsResResponseTableEntry 1 } 688 dnsResResponses OBJECT-TYPE 689 SYNTAX Counter 690 ACCESS read-only 691 STATUS mandatory 692 DESCRIPTION 693 "Number of responses the resolver has received for the 694 response code value which identifies this row of the 695 table." 696 ::= { dnsResResponseTableEntry 2 } 698 -- Additional DNS Resolver Counter Objects 700 dnsResCounterNonAuthDataResps OBJECT-TYPE 701 SYNTAX Counter 702 ACCESS read-only 703 STATUS mandatory 704 DESCRIPTION 705 "Number of requests made by the resolver for which a 706 non-authoritative answer (cached data) was received." 707 ::= { dnsResCounter 10 } 709 Document Expiration Date - March 7, 1993 - Saperia 17 710 dnsResCounterNonAuthNoDataResps OBJECT-TYPE 711 SYNTAX Counter 712 ACCESS read-only 713 STATUS mandatory 714 DESCRIPTION 715 "Number of requests made by the resolver for which a 716 non-authoritative answer - no such data response 717 (empty answer) was received." 718 ::= { dnsResCounter 11 } 720 dnsResCounterMartians OBJECT-TYPE 721 SYNTAX Counter 722 ACCESS read-only 723 STATUS mandatory 724 DESCRIPTION 725 "Number of responses received which were received from 726 servers that the resolver does not think it asked." 727 ::= { dnsResCounter 12 } 729 dnsResCounterRecdResponses OBJECT-TYPE 730 SYNTAX Counter 731 ACCESS read-only 732 STATUS mandatory 733 DESCRIPTION 734 "Number of responses received to all queries." 735 ::= { dnsResCounter 13 } 737 dnsResCounterDuplicates OBJECT-TYPE 738 SYNTAX Counter 739 ACCESS read-only 740 STATUS mandatory 741 DESCRIPTION 742 "Number of responses received which were duplicates and 743 ignored by the resolver." 744 ::= { dnsResCounter 14 } 746 18 Document Expiration Date - March 7, 1993 - Saperia 747 dnsResCounterUnparseResps OBJECT-TYPE 748 SYNTAX Counter 749 ACCESS read-only 750 STATUS mandatory 751 DESCRIPTION 752 "Number of responses received which were unparseable." 753 ::= { dnsResCounter 15 } 755 dnsResCounterRootAttempts OBJECT-TYPE 756 SYNTAX Counter 757 ACCESS read-only 758 STATUS mandatory 759 DESCRIPTION 760 "Number of attempts made by the resolver to connect 761 with root servers." 762 ::= { dnsResCounter 16 } 764 dnsResCounterReferals OBJECT-TYPE 765 SYNTAX Counter 766 ACCESS read-only 767 STATUS mandatory 768 DESCRIPTION 769 "Number of responses which were received from 770 servers redirecting query to another server." 771 ::= { dnsResCounter 17 } 773 dnsResCounterRetrans OBJECT-TYPE 774 SYNTAX Counter 775 ACCESS read-only 776 STATUS mandatory 777 DESCRIPTION 778 "Number requests retransmitted for all reasons." 779 ::= { dnsResCounter 18 } 781 Document Expiration Date - March 7, 1993 - Saperia 19 782 dnsResCounterNoResponses OBJECT-TYPE 783 SYNTAX Counter 784 ACCESS read-only 785 STATUS mandatory 786 DESCRIPTION 787 "Number of queries that were retransmitted because of 788 no response." 789 ::= { dnsResCounter 19 } 791 dnsResCounterRootRetrans OBJECT-TYPE 792 SYNTAX Counter 793 ACCESS read-only 794 STATUS mandatory 795 DESCRIPTION 796 "Number of queries that were retransmitted that were to 797 root servers." 798 ::= { dnsResCounter 20 } 800 dnsResCounterInternals OBJECT-TYPE 801 SYNTAX Counter 802 ACCESS read-only 803 STATUS mandatory 804 DESCRIPTION 805 "Number of requests internally generated by the 806 resolver." 807 ::= { dnsResCounter 21 } 809 dnsResCounterInternalTimeOuts OBJECT-TYPE 810 SYNTAX Counter 811 ACCESS read-only 812 STATUS mandatory 813 DESCRIPTION 814 "Number of requests internally generated which timed 815 out." 816 ::= { dnsResCounter 22 } 818 20 Document Expiration Date - March 7, 1993 - Saperia 819 -- Server Counter Group 821 -- The implementation of the Server Counter Group is mandatory for 822 -- all systems which offer either recursive or non recursive server 823 -- software functions. 825 -- Several of the objects in this group make distinctions between 826 -- queries which originate with the local host, within the same 827 -- zone as the local host or come from outside the zone of the 828 -- server. The purpose of these distinctions is to allow for 829 -- implementations to group queries and responses on this basis. 830 -- One way in which servers may make these distinctions is by 831 -- looking at the source IP address of the DNS query. If the 832 -- source of the query is 'your own' then the query should be 833 -- counted as 'yourself' - local host. If the source of the query 834 -- matches an 'access list' - the the query came from a friend, 835 -- that is; within the local zone. What constitutes an 'access 836 -- list' is implementation dependent and could be as simple as all 837 -- hosts on the same IP network as the DNS server are classed as in 838 -- the local zone and are 'friends'. In order to avoid double 839 -- counting, the following rules apply: 841 -- 1. No host is in more than one of the three groups defined above. 842 -- 2. All queries from the local host are always counted in the 843 -- 'yourself' group regardless of what the access list, if any, 844 -- says. 845 -- 3. The access list should not define 'your friends' in such a way 846 -- that it includes all hosts, that is 'not everybody is your 847 -- friend'. 849 Document Expiration Date - March 7, 1993 - Saperia 21 850 dnsServCounterUTime OBJECT-TYPE 851 SYNTAX DnsTime 852 ACCESS read-only 853 STATUS mandatory 854 DESCRIPTION 855 "If the server has a persistent state, e.g., a 856 process; this value will be the time elapsed since it 857 started. For software that does not have persistence, 858 this value will be 0." 859 ::= { dnsServCounter 1 } 861 dnsServCounterInUPkts OBJECT-TYPE 862 SYNTAX Counter 863 ACCESS read-only 864 STATUS mandatory 865 DESCRIPTION 866 "Number [total] of UDP packets received by the server." 867 ::= { dnsServCounter 2 } 869 dnsServCounterOutUPkts OBJECT-TYPE 870 SYNTAX Counter 871 ACCESS read-only 872 STATUS mandatory 873 DESCRIPTION 874 "Number [total] of UDP packets sent by the server." 875 ::= { dnsServCounter 3 } 877 dnsServCounterTCPConns OBJECT-TYPE 878 SYNTAX Counter 879 ACCESS read-only 880 STATUS mandatory 881 DESCRIPTION 882 "Number of TCP connections received by the server." 883 ::= { dnsServCounter 4 } 885 22 Document Expiration Date - March 7, 1993 - Saperia 886 dnsServCounterTCPInitiatns OBJECT-TYPE 887 SYNTAX Counter 888 ACCESS read-only 889 STATUS mandatory 890 DESCRIPTION 891 "Number of attempt to initiate TCP connections with 892 other servers." 893 ::= { dnsServCounter 5 } 895 dnsServCounterInTCPMesgs OBJECT-TYPE 896 SYNTAX Counter 897 ACCESS read-only 898 STATUS mandatory 899 DESCRIPTION 900 "Number of received DNS messages over TCP by the server." 901 ::= { dnsServCounter 6 } 903 dnsServCounterOutTCPMesgs OBJECT-TYPE 904 SYNTAX Counter 905 ACCESS read-only 906 STATUS mandatory 907 DESCRIPTION 908 "Number of out bound DNS messages over TCP sent by the 909 server." 910 ::= { dnsServCounter 7 } 912 dnsServCounterSelfAuthAns OBJECT-TYPE 913 SYNTAX Counter 914 ACCESS read-only 915 STATUS mandatory 916 DESCRIPTION 917 "Number of requests the server has processed with 918 authoritative data which originated from a resolver 919 on the same host." 920 ::= { dnsServCounter 8 } 922 Document Expiration Date - March 7, 1993 - Saperia 23 923 dnsServCounterSelfAuthNoNames OBJECT-TYPE 924 SYNTAX Counter 925 ACCESS read-only 926 STATUS mandatory 927 DESCRIPTION 928 "Number of requests the server has processed which 929 originated from a resolver on the same host for which 930 there has been an authoritative no such name answer 931 given." 932 ::= { dnsServCounter 9 } 934 dnsServCounterSelfAuthNoDataReqsts OBJECT-TYPE 935 SYNTAX Counter 936 ACCESS read-only 937 STATUS mandatory 938 DESCRIPTION 939 "Number of requests the server has processed which 940 originated from a resolver on the same host for which 941 there has been an authoritative no such data answer 942 (empty answer) made." 943 ::= { dnsServCounter 10 } 945 dnsServCounterSelfNonAuthDataReqsts OBJECT-TYPE 946 SYNTAX Counter 947 ACCESS read-only 948 STATUS mandatory 949 DESCRIPTION 950 "Number of requests the server has processed which 951 originated from a resolver on the same host for which 952 a non-authoritative answer (cached data) was made." 953 ::= { dnsServCounter 11 } 955 24 Document Expiration Date - March 7, 1993 - Saperia 956 dnsServCounterSelfNonAuthNoDataReqsts OBJECT-TYPE 957 SYNTAX Counter 958 ACCESS read-only 959 STATUS mandatory 960 DESCRIPTION 961 "Number of requests the server has processed which 962 originated from a resolver on the same host for which 963 a non-authoritative answer - no such data response was 964 made (empty answer)." 965 ::= { dnsServCounter 12 } 967 dnsServCounterSelfCAnyReqsts OBJECT-TYPE 968 SYNTAX Counter 969 ACCESS read-only 970 STATUS mandatory 971 DESCRIPTION 972 "Number of requests the server has processed which 973 originated from a resolver on the same host which 974 were answers to class=* queries." 975 ::= { dnsServCounter 13 } 977 dnsServCounterSelfIAnsReqsts OBJECT-TYPE 978 SYNTAX Counter 979 ACCESS read-only 980 STATUS mandatory 981 DESCRIPTION 982 "Number of inverse queries the server has processed which 983 originated from a resolver on the same host." 984 ::= { dnsServCounter 14 } 986 dnsServCounterSelfRefs OBJECT-TYPE 987 SYNTAX Counter 988 ACCESS read-only 989 STATUS mandatory 990 DESCRIPTION 991 "Number of queries the server has processed 992 which originated from a resolver on the same 993 host and were referred to other servers." 994 ::= { dnsServCounter 15 } 996 Document Expiration Date - March 7, 1993 - Saperia 25 997 dnsServCounterSelfErrors OBJECT-TYPE 998 SYNTAX Counter 999 ACCESS read-only 1000 STATUS mandatory 1001 DESCRIPTION 1002 "Number of requests the server has processed which 1003 originated from a resolver on the same host which 1004 have been answered with errors (RCODE values other 1005 than 0). RCODE values are defined in RFC1035." 1006 ::= { dnsServCounter 16 } 1008 dnsServCounterSelfRelNames OBJECT-TYPE 1009 SYNTAX Counter 1010 ACCESS read-only 1011 STATUS mandatory 1012 DESCRIPTION 1013 "Number of requests received for names that are only 1014 1 label long (text form - no internal dots) the 1015 server has processed which originated from a resolver 1016 on the same host." 1017 ::= { dnsServCounter 17 } 1019 dnsServCounterFriendsAuthAns OBJECT-TYPE 1020 SYNTAX Counter 1021 ACCESS read-only 1022 STATUS mandatory 1023 DESCRIPTION 1024 "Number of queries originating from friends which 1025 were authoritatively answered. The definition of 1026 friends is a locally defined matter." 1027 ::= { dnsServCounter 18 } 1029 26 Document Expiration Date - March 7, 1993 - Saperia 1030 dnsServCounterFriendsNoSuchNames OBJECT-TYPE 1031 SYNTAX Counter 1032 ACCESS read-only 1033 STATUS mandatory 1034 DESCRIPTION 1035 "Number of queries originating from friends, for 1036 which authoritative no such name (NXDOMAIN) responses 1037 were made. The definition of friends is a locally 1038 defined matter." 1039 ::= { dnsServCounter 19 } 1041 dnsServCounterFriendsZoneNoDataResps OBJECT-TYPE 1042 SYNTAX Counter 1043 ACCESS read-only 1044 STATUS mandatory 1045 DESCRIPTION 1046 "Number of queries originating from friends for 1047 which authoritative no such data (empty answer) 1048 responses were made. The definition of friends is 1049 a locally defined matter." 1050 ::= { dnsServCounter 20 } 1052 dnsServCounterFriendsNonAuthDatas OBJECT-TYPE 1053 SYNTAX Counter 1054 ACCESS read-only 1055 STATUS mandatory 1056 DESCRIPTION 1057 "Number of queries originating from friends which 1058 were non-authoritatively answered (cached data). 1059 The definition of friends is a locally defined matter." 1060 ::= { dnsServCounter 21 } 1062 Document Expiration Date - March 7, 1993 - Saperia 27 1063 dnsServCounterFriendsNonAuthNoDatas OBJECT-TYPE 1064 SYNTAX Counter 1065 ACCESS read-only 1066 STATUS mandatory 1067 DESCRIPTION 1068 "Number of queries originating from friends which 1069 were non-authoritatively answered with no such data 1070 (empty answer)." 1071 ::= { dnsServCounter 22 } 1073 dnsServCounterFriendsCAnys OBJECT-TYPE 1074 SYNTAX Counter 1075 ACCESS read-only 1076 STATUS mandatory 1077 DESCRIPTION 1078 "Number of answers to class=* queries which originated 1079 from friends. The definition of friends is a locally 1080 defined matter." 1081 ::= { dnsServCounter 23 } 1083 dnsServCounterFriendsInverses OBJECT-TYPE 1084 SYNTAX Counter 1085 ACCESS read-only 1086 STATUS mandatory 1087 DESCRIPTION 1088 "Number of responses to inverse queries which originated 1089 from friends. The definition of friends is a locally 1090 defined matter." 1091 ::= { dnsServCounter 24 } 1093 dnsServCounterFriendsRefs OBJECT-TYPE 1094 SYNTAX Counter 1095 ACCESS read-only 1096 STATUS mandatory 1097 DESCRIPTION 1098 "Number of requests which originated from friends 1099 that were forwarded to other servers. The definition 1100 of friends is a locally defined matter." 1101 ::= { dnsServCounter 25 } 1103 28 Document Expiration Date - March 7, 1993 - Saperia 1104 dnsServCounterFriendsErrors OBJECT-TYPE 1105 SYNTAX Counter 1106 ACCESS read-only 1107 STATUS mandatory 1108 DESCRIPTION 1109 "Number of requests the server has processed which 1110 originated from friends and were answered with errors 1111 (RCODE values other than 0). RCODE values are defined 1112 in RFC1035. The definition of friends is a locally 1113 defined matter." 1114 ::= { dnsServCounter 26 } 1116 dnsServCounterFriendsRels OBJECT-TYPE 1117 SYNTAX Counter 1118 ACCESS read-only 1119 STATUS mandatory 1120 DESCRIPTION 1121 "Number of requests received for names from friends 1122 that are only 1 label long (text form - no internal 1123 dots) the server has processed." 1124 ::= { dnsServCounter 27 } 1126 dnsServCounterRemoteAuthAns OBJECT-TYPE 1127 SYNTAX Counter 1128 ACCESS read-only 1129 STATUS mandatory 1130 DESCRIPTION 1131 "Number of queries originating from systems which have 1132 not been defined as friends, which were 1133 authoritatively answered." 1134 ::= { dnsServCounter 28 } 1136 Document Expiration Date - March 7, 1993 - Saperia 29 1137 dnsServCounterRemoteNoNames OBJECT-TYPE 1138 SYNTAX Counter 1139 ACCESS read-only 1140 STATUS mandatory 1141 DESCRIPTION 1142 "Number of queries originating from systems which 1143 have not been defined as friends, for which 1144 authoritative no such name responses were made." 1145 ::= { dnsServCounter 29 } 1147 dnsServCounterRemoteNoDataResps OBJECT-TYPE 1148 SYNTAX Counter 1149 ACCESS read-only 1150 STATUS mandatory 1151 DESCRIPTION 1152 "Number of queries originating from systems which 1153 have not been defined as friends, for which 1154 authoritative no such data (empty answer) 1155 responses were made." 1156 ::= { dnsServCounter 30 } 1158 dnsServCounterRemoteNonAuthDatas OBJECT-TYPE 1159 SYNTAX Counter 1160 ACCESS read-only 1161 STATUS mandatory 1162 DESCRIPTION 1163 "Number of queries originating from systems which 1164 have not been defined as friends, which were 1165 non-authoritatively answered (cached data)." 1166 ::= { dnsServCounter 31 } 1168 30 Document Expiration Date - March 7, 1993 - Saperia 1169 dnsServCounterRemoteNonAuthNoDatas OBJECT-TYPE 1170 SYNTAX Counter 1171 ACCESS read-only 1172 STATUS mandatory 1173 DESCRIPTION 1174 "Number of queries originating from systems which 1175 have not been defined as friends, which were 1176 non-authoritatively answered with no data 1177 (empty answer)." 1178 ::= { dnsServCounter 32 } 1180 dnsServCounterRemoteCAnyResps OBJECT-TYPE 1181 SYNTAX Counter 1182 ACCESS read-only 1183 STATUS mandatory 1184 DESCRIPTION 1185 "Number of answers to class=* queries which originated 1186 from systems which have not been defined as friends." 1187 ::= { dnsServCounter 33 } 1189 dnsServCounterRemoteInverses OBJECT-TYPE 1190 SYNTAX Counter 1191 ACCESS read-only 1192 STATUS mandatory 1193 DESCRIPTION 1194 "Number of answers to inverse queries which originated 1195 from systems which have not been defined as friends." 1196 ::= { dnsServCounter 34 } 1198 dnsServCounterRemoteRefs OBJECT-TYPE 1199 SYNTAX Counter 1200 ACCESS read-only 1201 STATUS mandatory 1202 DESCRIPTION 1203 "Number of requests which originated from systems which 1204 have not been defined as friends that were forwarded to 1205 other servers." 1206 ::= { dnsServCounter 35 } 1208 Document Expiration Date - March 7, 1993 - Saperia 31 1209 dnsServCounterRemoteErrors OBJECT-TYPE 1210 SYNTAX Counter 1211 ACCESS read-only 1212 STATUS mandatory 1213 DESCRIPTION 1214 "Number of requests the server has processed which 1215 originated from systems which have not been defined as 1216 friends that were answered with errors (RCODE values other 1217 than 0). RCODE values are defined in RFC1035." 1218 ::= { dnsServCounter 36 } 1220 dnsServCounterRemoteRelNames OBJECT-TYPE 1221 SYNTAX Counter 1222 ACCESS read-only 1223 STATUS mandatory 1224 DESCRIPTION 1225 "Number of requests received by the server which originated 1226 from systems which have not been defined as friends for 1227 names that are only 1 label long (text form - no 1228 internal dots)." 1229 ::= { dnsServCounter 37 } 1231 dnsServCounterReqRefs OBJECT-TYPE 1232 SYNTAX Counter 1233 ACCESS read-only 1234 STATUS mandatory 1235 DESCRIPTION 1236 "Number of DNS requests refused by the server process." 1237 ::= { dnsServCounter 38 } 1239 dnsServCounterReqUnparses OBJECT-TYPE 1240 SYNTAX Counter 1241 ACCESS read-only 1242 STATUS mandatory 1243 DESCRIPTION 1244 "Number of requests received which were unparseable." 1245 ::= { dnsServCounter 39 } 1247 32 Document Expiration Date - March 7, 1993 - Saperia 1248 dnsServCounterLocalErrors OBJECT-TYPE 1249 SYNTAX Counter 1250 ACCESS read-only 1251 STATUS mandatory 1252 DESCRIPTION 1253 "Number of requests which were aborted for other 1254 (local) server errors." 1255 ::= { dnsServCounter 40 } 1257 dnsServCounterDuplicates OBJECT-TYPE 1258 SYNTAX Counter 1259 ACCESS read-only 1260 STATUS mandatory 1261 DESCRIPTION 1262 "Number of duplicate requests which were received and 1263 not forwarded." 1264 ::= { dnsServCounter 41 } 1266 dnsServCounterRelRemotes OBJECT-TYPE 1267 SYNTAX Counter 1268 ACCESS read-only 1269 STATUS mandatory 1270 DESCRIPTION 1271 "Number of requests received for names that are only 1272 1 label long (text form - no internal dots) the 1273 server has processed relative names from hosts 1274 outside of the server zone." 1275 ::= { dnsServCounter 42 } 1277 -- DNS Server Counter Table 1279 dnsServCounterTable OBJECT-TYPE 1280 SYNTAX SEQUENCE OF DnsServCounterEntry 1281 ACCESS not-accessible 1282 STATUS mandatory 1283 DESCRIPTION 1284 "Counter information based on DNS class and 1285 record type." 1286 ::= { dnsServCounter 43 } 1288 Document Expiration Date - March 7, 1993 - Saperia 33 1289 dnsServCounterEntry OBJECT-TYPE 1290 SYNTAX DnsServCounterEntry 1291 ACCESS not-accessible 1292 STATUS mandatory 1293 DESCRIPTION 1294 "This table contains count information for each DNS 1295 record and class type known to the server. The index 1296 allows management software to to create indices to the 1297 table to get the specific information desired, e.g., 1298 number or A record queries over UDP which came to this 1299 server from a specific IP address." 1300 INDEX { dnsServCounterOpCode, dnsServCounterQClass, 1301 dnsServCounterQueryType, dnsServCounterQuerySource, 1302 dnsServCounterTransport } 1303 ::= { dnsServCounterTable 1 } 1305 DnsServCounterEntry ::= 1306 SEQUENCE { 1307 dnsServCounterOpCode 1308 DnsOpCode, 1309 dnsServCounterQClass 1310 DnsClass, 1311 dnsServCounterQueryType 1312 DnsType, 1313 dnsServCounterQuerySource 1314 INTEGER, 1315 dnsServCounterTransport 1316 INTEGER, 1317 dnsServCounterNumbers 1318 Counter, 1319 dnsServCounterResponses 1320 Counter 1321 } 1322 dnsServCounterOpCode OBJECT-TYPE 1323 SYNTAX DnsOpCode -- INTEGER (0..15) 1324 ACCESS read-only 1325 STATUS mandatory 1326 DESCRIPTION 1328 34 Document Expiration Date - March 7, 1993 - Saperia 1329 "The DNS OpCode which applies to this row of the table." 1330 ::= { dnsServCounterEntry 1 } 1332 dnsServCounterQClass OBJECT-TYPE 1333 SYNTAX DnsClass -- INTEGER (0..65535) 1334 ACCESS read-only 1335 STATUS mandatory 1336 DESCRIPTION 1337 "The QCLASS of the record type being counted in 1338 this row the table." 1339 ::= { dnsServCounterEntry 2 } 1341 dnsServCounterQueryType OBJECT-TYPE 1342 SYNTAX DnsType -- INTEGER (0..65535) 1343 ACCESS read-only 1344 STATUS mandatory 1345 DESCRIPTION 1346 "The type of record which is being counted in this row 1347 in the table." 1348 ::= { dnsServCounterEntry 3 } 1350 dnsServCounterQuerySource OBJECT-TYPE 1351 SYNTAX INTEGER { 1352 self (1), 1353 friend (2), 1354 remote (3) 1355 } 1356 ACCESS read-only 1357 STATUS mandatory 1358 DESCRIPTION 1359 "The source of the queries being counted in this row of 1360 the table. A value of 1 indicates that the queries reported 1361 on this row came from a resolver which resides on the same 1362 system as the server. A value of 2 indicates the 1363 queries originated from friends of the server - the 1364 definition of friends is a locally defined matter. A 1365 value of 3 indicates that the queries counted on this 1366 row of the table came from systems which have not been 1367 defined as friends." 1369 Document Expiration Date - March 7, 1993 - Saperia 35 1370 ::= { dnsServCounterEntry 4 } 1372 dnsServCounterTransport OBJECT-TYPE 1373 SYNTAX INTEGER { 1374 udp (1), 1375 tcp (2), 1376 other (3) 1377 } 1378 ACCESS read-only 1379 STATUS mandatory 1380 DESCRIPTION 1381 "A value of 1 indicates that the queries reported on 1382 this row were sent using UDP. A value of 2 indicates 1383 that TCP was used. 3 is for any transport other than 1384 TCP or UDP." 1385 ::= { dnsServCounterEntry 5 } 1387 dnsServCounterNumbers OBJECT-TYPE 1388 SYNTAX Counter 1389 ACCESS read-only 1390 STATUS mandatory 1391 DESCRIPTION 1392 "Number of queries that have been recorded in this row 1393 of the table." 1394 ::= { dnsServCounterEntry 6 } 1396 dnsServCounterResponses OBJECT-TYPE 1397 SYNTAX Counter 1398 ACCESS read-only 1399 STATUS mandatory 1400 DESCRIPTION 1401 "Number of responses made by the server since 1402 initialization for the type of query identified 1403 on this row of the table." 1404 ::= { dnsServCounterEntry 7 } 1406 36 Document Expiration Date - March 7, 1993 - Saperia 1407 -- Records Group 1409 -- The implementation of the Records Group is mandatory for all 1410 -- systems which implement DNS server software functions. 1412 -- Records Table 1414 -- The records table contains information about records that the 1415 -- the DNS software reads at initialization. 1417 dnsRecTable OBJECT-TYPE 1418 SYNTAX SEQUENCE OF DnsRecEntry 1419 ACCESS not-accessible 1420 STATUS mandatory 1421 DESCRIPTION 1422 "Configuration information about all RR records for the 1423 DNS software." 1424 ::= { dnsRec 1 } 1426 dnsRecEntry OBJECT-TYPE 1427 SYNTAX DnsRecEntry 1428 ACCESS not-accessible 1429 STATUS mandatory 1430 DESCRIPTION 1431 "This table contains Resource Record configuration 1432 information." 1433 INDEX { dnsRecZoneName, dnsRecZoneClass, dnsRecName, 1434 dnsRecType, dnsRecIndex } 1435 ::= { dnsRecTable 1 } 1437 Document Expiration Date - March 7, 1993 - Saperia 37 1438 DnsRecEntry ::= 1439 SEQUENCE { 1440 dnsRecZoneName 1441 DnsName, 1442 dnsRecZoneClass 1443 DnsClass, 1444 dnsRecName 1445 DnsName, 1446 dnsRecType 1447 DnsType, 1448 dnsRecTTL 1449 INTEGER, 1450 dnsRecData 1451 OCTET STRING, 1452 dnsRecIndex 1453 INTEGER, 1454 dnsRecHits 1455 Counter 1456 } 1457 dnsRecZoneName OBJECT-TYPE 1458 SYNTAX DnsName -- OCTET STRING 1459 ACCESS read-only 1460 STATUS mandatory 1461 DESCRIPTION 1462 "The DNS name of the zone which contains the authoritative 1463 record described by this row of the table." 1464 ::= { dnsRecEntry 1 } 1466 dnsRecZoneClass OBJECT-TYPE 1467 SYNTAX DnsClass -- INTEGER (0..65535) 1468 ACCESS read-only 1469 STATUS mandatory 1470 DESCRIPTION 1471 "The class of the zone contained in this row. For 1472 classes defined in RFC 1035, the values are the same." 1473 ::= { dnsRecEntry 2 } 1475 38 Document Expiration Date - March 7, 1993 - Saperia 1476 dnsRecName OBJECT-TYPE 1477 SYNTAX DnsName -- OCTET STRING 1478 ACCESS read-only 1479 STATUS mandatory 1480 DESCRIPTION 1481 "The name of the owner of the resource record described 1482 in this row of the table. This will be the name of the 1483 node, about which this resource record applies." 1484 ::= { dnsRecEntry 3 } 1486 dnsRecType OBJECT-TYPE 1487 SYNTAX DnsType -- INTEGER (0..65535) 1488 ACCESS read-only 1489 STATUS mandatory 1490 DESCRIPTION 1491 "The type of the record contained in this row. For 1492 types defined in RFC 1035, the values are the same." 1493 ::= { dnsRecEntry 4 } 1495 dnsRecTTL OBJECT-TYPE 1496 SYNTAX INTEGER 1497 ACCESS read-only 1498 STATUS mandatory 1499 DESCRIPTION 1500 "The default Time to Live value for this record which 1501 is read in on initialization." 1502 ::= { dnsRecEntry 5 } 1504 dnsRecData OBJECT-TYPE 1505 SYNTAX OCTET STRING 1506 ACCESS read-only 1507 STATUS mandatory 1508 DESCRIPTION 1509 "Variable length of octets. Type and Class information 1510 provided in this row of the table along with this data 1511 tell the management station how to interpret the Record. 1512 For information on the details of DNS Resource Records 1513 and their formats, see RFC1035." 1514 ::= { dnsRecEntry 6 } 1516 Document Expiration Date - March 7, 1993 - Saperia 39 1517 dnsRecIndex OBJECT-TYPE 1518 SYNTAX INTEGER 1519 ACCESS read-only 1520 STATUS mandatory 1521 DESCRIPTION 1522 "A unique index value which identifies each entry in 1523 this table." 1524 ::= { dnsRecEntry 7 } 1526 dnsRecHits OBJECT-TYPE 1527 SYNTAX Counter 1528 ACCESS read-only 1529 STATUS mandatory 1530 DESCRIPTION 1531 "Number of hits the server has had on the resource record 1532 defined in this row of the table." 1533 ::= { dnsRecEntry 8 } 1535 -- Resolver Cache Group 1537 -- The implementation of the Resolver Cache Group is mandatory for 1538 -- all systems which implement a cache. 1540 dnsResCacheStatus OBJECT-TYPE 1541 SYNTAX INTEGER { 1542 enabled (1), 1543 disabled (2) 1544 } 1545 ACCESS read-only 1546 STATUS mandatory 1547 DESCRIPTION 1548 "Status of the resolver's cache. 1549 ENABLED means that the use of the cache is allowed. 1550 DISABLED means that the cache is not being used." 1551 ::= { dnsResCache 1 } 1553 40 Document Expiration Date - March 7, 1993 - Saperia 1554 dnsResCacheValid OBJECT-TYPE 1555 SYNTAX DnsValid 1556 ACCESS read-write 1557 STATUS mandatory 1558 DESCRIPTION 1559 "Setting this to CLEAR deletes the resolver's entire 1560 cache." 1561 ::= { dnsResCache 2 } 1563 dnsResCacheMaxTTL OBJECT-TYPE 1564 SYNTAX INTEGER 1565 ACCESS read-write 1566 STATUS mandatory 1567 DESCRIPTION 1568 "Maximum Time-To-Live for RRs in this cache. If the 1569 resolver does not implement a TTL ceiling, the value of 1570 this field should be hexadecimal FFFFFFFF." 1571 ::= { dnsResCache 3 } 1573 -- Resolver Cache Table 1575 -- The Resolver Cache Table contains information about Resource 1576 -- Records currently in the resolver's cache. 1578 dnsResCacheTable OBJECT-TYPE 1579 SYNTAX SEQUENCE OF DnsResCacheEntry 1580 ACCESS not-accessible 1581 STATUS mandatory 1582 DESCRIPTION 1583 "The entire contents of the resolver's cache." 1584 ::= { dnsResCache 4 } 1586 Document Expiration Date - March 7, 1993 - Saperia 41 1587 dnsResCacheEntry OBJECT-TYPE 1588 SYNTAX DnsResCacheEntry 1589 ACCESS not-accessible 1590 STATUS mandatory 1591 DESCRIPTION 1592 "A single entry in the resolvers's cache." 1593 INDEX { dnsResCacheRRName, dnsResCacheRRClass, 1594 dnsResCacheRRType, dnsResCacheRRIndex } 1595 ::= { dnsResCacheTable 1 } 1597 DnsResCacheEntry ::= 1598 SEQUENCE { 1599 dnsResCacheRRName 1600 DnsName, 1601 dnsResCacheRRClass 1602 DnsClass, 1603 dnsResCacheRRType 1604 DnsType, 1605 dnsResCacheRRTTL 1606 DnsTime, 1607 dnsResCacheRRElapsedTTL 1608 DnsTime, 1609 dnsResCacheRRSource 1610 IpAddress, 1611 dnsResCacheRRRData 1612 OCTET STRING, 1613 dnsResCacheRRValid 1614 DnsValid, 1615 dnsResCacheRRIndex 1616 INTEGER 1617 } 1618 dnsResCacheRRName OBJECT-TYPE 1619 SYNTAX DnsName -- OCTET STRING 1620 ACCESS read-only 1621 STATUS mandatory 1622 DESCRIPTION 1623 "Owner name of the Resource Record in the cache which 1624 is identified in this row of the table. As described 1626 42 Document Expiration Date - March 7, 1993 - Saperia 1627 in RFC1034, the owner of the record is the domain name 1628 were the RR is found." 1629 ::= { dnsResCacheEntry 1 } 1631 dnsResCacheRRClass OBJECT-TYPE 1632 SYNTAX DnsClass -- INTEGER (0..65535) 1633 ACCESS read-only 1634 STATUS mandatory 1635 DESCRIPTION 1636 "DNS class of the Resource Record in the cache which 1637 is identified in this row of the table." 1638 ::= { dnsResCacheEntry 2 } 1640 dnsResCacheRRType OBJECT-TYPE 1641 SYNTAX DnsType -- INTEGER (0..65535) 1642 ACCESS read-only 1643 STATUS mandatory 1644 DESCRIPTION 1645 "DNS type of the Resource Record in the cache which 1646 is identified in this row of the table." 1647 ::= { dnsResCacheEntry 3 } 1649 dnsResCacheRRTTL OBJECT-TYPE 1650 SYNTAX DnsTime 1651 ACCESS read-only 1652 STATUS mandatory 1653 DESCRIPTION 1654 "Time-To-Live of RR in DNS cache. This is the initial 1655 TTL value which was received with the RR when it was 1656 originally received." 1657 ::= { dnsResCacheEntry 4 } 1659 dnsResCacheRRElapsedTTL OBJECT-TYPE 1660 SYNTAX DnsTime 1661 ACCESS read-only 1662 STATUS mandatory 1663 DESCRIPTION 1664 "Elapsed seconds since RR was received." 1665 ::= { dnsResCacheEntry 5 } 1667 Document Expiration Date - March 7, 1993 - Saperia 43 1668 dnsResCacheRRSource OBJECT-TYPE 1669 SYNTAX IpAddress 1670 ACCESS read-only 1671 STATUS mandatory 1672 DESCRIPTION 1673 "Host from which RR was received, 0.0.0.0 if unknown." 1674 ::= { dnsResCacheEntry 6 } 1676 dnsResCacheRRRData OBJECT-TYPE 1677 SYNTAX OCTET STRING 1678 ACCESS read-only 1679 STATUS mandatory 1680 DESCRIPTION 1681 "RDATA portion of a cached RR." 1682 ::= { dnsResCacheEntry 7 } 1684 dnsResCacheRRValid OBJECT-TYPE 1685 SYNTAX DnsValid 1686 ACCESS read-write 1687 STATUS mandatory 1688 DESCRIPTION 1689 "Set to CLEAR to delete this RR entry from the 1690 cache table." 1691 ::= { dnsResCacheEntry 8 } 1693 dnsResCacheRRIndex OBJECT-TYPE 1694 SYNTAX INTEGER 1695 ACCESS read-only 1696 STATUS mandatory 1697 DESCRIPTION 1698 "A unique index value which indentifies each entry in 1699 this table." 1700 ::= { dnsResCacheEntry 9 } 1702 44 Document Expiration Date - March 7, 1993 - Saperia 1703 -- Resolver Negative Cache Group 1705 -- The implementation of the Resolver Negative Cache group is 1706 -- mandatory for all systems which implement negative a negative 1707 -- cache function. 1709 dnsResNCacheStatus OBJECT-TYPE 1710 SYNTAX INTEGER { 1711 enabled (1), 1712 disabled (2) 1713 } 1714 ACCESS read-only 1715 STATUS mandatory 1716 DESCRIPTION 1717 "Status of the resolver's negative cache. 1718 ENABLED means that the use of the negative cache is 1719 allowed. 1720 DISABLED means that the negative caching is not being 1721 used." 1722 ::= { dnsResNCache 1 } 1724 dnsResNCacheValid OBJECT-TYPE 1725 SYNTAX DnsValid 1726 ACCESS read-write 1727 STATUS mandatory 1728 DESCRIPTION 1729 "Setting this to CLEAR deletes the resolver's entire 1730 negative response cache." 1731 ::= { dnsResNCache 2 } 1733 dnsResNCacheMaxTTL OBJECT-TYPE 1734 SYNTAX INTEGER 1735 ACCESS read-write 1736 STATUS mandatory 1737 DESCRIPTION 1738 "Maximum Time-To-Live for cached authoritative errors. 1739 If the resolver does not implement a TTL ceiling, the 1740 value of this field should be hexadecimal FFFFFFFF." 1741 ::= { dnsResNCache 3 } 1743 Document Expiration Date - March 7, 1993 - Saperia 45 1744 -- Resolver Negative Cache Table 1746 -- The Resolver Negative Cache Table contains information about 1747 -- Resource Records currently in the resolver's cache. 1749 dnsResNCacheTable OBJECT-TYPE 1750 SYNTAX SEQUENCE OF DnsResNCacheEntry 1751 ACCESS not-accessible 1752 STATUS mandatory 1753 DESCRIPTION 1754 "The resolver's negative response cache." 1755 ::= { dnsResNCache 4 } 1757 dnsResNCacheEntry OBJECT-TYPE 1758 SYNTAX DnsResNCacheEntry 1759 ACCESS not-accessible 1760 STATUS mandatory 1761 DESCRIPTION 1762 "An entry in the resolver's negative response cache." 1763 INDEX { dnsResNCacheErrQName, dnsResNCacheErrQClass, 1764 dnsResNCacheErrQType, dnsResNCacheIndex } 1765 ::= { dnsResNCacheTable 1 } 1767 DnsResNCacheEntry ::= 1768 SEQUENCE { 1769 dnsResNCacheErrQName 1770 DnsName, 1771 dnsResNCacheErrQClass 1772 DnsQClass, 1773 dnsResNCacheErrQType 1774 DnsQType, 1775 dnsResNCacheErrTTL 1776 DnsTime, 1777 dnsResNCacheErrElapsedTTL 1778 DnsTime, 1779 dnsResNCacheErrSource 1780 IpAddress, 1781 dnsResNCacheErrCode 1782 INTEGER, 1783 dnsResNCacheErrValid 1785 46 Document Expiration Date - March 7, 1993 - Saperia 1786 DnsValid, 1787 dnsResNCacheIndex 1788 INTEGER 1789 } 1790 dnsResNCacheErrQName OBJECT-TYPE 1791 SYNTAX DnsName -- OCTET STRING 1792 ACCESS read-only 1793 STATUS mandatory 1794 DESCRIPTION 1795 "QNAME associated with a cached authoritative error." 1796 ::= { dnsResNCacheEntry 1 } 1798 dnsResNCacheErrQClass OBJECT-TYPE 1799 SYNTAX DnsQClass -- INTEGER (0..65535) 1800 ACCESS read-only 1801 STATUS mandatory 1802 DESCRIPTION 1803 "DNS QCLASS associated with a cached authoritative error." 1804 ::= { dnsResNCacheEntry 2 } 1806 dnsResNCacheErrQType OBJECT-TYPE 1807 SYNTAX DnsQType -- INTEGER (0..65535) 1808 ACCESS read-only 1809 STATUS mandatory 1810 DESCRIPTION 1811 "DNS QTYPE associated with a cached authoritative error." 1812 ::= { dnsResNCacheEntry 3 } 1814 dnsResNCacheErrTTL OBJECT-TYPE 1815 SYNTAX DnsTime 1816 ACCESS read-only 1817 STATUS mandatory 1818 DESCRIPTION 1819 "Time-To-Live of a cached authoritative error. 1820 This should be the TTL as copied from the MINIMUM 1821 field of the SOA that accompanied the authoritative 1822 error." 1823 ::= { dnsResNCacheEntry 4 } 1825 Document Expiration Date - March 7, 1993 - Saperia 47 1826 dnsResNCacheErrElapsedTTL OBJECT-TYPE 1827 SYNTAX DnsTime 1828 ACCESS read-only 1829 STATUS mandatory 1830 DESCRIPTION 1831 "Elapsed seconds since authoritative error was received." 1832 ::= { dnsResNCacheEntry 5 } 1834 dnsResNCacheErrSource OBJECT-TYPE 1835 SYNTAX IpAddress 1836 ACCESS read-only 1837 STATUS mandatory 1838 DESCRIPTION 1839 "Host which sent the authoritative error, 0.0.0.0 if 1840 unknown." 1841 ::= { dnsResNCacheEntry 6 } 1843 dnsResNCacheErrCode OBJECT-TYPE 1844 SYNTAX INTEGER { 1845 nonexistantName (1), 1846 noData (2), 1847 other (3) 1848 } 1849 ACCESS read-only 1850 STATUS mandatory 1851 DESCRIPTION 1852 "The authoritative error that has been cached. 1853 NonexistantName indicates a cached authoritative name 1854 error. NoData indicates a cached authoritative 1855 response with no error and no relevant data." 1856 ::= { dnsResNCacheEntry 7 } 1858 dnsResNCacheErrValid OBJECT-TYPE 1859 SYNTAX DnsValid 1860 ACCESS read-write 1861 STATUS mandatory 1862 DESCRIPTION 1863 "Set to CLEAR to delete this cached error." 1864 ::= { dnsResNCacheEntry 8 } 1866 48 Document Expiration Date - March 7, 1993 - Saperia 1867 dnsResNCacheIndex OBJECT-TYPE 1868 SYNTAX INTEGER 1869 ACCESS read-only 1870 STATUS mandatory 1871 DESCRIPTION 1872 "A unique index value which indentifies each entry in 1873 the Negative Cache table." 1874 ::= { dnsResNCacheEntry 9 } 1876 -- Resolver Statistics Group 1878 -- The implementation of the Resolver Statistics Group is 1879 -- mandatory for all systems which implement resolver functions. 1881 dnsResStatGoodCaches OBJECT-TYPE 1882 SYNTAX Counter 1883 ACCESS read-only 1884 STATUS mandatory 1885 DESCRIPTION 1886 "Number of RRs the resolver has cached successfully." 1887 ::= { dnsResStats 1 } 1889 dnsResStatBadCaches OBJECT-TYPE 1890 SYNTAX Counter 1891 ACCESS read-only 1892 STATUS mandatory 1893 DESCRIPTION 1894 "Number of RRs the resolver has refused to cache 1895 because they appear to be dangerous or irrelevant. 1896 Eg, RRs with suspiciously high TTLs, unsolicited root 1897 information, or that just don't appear to be relevant 1898 to the question the resolver asked." 1899 ::= { dnsResStats 2 } 1901 Document Expiration Date - March 7, 1993 - Saperia 49 1902 dnsResStatGoodNCaches OBJECT-TYPE 1903 SYNTAX Counter 1904 ACCESS read-only 1905 STATUS mandatory 1906 DESCRIPTION 1907 "Number of authoritative errors the resolver has cached 1908 successfully." 1909 ::= { dnsResStats 3 } 1911 dnsResStatBadNCaches OBJECT-TYPE 1912 SYNTAX Counter 1913 ACCESS read-only 1914 STATUS mandatory 1915 DESCRIPTION 1916 "Number of authoritative errors the resolver would 1917 have liked to cache but was unable to because the 1918 appropriate SOA RR was not supplied or looked 1919 suspicious." 1920 ::= { dnsResStats 4 } 1922 -- Lame Delegation Table 1924 dnsResLameDelegationTable OBJECT-TYPE 1925 SYNTAX SEQUENCE OF DnsResLameDelegationEntry 1926 ACCESS not-accessible 1927 STATUS mandatory 1928 DESCRIPTION 1929 "Table of name servers returning lame delegations." 1930 ::= { dnsResStats 5 } 1932 dnsResLameDelegationEntry OBJECT-TYPE 1933 SYNTAX DnsResLameDelegationEntry 1934 ACCESS not-accessible 1935 STATUS mandatory 1936 DESCRIPTION 1937 "Entry in lame delegation table." 1938 INDEX { dnsResLameDelegationSource, 1939 dnsResLameDelegationName, 1940 dnsResLameDelegationClass } 1941 ::= { dnsResLameDelegationTable 1 } 1943 50 Document Expiration Date - March 7, 1993 - Saperia 1944 DnsResLameDelegationEntry ::= 1945 SEQUENCE { 1946 dnsResLameDelegationSource 1947 IpAddress, 1948 dnsResLameDelegationName 1949 DnsName, 1950 dnsResLameDelegationClass 1951 DnsClass, 1952 dnsResLameCountDelegations 1953 Counter, 1954 dnsResLameDelegationValid 1955 DnsValid 1956 } 1957 dnsResLameDelegationSource OBJECT-TYPE 1958 SYNTAX IpAddress 1959 ACCESS read-only 1960 STATUS mandatory 1961 DESCRIPTION 1962 "Source of lame delegation." 1963 ::= { dnsResLameDelegationEntry 1 } 1965 dnsResLameDelegationName OBJECT-TYPE 1966 SYNTAX DnsName 1967 ACCESS read-only 1968 STATUS mandatory 1969 DESCRIPTION 1970 "DNS name for which lame delegation was received." 1971 ::= { dnsResLameDelegationEntry 2 } 1973 dnsResLameDelegationClass OBJECT-TYPE 1974 SYNTAX DnsClass -- INTEGER (0..65535) 1975 ACCESS read-only 1976 STATUS mandatory 1977 DESCRIPTION 1978 "DNS class of received lame delegation." 1979 ::= { dnsResLameDelegationEntry 3 } 1981 Document Expiration Date - March 7, 1993 - Saperia 51 1982 dnsResLameCountDelegations OBJECT-TYPE 1983 SYNTAX Counter 1984 ACCESS read-only 1985 STATUS mandatory 1986 DESCRIPTION 1987 "How many times this lame delegation has been received." 1988 ::= { dnsResLameDelegationEntry 4 } 1990 dnsResLameDelegationValid OBJECT-TYPE 1991 SYNTAX DnsValid 1992 ACCESS read-write 1993 STATUS mandatory 1994 DESCRIPTION 1995 "Set to CLEAR to delete this lame delegation entry." 1996 ::= { dnsResLameDelegationEntry 5 } 1998 -- Server Management Group 2000 -- The implementation of the Server Management Group is mandatory 2001 -- for all systems which implement DNS server software functions. 2003 dnsMgmtVersion OBJECT-TYPE 2004 SYNTAX DisplayString 2005 ACCESS read-only 2006 STATUS mandatory 2007 DESCRIPTION 2008 "Name and version information for name server software." 2009 ::= { dnsMgmt 1 } 2011 52 Document Expiration Date - March 7, 1993 - Saperia 2012 dnsMgmtReload OBJECT-TYPE 2013 SYNTAX INTEGER { 2014 reload (1), 2015 other (2) 2016 } 2017 ACCESS read-write 2018 STATUS mandatory 2019 DESCRIPTION 2020 "This read-write variable is used to force a database 2021 reload with a restart of the name server process 2022 When set to the values above, the following actions 2023 are taken: reload - Reload and restart name server 2024 process(s). Other is returned when a read operation 2025 is performed on this object." 2026 ::= { dnsMgmt 2 } 2028 -- DNS Managment Zone Configuration Table 2030 dnsMgmtZoneTable OBJECT-TYPE 2031 SYNTAX SEQUENCE OF DnsMgmtZoneEntry 2032 ACCESS not-accessible 2033 STATUS mandatory 2034 DESCRIPTION 2035 "Table of zones for which this name server is 2036 configured. If name server doesn't load any zones, 2037 this table is empty." 2038 ::= { dnsMgmt 3 } 2040 dnsMgmtZoneEntry OBJECT-TYPE 2041 SYNTAX DnsMgmtZoneEntry 2042 ACCESS not-accessible 2043 STATUS mandatory 2044 DESCRIPTION 2045 "An entry in the name server zone table." 2046 INDEX { dnsMgmtZoneMName, 2047 dnsMgmtZoneClass } 2048 ::= { dnsMgmtZoneTable 1 } 2050 Document Expiration Date - March 7, 1993 - Saperia 53 2051 DnsMgmtZoneEntry ::= 2052 SEQUENCE { 2053 dnsMgmtZoneMName 2054 DnsName, 2055 dnsMgmtZoneRName 2056 DnsName, 2057 dnsMgmtZoneLoad 2058 DisplayString, 2059 dnsMgmtZoneDate 2060 DnsDate, 2061 dnsMgmtZoneClass 2062 DnsClass, 2063 dnsMgmtZoneLastReload 2064 DnsTime, 2065 dnsMgmtZoneLastReloadAttempt 2066 DnsTime, 2067 dnsMgmtZoneLastSource 2068 IpAddress, 2069 dnsMgmtZoneSerial 2070 INTEGER, 2071 dnsMgmtZoneRefresh 2072 DnsTime, 2073 dnsMgmtZoneRetry 2074 DnsTime, 2075 dnsMgmtZoneExpire 2076 DnsTime, 2077 dnsMgmtZoneMin 2078 INTEGER, 2079 dnsMgmtZoneValid 2080 DnsValid 2081 } 2082 dnsMgmtZoneMName OBJECT-TYPE 2083 SYNTAX DnsName 2084 ACCESS read-only 2085 STATUS mandatory 2086 DESCRIPTION 2087 "DNS name of the server that was the original or 2088 primary source of the data for this zone - see RFC 2090 54 Document Expiration Date - March 7, 1993 - Saperia 2091 1035 for details of teh SOA RDATA format.." 2092 ::= { dnsMgmtZoneEntry 1 } 2094 dnsMgmtZoneRName OBJECT-TYPE 2095 SYNTAX DnsName 2096 ACCESS read-only 2097 STATUS mandatory 2098 DESCRIPTION 2099 "The mailbox address of the person who is responsible 2100 for the administration of the zone specified in this 2101 row of the table. Note that the format of the address 2102 follows the domain-name format as in 2103 postman.server.acme.com." 2104 ::= { dnsMgmtZoneEntry 2 } 2106 dnsMgmtZoneLoad OBJECT-TYPE 2107 SYNTAX DisplayString 2108 ACCESS read-only 2109 STATUS mandatory 2110 DESCRIPTION 2111 "This is the name of the file that is read in for the 2112 initial load of zone information on startup." 2113 ::= { dnsMgmtZoneEntry 3 } 2115 dnsMgmtZoneDate OBJECT-TYPE 2116 SYNTAX DnsDate -- DisplayString 2117 ACCESS read-only 2118 STATUS mandatory 2119 DESCRIPTION 2120 "This is the date that the information found in 2121 dnsMgmtZoneLoad was last changed." 2122 ::= { dnsMgmtZoneEntry 4 } 2124 dnsMgmtZoneClass OBJECT-TYPE 2125 SYNTAX DnsClass -- INTEGER (0..65535) 2126 ACCESS read-only 2127 STATUS mandatory 2128 DESCRIPTION 2129 "DNS class of the RRs in this zone." 2130 ::= { dnsMgmtZoneEntry 5 } 2132 Document Expiration Date - March 7, 1993 - Saperia 55 2133 dnsMgmtZoneLastReload OBJECT-TYPE 2134 SYNTAX DnsTime 2135 ACCESS read-only 2136 STATUS mandatory 2137 DESCRIPTION 2138 "Elapsed seconds since last successful reload of 2139 this zone." 2140 ::= { dnsMgmtZoneEntry 6 } 2142 dnsMgmtZoneLastReloadAttempt OBJECT-TYPE 2143 SYNTAX DnsTime 2144 ACCESS read-only 2145 STATUS mandatory 2146 DESCRIPTION 2147 "Elapsed seconds since last attempted reload of 2148 this zone." 2149 ::= { dnsMgmtZoneEntry 7 } 2151 dnsMgmtZoneLastSource OBJECT-TYPE 2152 SYNTAX IpAddress 2153 ACCESS read-only 2154 STATUS mandatory 2155 DESCRIPTION 2156 "IP address of host from which most recent reload of 2157 this zone was received. If unknown or irrelevant, 2158 value should be 0.0.0.0." 2159 ::= { dnsMgmtZoneEntry 8 } 2161 dnsMgmtZoneSerial OBJECT-TYPE 2162 SYNTAX INTEGER 2163 ACCESS read-write 2164 STATUS mandatory 2165 DESCRIPTION 2166 "The current serial number of the SOA record in the 2167 file specified by dnsServMgmtZoneLoad." 2168 ::= { dnsMgmtZoneEntry 9 } 2170 56 Document Expiration Date - March 7, 1993 - Saperia 2171 dnsMgmtZoneRefresh OBJECT-TYPE 2172 SYNTAX DnsTime 2173 ACCESS read-only 2174 STATUS mandatory 2175 DESCRIPTION 2176 "REFRESH interval for zone. This is the REFRESH field 2177 of the zone's SOA RR, if known, otherwise whatever 2178 value the name server is using in place of the SOA 2179 REFRESH value." 2180 ::= { dnsMgmtZoneEntry 10 } 2182 dnsMgmtZoneRetry OBJECT-TYPE 2183 SYNTAX DnsTime 2184 ACCESS read-only 2185 STATUS mandatory 2186 DESCRIPTION 2187 "RETRY interval for zone. This is the RETRY field of 2188 the zone's SOA RR, if known, otherwise whatever value 2189 the name server is using in place of the SOA RETRY 2190 value." 2191 ::= { dnsMgmtZoneEntry 11 } 2193 dnsMgmtZoneExpire OBJECT-TYPE 2194 SYNTAX DnsTime 2195 ACCESS read-only 2196 STATUS mandatory 2197 DESCRIPTION 2198 "EXPIRE interval for zone. This is the EXPIRE field of 2199 the zone's SOA RR, if known, otherwise whatever value 2200 the name server is using in place of the SOA EXPIRE 2201 value." 2202 ::= { dnsMgmtZoneEntry 12 } 2204 Document Expiration Date - March 7, 1993 - Saperia 57 2205 dnsMgmtZoneMin OBJECT-TYPE 2206 SYNTAX INTEGER 2207 ACCESS read-write 2208 STATUS mandatory 2209 DESCRIPTION 2210 "This value is the TTL field which will be exported 2211 with any RR from this zone and is specified in the SOA 2212 record identified by dnsServMgmtZoneLoad." 2213 ::= { dnsMgmtZoneEntry 13 } 2215 dnsMgmtZoneValid OBJECT-TYPE 2216 SYNTAX DnsValid 2217 ACCESS write-only 2218 STATUS mandatory 2219 DESCRIPTION 2220 "Set to CLEAR to delete this zone entry." 2221 ::= { dnsMgmtZoneEntry 14 } 2223 -- DNS Management Server Table 2225 dnsMgmtServTable OBJECT-TYPE 2226 SYNTAX SEQUENCE OF DnsMgmtServEntry 2227 ACCESS not-accessible 2228 STATUS mandatory 2229 DESCRIPTION 2230 "Table of IP addresses of name server hosts from which 2231 this name server might obtain particular zones. 2232 Typically this indicates the addresses of the primary 2233 name servers of zones for which the SNMP agent's host 2234 is a secondary name server." 2235 ::= { dnsMgmt 4 } 2237 58 Document Expiration Date - March 7, 1993 - Saperia 2238 dnsMgmtServEntry OBJECT-TYPE 2239 SYNTAX DnsMgmtServEntry 2240 ACCESS not-accessible 2241 STATUS mandatory 2242 DESCRIPTION 2243 "An entry in the name server server (sic) table." 2244 INDEX { dnsMgmtServName, 2245 dnsMgmtServClass, 2246 dnsMgmtServAddr } 2247 ::= { dnsMgmtServTable 1 } 2249 DnsMgmtServEntry ::= 2250 SEQUENCE { 2251 dnsMgmtServName 2252 DnsName, 2253 dnsMgmtServClass 2254 DnsClass, 2255 dnsMgmtServAddr 2256 IpAddress 2257 } 2259 dnsMgmtServName OBJECT-TYPE 2260 SYNTAX DnsName 2261 ACCESS read-only 2262 STATUS mandatory 2263 DESCRIPTION 2264 "DNS name of the zone to which this entry applies." 2265 ::= { dnsMgmtServEntry 1 } 2267 dnsMgmtServClass OBJECT-TYPE 2268 SYNTAX DnsClass -- INTEGER (0..65535) 2269 ACCESS read-only 2270 STATUS mandatory 2271 DESCRIPTION 2272 "DNS class of zone to which this entry applies." 2273 ::= { dnsMgmtServEntry 2 } 2275 Document Expiration Date - March 7, 1993 - Saperia 59 2276 dnsMgmtServAddr OBJECT-TYPE 2277 SYNTAX IpAddress 2278 ACCESS read-only 2279 STATUS mandatory 2280 DESCRIPTION 2281 "IP address of name server host from which this zone 2282 might be obtainable." 2283 ::= { dnsMgmtServEntry 3 } 2284 END 2286 5 Acknowledgements 2288 This document is the result of work undertaken the by DNS work- 2289 ing group. Special thanks are due to Rob Austein of Epilogue 2290 Technology for the major contributions he has made in the orga- 2291 nization of the MIB as well as authoring many of the objects. 2292 In addition, the contributions and comments of the following 2293 members are also specially acknowledged: 2295 Win Treese, Digital Equipment Corporation 2296 Philip Almquist, Computer Communication consultant 2297 Joe Peck, Digital Equipment Corporation 2299 6 References 2301 J. Reynolds and J. Postel, Assigned Numbers. Internet Working 2302 Group Request for Comments 1010. Network Information Center, SRI 2303 International, Menlo Park, California, (May, 1987). 2305 M. Stahl, Domain Administrators Guide. Internet Working Group 2306 Request for Comments 1032. Network Information Center, SRI 2307 International, Menlo Park, California, (November, 1987). 2309 60 Document Expiration Date - March 7, 1993 - Saperia 2310 M. Lottor, Domain Administrators Operations Guide, Internet 2311 Working Group Request for Comments 1033. Network Information 2312 Center, SRI International, Menlo Park, California, (November, 2313 1987). 2315 P. Mockapetris, Domain Names - Concepts and Facilities, Internet 2316 Working Group Request for Comments 1034. Network Information 2317 Center, SRI International, Menlo Park, California, (November, 2318 1987). 2320 P. Mockapetris, Domain Names - Implementation and Specifica- 2321 tion, Internet Working Group Request for Comments 1035. Network 2322 Information Center, SRI International, Menlo Park, California, 2323 (November, 1987). 2325 V. Cerf, IAB Recommendations for the Development of Internet 2326 Network Management Standards. Internet Working Group Request for 2327 Comments 1052. Network Information Center, SRI International, 2328 Menlo Park, California, (April, 1988). 2330 R. Braden (editor) Requirements for Internet Hosts-Application 2331 and Support, Internet Working Group Request for Comments 1123. 2332 Network Information Center, SRI International,Menlo Park, Cali- 2333 fornia, (October, 1989). 2335 M.T. Rose and K. McCloghrie, Structure and Identification of 2336 Management Information for TCP/IP-based internets, Internet 2337 Working Group Request for Comments 1155. Network Information 2338 Center, SRI International, Menlo Park, California, (May, 1990). 2340 K. McCloghrie and M.T. Rose, Management Information Base for 2341 Network Management of TCP/IP-based internets, Internet Working 2342 Group Request for Comments 1156, Network Information Center, SRI 2343 International, Menlo Park, California, (May, 1990). 2345 J.D. Case, M.S. Fedor, M.L. Schoffstall, and J.R. Davin, Simple 2346 Network Management Protocol, Internet Working Group Request for 2347 Comments 1157. Network Information Center, SRI International, 2348 Menlo Park, California, (May, 1990). 2350 Document Expiration Date - March 7, 1993 - Saperia 61 2351 M.T. Rose, The Open Book, A Practical Perspective on OSI. Pren- 2352 tice Hall, Englewood Cliffs, New Jersey, (1990). 2354 M.T. Rose and K. McCloghrie (editors) Concise MIB Definitions, 2355 Internet Working Group Request for Comments 1212, Network In- 2356 formation Center, SRI International, Menlo Park, California, 2357 (March, 1991). 2359 K. McCloghrie and M.T. Rose (editors), Management Information 2360 Base for Network Management of TCP/IP-based internets: MIB- 2361 II, Internet Working Group Request for Comments 1213. Network 2362 Information Center, SRI International, Menlo Park, California, 2363 (March, 1991). 2365 62 Document Expiration Date - March 7, 1993 - Saperia