1202 lines
42 KiB
Plaintext
1202 lines
42 KiB
Plaintext
-- extracted from rfc1612.txt
|
|
-- at Mon Nov 15 17:11:53 1999
|
|
|
|
DNS-RESOLVER-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY, OBJECT-TYPE, IpAddress, Counter32, Integer32
|
|
FROM SNMPv2-SMI
|
|
TEXTUAL-CONVENTION, RowStatus, DisplayString
|
|
FROM SNMPv2-TC
|
|
MODULE-COMPLIANCE, OBJECT-GROUP
|
|
FROM SNMPv2-CONF
|
|
dns, DnsName, DnsNameAsIndex, DnsClass, DnsType, DnsQClass,
|
|
DnsQType, DnsTime, DnsOpCode, DnsRespCode
|
|
FROM DNS-SERVER-MIB;
|
|
|
|
-- DNS Resolver MIB
|
|
|
|
dnsResMIB MODULE-IDENTITY
|
|
LAST-UPDATED "9401282250Z"
|
|
ORGANIZATION "IETF DNS Working Group"
|
|
CONTACT-INFO
|
|
" Rob Austein
|
|
Postal: Epilogue Technology Corporation
|
|
268 Main Street, Suite 283
|
|
North Reading, MA 10864
|
|
US
|
|
Tel: +1 617 245 0804
|
|
Fax: +1 617 245 8122
|
|
E-Mail: sra@epilogue.com
|
|
|
|
Jon Saperia
|
|
Postal: Digital Equipment Corporation
|
|
110 Spit Brook Road
|
|
ZKO1-3/H18
|
|
Nashua, NH 03062-2698
|
|
US
|
|
Tel: +1 603 881 0480
|
|
Fax: +1 603 881 0120
|
|
E-mail: saperia@zko.dec.com"
|
|
DESCRIPTION
|
|
"The MIB module for entities implementing the client
|
|
(resolver) side of the Domain Name System (DNS)
|
|
protocol."
|
|
::= { dns 2 }
|
|
|
|
dnsResMIBObjects OBJECT IDENTIFIER ::= { dnsResMIB 1 }
|
|
|
|
-- (Old-style) groups in the DNS resolver MIB.
|
|
|
|
dnsResConfig OBJECT IDENTIFIER ::= { dnsResMIBObjects 1 }
|
|
dnsResCounter OBJECT IDENTIFIER ::= { dnsResMIBObjects 2 }
|
|
dnsResLameDelegation OBJECT IDENTIFIER ::= { dnsResMIBObjects 3 }
|
|
dnsResCache OBJECT IDENTIFIER ::= { dnsResMIBObjects 4 }
|
|
dnsResNCache OBJECT IDENTIFIER ::= { dnsResMIBObjects 5 }
|
|
dnsResOptCounter OBJECT IDENTIFIER ::= { dnsResMIBObjects 6 }
|
|
|
|
|
|
-- Resolver Configuration Group
|
|
|
|
dnsResConfigImplementIdent OBJECT-TYPE
|
|
SYNTAX DisplayString
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The implementation identification string for the
|
|
resolver software in use on the system, for example;
|
|
`RES-2.1'"
|
|
::= { dnsResConfig 1 }
|
|
|
|
dnsResConfigService OBJECT-TYPE
|
|
SYNTAX INTEGER { recursiveOnly(1),
|
|
iterativeOnly(2),
|
|
recursiveAndIterative(3) }
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Kind of DNS resolution service provided:
|
|
|
|
recursiveOnly(1) indicates a stub resolver.
|
|
|
|
iterativeOnly(2) indicates a normal full service
|
|
resolver.
|
|
|
|
recursiveAndIterative(3) indicates a full-service
|
|
resolver which performs a mix of recursive and iterative
|
|
queries."
|
|
::= { dnsResConfig 2 }
|
|
|
|
dnsResConfigMaxCnames OBJECT-TYPE
|
|
SYNTAX INTEGER (0..2147483647)
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
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."
|
|
REFERENCE
|
|
"RFC-1035 section 7.1."
|
|
::= { dnsResConfig 3 }
|
|
|
|
-- DNS Resolver Safety Belt Table
|
|
|
|
dnsResConfigSbeltTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF DnsResConfigSbeltEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
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 or is a stub
|
|
resolver."
|
|
::= { dnsResConfig 4 }
|
|
|
|
dnsResConfigSbeltEntry OBJECT-TYPE
|
|
SYNTAX DnsResConfigSbeltEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry in the resolver's Sbelt table.
|
|
Rows may be created or deleted at any time by the DNS
|
|
resolver and by SNMP SET requests. Whether the values
|
|
changed via SNMP are saved in stable storage across
|
|
`reset' operations is implementation-specific."
|
|
INDEX { dnsResConfigSbeltAddr,
|
|
dnsResConfigSbeltSubTree,
|
|
dnsResConfigSbeltClass }
|
|
::= { dnsResConfigSbeltTable 1 }
|
|
|
|
DnsResConfigSbeltEntry ::=
|
|
SEQUENCE {
|
|
dnsResConfigSbeltAddr
|
|
IpAddress,
|
|
dnsResConfigSbeltName
|
|
DnsName,
|
|
dnsResConfigSbeltRecursion
|
|
INTEGER,
|
|
dnsResConfigSbeltPref
|
|
INTEGER,
|
|
dnsResConfigSbeltSubTree
|
|
DnsNameAsIndex,
|
|
dnsResConfigSbeltClass
|
|
DnsClass,
|
|
dnsResConfigSbeltStatus
|
|
RowStatus
|
|
}
|
|
|
|
dnsResConfigSbeltAddr OBJECT-TYPE
|
|
SYNTAX IpAddress
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The IP address of the Sbelt name server identified by
|
|
this row of the table."
|
|
::= { dnsResConfigSbeltEntry 1 }
|
|
|
|
dnsResConfigSbeltName OBJECT-TYPE
|
|
SYNTAX DnsName
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The DNS name of a Sbelt nameserver identified by this
|
|
row of the table. A zero-length string indicates that
|
|
the name is not known by the resolver."
|
|
::= { dnsResConfigSbeltEntry 2 }
|
|
|
|
dnsResConfigSbeltRecursion OBJECT-TYPE
|
|
SYNTAX INTEGER { iterative(1),
|
|
recursive(2),
|
|
recursiveAndIterative(3) }
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Kind of queries resolver will be sending to the name
|
|
server identified in this row of the table:
|
|
|
|
iterative(1) indicates that resolver will be directing
|
|
iterative queries to this name server (RD bit turned
|
|
off).
|
|
|
|
recursive(2) indicates that resolver will be directing
|
|
recursive queries to this name server (RD bit turned
|
|
on).
|
|
|
|
recursiveAndIterative(3) indicates that the resolver
|
|
will be directing both recursive and iterative queries
|
|
to the server identified in this row of the table."
|
|
::= { dnsResConfigSbeltEntry 3 }
|
|
|
|
dnsResConfigSbeltPref OBJECT-TYPE
|
|
SYNTAX INTEGER (0..2147483647)
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This value identifies the preference for the name server
|
|
identified in this row of the table. The lower the
|
|
value, the more desirable the resolver considers this
|
|
server."
|
|
::= { dnsResConfigSbeltEntry 4 }
|
|
|
|
dnsResConfigSbeltSubTree OBJECT-TYPE
|
|
SYNTAX DnsNameAsIndex
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Queries sent to the name server identified by this row
|
|
of the table are limited to those for names in the name
|
|
subtree identified by this variable. If no such
|
|
limitation applies, the value of this variable is the
|
|
name of the root domain (a DNS name consisting of a
|
|
single zero octet)."
|
|
::= { dnsResConfigSbeltEntry 5 }
|
|
|
|
dnsResConfigSbeltClass OBJECT-TYPE
|
|
SYNTAX DnsClass
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The class of DNS queries that will be sent to the server
|
|
identified by this row of the table."
|
|
::= { dnsResConfigSbeltEntry 6 }
|
|
|
|
dnsResConfigSbeltStatus OBJECT-TYPE
|
|
SYNTAX RowStatus
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Row status column for this row of the Sbelt table."
|
|
::= { dnsResConfigSbeltEntry 7 }
|
|
|
|
dnsResConfigUpTime OBJECT-TYPE
|
|
SYNTAX DnsTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"If the resolver has a persistent state (e.g., a
|
|
process), this value will be the time elapsed since it
|
|
started. For software without persistant state, this
|
|
value will be 0."
|
|
::= { dnsResConfig 5 }
|
|
|
|
dnsResConfigResetTime OBJECT-TYPE
|
|
SYNTAX DnsTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"If the resolver has a persistent state (e.g., a process)
|
|
and supports a `reset' operation (e.g., can be told to
|
|
re-read configuration files), this value will be the
|
|
time elapsed since the last time the resolver was
|
|
`reset.' For software that does not have persistence or
|
|
does not support a `reset' operation, this value will be
|
|
zero."
|
|
::= { dnsResConfig 6 }
|
|
|
|
dnsResConfigReset OBJECT-TYPE
|
|
SYNTAX INTEGER { other(1),
|
|
reset(2),
|
|
initializing(3),
|
|
running(4) }
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Status/action object to reinitialize any persistant
|
|
resolver state. When set to reset(2), any persistant
|
|
resolver state (such as a process) is reinitialized as if
|
|
the resolver had just been started. This value will
|
|
never be returned by a read operation. When read, one of
|
|
the following values will be returned:
|
|
other(1) - resolver in some unknown state;
|
|
initializing(3) - resolver (re)initializing;
|
|
running(4) - resolver currently running."
|
|
::= { dnsResConfig 7 }
|
|
|
|
|
|
-- Resolver Counters Group
|
|
|
|
-- Resolver Counter Table
|
|
|
|
dnsResCounterByOpcodeTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF DnsResCounterByOpcodeEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Table of the current count of resolver queries and
|
|
answers."
|
|
::= { dnsResCounter 3 }
|
|
|
|
dnsResCounterByOpcodeEntry OBJECT-TYPE
|
|
SYNTAX DnsResCounterByOpcodeEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Entry in the resolver counter table. Entries are
|
|
indexed by DNS OpCode."
|
|
INDEX { dnsResCounterByOpcodeCode }
|
|
::= { dnsResCounterByOpcodeTable 1 }
|
|
|
|
DnsResCounterByOpcodeEntry ::=
|
|
SEQUENCE {
|
|
dnsResCounterByOpcodeCode
|
|
DnsOpCode,
|
|
dnsResCounterByOpcodeQueries
|
|
Counter32,
|
|
dnsResCounterByOpcodeResponses
|
|
Counter32
|
|
}
|
|
|
|
dnsResCounterByOpcodeCode OBJECT-TYPE
|
|
SYNTAX DnsOpCode
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The index to this table. The OpCodes that have already
|
|
been defined are found in RFC-1035."
|
|
REFERENCE
|
|
"RFC-1035 section 4.1.1."
|
|
::= { dnsResCounterByOpcodeEntry 1 }
|
|
|
|
dnsResCounterByOpcodeQueries OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Total number of queries that have sent out by the
|
|
resolver since initialization for the OpCode which is
|
|
the index to this row of the table."
|
|
::= { dnsResCounterByOpcodeEntry 2 }
|
|
|
|
dnsResCounterByOpcodeResponses OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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."
|
|
::= { dnsResCounterByOpcodeEntry 3 }
|
|
|
|
-- Resolver Response Code Counter Table
|
|
|
|
dnsResCounterByRcodeTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF DnsResCounterByRcodeEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Table of the current count of responses to resolver
|
|
queries."
|
|
::= { dnsResCounter 4 }
|
|
|
|
dnsResCounterByRcodeEntry OBJECT-TYPE
|
|
SYNTAX DnsResCounterByRcodeEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Entry in the resolver response table. Entries are
|
|
indexed by DNS response code."
|
|
INDEX { dnsResCounterByRcodeCode }
|
|
::= { dnsResCounterByRcodeTable 1 }
|
|
|
|
DnsResCounterByRcodeEntry ::=
|
|
SEQUENCE {
|
|
dnsResCounterByRcodeCode
|
|
DnsRespCode,
|
|
dnsResCounterByRcodeResponses
|
|
Counter32
|
|
}
|
|
|
|
dnsResCounterByRcodeCode OBJECT-TYPE
|
|
SYNTAX DnsRespCode
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The index to this table. The Response Codes that have
|
|
already been defined are found in RFC-1035."
|
|
REFERENCE
|
|
"RFC-1035 section 4.1.1."
|
|
::= { dnsResCounterByRcodeEntry 1 }
|
|
|
|
dnsResCounterByRcodeResponses OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of responses the resolver has received for the
|
|
response code value which identifies this row of the
|
|
table."
|
|
::= { dnsResCounterByRcodeEntry 2 }
|
|
|
|
-- Additional DNS Resolver Counter Objects
|
|
|
|
dnsResCounterNonAuthDataResps OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of requests made by the resolver for which a
|
|
non-authoritative answer (cached data) was received."
|
|
::= { dnsResCounter 5 }
|
|
|
|
dnsResCounterNonAuthNoDataResps OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of requests made by the resolver for which a
|
|
non-authoritative answer - no such data response (empty
|
|
answer) was received."
|
|
::= { dnsResCounter 6 }
|
|
|
|
dnsResCounterMartians OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of responses received which were received from
|
|
servers that the resolver does not think it asked."
|
|
::= { dnsResCounter 7 }
|
|
|
|
dnsResCounterRecdResponses OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of responses received to all queries."
|
|
::= { dnsResCounter 8 }
|
|
|
|
dnsResCounterUnparseResps OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of responses received which were unparseable."
|
|
::= { dnsResCounter 9 }
|
|
|
|
dnsResCounterFallbacks OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of times the resolver had to fall back to its
|
|
seat belt information."
|
|
::= { dnsResCounter 10 }
|
|
|
|
|
|
-- Lame Delegation Group
|
|
|
|
dnsResLameDelegationOverflows OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of times the resolver attempted to add an entry
|
|
to the Lame Delegation table but was unable to for some
|
|
reason such as space constraints."
|
|
::= { dnsResLameDelegation 1 }
|
|
|
|
-- Lame Delegation Table
|
|
|
|
dnsResLameDelegationTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF DnsResLameDelegationEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Table of name servers returning lame delegations.
|
|
|
|
A lame delegation has occured when a parent zone
|
|
delegates authority for a child zone to a server that
|
|
appears not to think that it is authoritative for the
|
|
child zone in question."
|
|
::= { dnsResLameDelegation 2 }
|
|
|
|
dnsResLameDelegationEntry OBJECT-TYPE
|
|
SYNTAX DnsResLameDelegationEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Entry in lame delegation table. Only the resolver may
|
|
create rows in this table. SNMP SET requests may be used
|
|
to delete rows."
|
|
INDEX { dnsResLameDelegationSource,
|
|
dnsResLameDelegationName,
|
|
dnsResLameDelegationClass }
|
|
::= { dnsResLameDelegationTable 1 }
|
|
|
|
DnsResLameDelegationEntry ::=
|
|
SEQUENCE {
|
|
dnsResLameDelegationSource
|
|
IpAddress,
|
|
dnsResLameDelegationName
|
|
DnsNameAsIndex,
|
|
dnsResLameDelegationClass
|
|
DnsClass,
|
|
dnsResLameDelegationCounts
|
|
Counter32,
|
|
dnsResLameDelegationStatus
|
|
RowStatus
|
|
}
|
|
|
|
dnsResLameDelegationSource OBJECT-TYPE
|
|
SYNTAX IpAddress
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Source of lame delegation."
|
|
::= { dnsResLameDelegationEntry 1 }
|
|
|
|
dnsResLameDelegationName OBJECT-TYPE
|
|
SYNTAX DnsNameAsIndex
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"DNS name for which lame delegation was received."
|
|
::= { dnsResLameDelegationEntry 2 }
|
|
|
|
dnsResLameDelegationClass OBJECT-TYPE
|
|
SYNTAX DnsClass
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"DNS class of received lame delegation."
|
|
::= { dnsResLameDelegationEntry 3 }
|
|
|
|
dnsResLameDelegationCounts OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"How many times this lame delegation has been received."
|
|
::= { dnsResLameDelegationEntry 4 }
|
|
|
|
dnsResLameDelegationStatus OBJECT-TYPE
|
|
SYNTAX RowStatus
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Status column for the lame delegation table. Since only
|
|
the agent (DNS resolver) creates rows in this table, the
|
|
only values that a manager may write to this variable
|
|
are active(1) and destroy(6)."
|
|
::= { dnsResLameDelegationEntry 5 }
|
|
|
|
|
|
-- Resolver Cache Group
|
|
|
|
dnsResCacheStatus OBJECT-TYPE
|
|
SYNTAX INTEGER { enabled(1), disabled(2), clear(3) }
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Status/action for the resolver's cache.
|
|
|
|
enabled(1) means that the use of the cache is allowed.
|
|
Query operations can return this state.
|
|
|
|
disabled(2) means that the cache is not being used.
|
|
Query operations can return this state.
|
|
|
|
Setting this variable to clear(3) deletes the entire
|
|
contents of the resolver's cache, but does not otherwise
|
|
change the resolver's state. The status will retain its
|
|
previous value from before the clear operation (i.e.,
|
|
enabled(1) or disabled(2)). The value of clear(3) can
|
|
NOT be returned by a query operation."
|
|
::= { dnsResCache 1 }
|
|
|
|
dnsResCacheMaxTTL OBJECT-TYPE
|
|
SYNTAX DnsTime
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
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 zero."
|
|
::= { dnsResCache 2 }
|
|
|
|
dnsResCacheGoodCaches OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of RRs the resolver has cached successfully."
|
|
::= { dnsResCache 3 }
|
|
|
|
dnsResCacheBadCaches OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of RRs the resolver has refused to cache because
|
|
they appear to be dangerous or irrelevant. E.g., RRs
|
|
with suspiciously high TTLs, unsolicited root
|
|
information, or that just don't appear to be relevant to
|
|
the question the resolver asked."
|
|
::= { dnsResCache 4 }
|
|
|
|
-- Resolver Cache Table
|
|
|
|
dnsResCacheRRTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF DnsResCacheRREntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table contains information about all the resource
|
|
records currently in the resolver's cache."
|
|
::= { dnsResCache 5 }
|
|
|
|
dnsResCacheRREntry OBJECT-TYPE
|
|
SYNTAX DnsResCacheRREntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry in the resolvers's cache. Rows may be created
|
|
only by the resolver. SNMP SET requests may be used to
|
|
delete rows."
|
|
INDEX { dnsResCacheRRName,
|
|
dnsResCacheRRClass,
|
|
dnsResCacheRRType,
|
|
dnsResCacheRRIndex }
|
|
::= { dnsResCacheRRTable 1 }
|
|
|
|
DnsResCacheRREntry ::=
|
|
SEQUENCE {
|
|
dnsResCacheRRName
|
|
DnsNameAsIndex,
|
|
dnsResCacheRRClass
|
|
DnsClass,
|
|
dnsResCacheRRType
|
|
DnsType,
|
|
dnsResCacheRRTTL
|
|
DnsTime,
|
|
dnsResCacheRRElapsedTTL
|
|
DnsTime,
|
|
dnsResCacheRRSource
|
|
IpAddress,
|
|
dnsResCacheRRData
|
|
OCTET STRING,
|
|
dnsResCacheRRStatus
|
|
RowStatus,
|
|
dnsResCacheRRIndex
|
|
Integer32,
|
|
dnsResCacheRRPrettyName
|
|
DnsName
|
|
}
|
|
|
|
dnsResCacheRRName OBJECT-TYPE
|
|
SYNTAX DnsNameAsIndex
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Owner name of the Resource Record in the cache which is
|
|
identified in this row of the table. As described in
|
|
RFC-1034, the owner of the record is the domain name
|
|
were the RR is found."
|
|
REFERENCE
|
|
"RFC-1034 section 3.6."
|
|
::= { dnsResCacheRREntry 1 }
|
|
|
|
dnsResCacheRRClass OBJECT-TYPE
|
|
SYNTAX DnsClass
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"DNS class of the Resource Record in the cache which is
|
|
identified in this row of the table."
|
|
::= { dnsResCacheRREntry 2 }
|
|
|
|
dnsResCacheRRType OBJECT-TYPE
|
|
SYNTAX DnsType
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"DNS type of the Resource Record in the cache which is
|
|
identified in this row of the table."
|
|
::= { dnsResCacheRREntry 3 }
|
|
|
|
dnsResCacheRRTTL OBJECT-TYPE
|
|
SYNTAX DnsTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
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."
|
|
::= { dnsResCacheRREntry 4 }
|
|
|
|
dnsResCacheRRElapsedTTL OBJECT-TYPE
|
|
SYNTAX DnsTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Elapsed seconds since RR was received."
|
|
::= { dnsResCacheRREntry 5 }
|
|
|
|
dnsResCacheRRSource OBJECT-TYPE
|
|
SYNTAX IpAddress
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Host from which RR was received, 0.0.0.0 if unknown."
|
|
::= { dnsResCacheRREntry 6 }
|
|
|
|
dnsResCacheRRData OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"RDATA portion of a cached RR. The value is in the
|
|
format defined for the particular DNS class and type of
|
|
the resource record."
|
|
REFERENCE
|
|
"RFC-1035 section 3.2.1."
|
|
::= { dnsResCacheRREntry 7 }
|
|
|
|
dnsResCacheRRStatus OBJECT-TYPE
|
|
SYNTAX RowStatus
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Status column for the resolver cache table. Since only
|
|
the agent (DNS resolver) creates rows in this table, the
|
|
only values that a manager may write to this variable
|
|
are active(1) and destroy(6)."
|
|
::= { dnsResCacheRREntry 8 }
|
|
|
|
dnsResCacheRRIndex OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A value which makes entries in the table unique when the
|
|
other index values (dnsResCacheRRName,
|
|
dnsResCacheRRClass, and dnsResCacheRRType) do not
|
|
provide a unique index."
|
|
::= { dnsResCacheRREntry 9 }
|
|
|
|
dnsResCacheRRPrettyName OBJECT-TYPE
|
|
SYNTAX DnsName
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Name of the RR at this row in the table. This is
|
|
identical to the dnsResCacheRRName variable, except that
|
|
character case is preserved in this variable, per DNS
|
|
conventions."
|
|
REFERENCE
|
|
"RFC-1035 section 2.3.3."
|
|
::= { dnsResCacheRREntry 10 }
|
|
|
|
-- Resolver Negative Cache Group
|
|
|
|
dnsResNCacheStatus OBJECT-TYPE
|
|
SYNTAX INTEGER { enabled(1), disabled(2), clear(3) }
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Status/action for the resolver's negative response
|
|
cache.
|
|
|
|
enabled(1) means that the use of the negative response
|
|
cache is allowed. Query operations can return this
|
|
state.
|
|
disabled(2) means that the negative response cache is
|
|
not being used. Query operations can return this state.
|
|
|
|
Setting this variable to clear(3) deletes the entire
|
|
contents of the resolver's negative response cache. The
|
|
status will retain its previous value from before the
|
|
clear operation (i.e., enabled(1) or disabled(2)). The
|
|
value of clear(3) can NOT be returned by a query
|
|
operation."
|
|
::= { dnsResNCache 1 }
|
|
|
|
dnsResNCacheMaxTTL OBJECT-TYPE
|
|
SYNTAX DnsTime
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
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 zero."
|
|
::= { dnsResNCache 2 }
|
|
|
|
dnsResNCacheGoodNCaches OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of authoritative errors the resolver has cached
|
|
successfully."
|
|
::= { dnsResNCache 3 }
|
|
|
|
dnsResNCacheBadNCaches OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
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."
|
|
REFERENCE
|
|
"RFC-1034 section 4.3.4."
|
|
::= { dnsResNCache 4 }
|
|
|
|
-- Resolver Negative Cache Table
|
|
|
|
dnsResNCacheErrTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF DnsResNCacheErrEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The resolver's negative response cache. This table
|
|
contains information about authoritative errors that
|
|
have been cached by the resolver."
|
|
::= { dnsResNCache 5 }
|
|
|
|
dnsResNCacheErrEntry OBJECT-TYPE
|
|
SYNTAX DnsResNCacheErrEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry in the resolver's negative response cache
|
|
table. Only the resolver can create rows. SNMP SET
|
|
requests may be used to delete rows."
|
|
INDEX { dnsResNCacheErrQName,
|
|
dnsResNCacheErrQClass,
|
|
dnsResNCacheErrQType,
|
|
dnsResNCacheErrIndex }
|
|
::= { dnsResNCacheErrTable 1 }
|
|
|
|
DnsResNCacheErrEntry ::=
|
|
SEQUENCE {
|
|
dnsResNCacheErrQName
|
|
DnsNameAsIndex,
|
|
dnsResNCacheErrQClass
|
|
DnsQClass,
|
|
dnsResNCacheErrQType
|
|
DnsQType,
|
|
dnsResNCacheErrTTL
|
|
DnsTime,
|
|
dnsResNCacheErrElapsedTTL
|
|
DnsTime,
|
|
dnsResNCacheErrSource
|
|
IpAddress,
|
|
dnsResNCacheErrCode
|
|
INTEGER,
|
|
dnsResNCacheErrStatus
|
|
RowStatus,
|
|
dnsResNCacheErrIndex
|
|
Integer32,
|
|
dnsResNCacheErrPrettyName
|
|
DnsName
|
|
}
|
|
|
|
dnsResNCacheErrQName OBJECT-TYPE
|
|
SYNTAX DnsNameAsIndex
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"QNAME associated with a cached authoritative error."
|
|
REFERENCE
|
|
"RFC-1034 section 3.7.1."
|
|
::= { dnsResNCacheErrEntry 1 }
|
|
|
|
dnsResNCacheErrQClass OBJECT-TYPE
|
|
SYNTAX DnsQClass
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"DNS QCLASS associated with a cached authoritative
|
|
error."
|
|
::= { dnsResNCacheErrEntry 2 }
|
|
|
|
dnsResNCacheErrQType OBJECT-TYPE
|
|
SYNTAX DnsQType
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"DNS QTYPE associated with a cached authoritative error."
|
|
::= { dnsResNCacheErrEntry 3 }
|
|
|
|
dnsResNCacheErrTTL OBJECT-TYPE
|
|
SYNTAX DnsTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Time-To-Live of a cached authoritative error at the time
|
|
of the error, it should not be decremented by the number
|
|
of seconds since it was received. This should be the
|
|
TTL as copied from the MINIMUM field of the SOA that
|
|
accompanied the authoritative error, or a smaller value
|
|
if the resolver implements a ceiling on negative
|
|
response cache TTLs."
|
|
REFERENCE
|
|
"RFC-1034 section 4.3.4."
|
|
::= { dnsResNCacheErrEntry 4 }
|
|
|
|
dnsResNCacheErrElapsedTTL OBJECT-TYPE
|
|
SYNTAX DnsTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Elapsed seconds since authoritative error was received."
|
|
::= { dnsResNCacheErrEntry 5 }
|
|
|
|
dnsResNCacheErrSource OBJECT-TYPE
|
|
SYNTAX IpAddress
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Host which sent the authoritative error, 0.0.0.0 if
|
|
unknown."
|
|
::= { dnsResNCacheErrEntry 6 }
|
|
|
|
dnsResNCacheErrCode OBJECT-TYPE
|
|
SYNTAX INTEGER { nonexistantName(1), noData(2), other(3) }
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The authoritative error that has been cached:
|
|
|
|
nonexistantName(1) indicates an authoritative name error
|
|
(RCODE = 3).
|
|
|
|
noData(2) indicates an authoritative response with no
|
|
error (RCODE = 0) and no relevant data.
|
|
|
|
other(3) indicates some other cached authoritative
|
|
error. At present, no such errors are known to exist."
|
|
::= { dnsResNCacheErrEntry 7 }
|
|
|
|
dnsResNCacheErrStatus OBJECT-TYPE
|
|
SYNTAX RowStatus
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Status column for the resolver negative response cache
|
|
table. Since only the agent (DNS resolver) creates rows
|
|
in this table, the only values that a manager may write
|
|
to this variable are active(1) and destroy(6)."
|
|
::= { dnsResNCacheErrEntry 8 }
|
|
|
|
dnsResNCacheErrIndex OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A value which makes entries in the table unique when the
|
|
other index values (dnsResNCacheErrQName,
|
|
dnsResNCacheErrQClass, and dnsResNCacheErrQType) do not
|
|
provide a unique index."
|
|
::= { dnsResNCacheErrEntry 9 }
|
|
|
|
dnsResNCacheErrPrettyName OBJECT-TYPE
|
|
SYNTAX DnsName
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"QNAME associated with this row in the table. This is
|
|
identical to the dnsResNCacheErrQName variable, except
|
|
that character case is preserved in this variable, per
|
|
DNS conventions."
|
|
REFERENCE
|
|
"RFC-1035 section 2.3.3."
|
|
::= { dnsResNCacheErrEntry 10 }
|
|
|
|
|
|
-- Resolver Optional Counters Group
|
|
|
|
dnsResOptCounterReferals OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of responses which were received from servers
|
|
redirecting query to another server."
|
|
::= { dnsResOptCounter 1 }
|
|
|
|
dnsResOptCounterRetrans OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number requests retransmitted for all reasons."
|
|
::= { dnsResOptCounter 2 }
|
|
|
|
dnsResOptCounterNoResponses OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of queries that were retransmitted because of no
|
|
response."
|
|
::= { dnsResOptCounter 3 }
|
|
|
|
dnsResOptCounterRootRetrans OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of queries that were retransmitted that were to
|
|
root servers."
|
|
::= { dnsResOptCounter 4 }
|
|
|
|
dnsResOptCounterInternals OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of requests internally generated by the
|
|
resolver."
|
|
::= { dnsResOptCounter 5 }
|
|
|
|
dnsResOptCounterInternalTimeOuts OBJECT-TYPE
|
|
SYNTAX Counter32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of requests internally generated which timed
|
|
out."
|
|
::= { dnsResOptCounter 6 }
|
|
|
|
|
|
-- SNMPv2 groups.
|
|
|
|
dnsResMIBGroups OBJECT IDENTIFIER ::= { dnsResMIB 2 }
|
|
|
|
dnsResConfigGroup OBJECT-GROUP
|
|
OBJECTS { dnsResConfigImplementIdent,
|
|
dnsResConfigService,
|
|
dnsResConfigMaxCnames,
|
|
dnsResConfigSbeltAddr,
|
|
dnsResConfigSbeltName,
|
|
dnsResConfigSbeltRecursion,
|
|
dnsResConfigSbeltPref,
|
|
dnsResConfigSbeltSubTree,
|
|
dnsResConfigSbeltClass,
|
|
dnsResConfigSbeltStatus,
|
|
dnsResConfigUpTime,
|
|
dnsResConfigResetTime }
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of objects providing basic configuration
|
|
information for a DNS resolver implementation."
|
|
::= { dnsResMIBGroups 1 }
|
|
|
|
dnsResCounterGroup OBJECT-GROUP
|
|
OBJECTS { dnsResCounterByOpcodeCode,
|
|
dnsResCounterByOpcodeQueries,
|
|
dnsResCounterByOpcodeResponses,
|
|
dnsResCounterByRcodeCode,
|
|
dnsResCounterByRcodeResponses,
|
|
dnsResCounterNonAuthDataResps,
|
|
dnsResCounterNonAuthNoDataResps,
|
|
dnsResCounterMartians,
|
|
dnsResCounterRecdResponses,
|
|
dnsResCounterUnparseResps,
|
|
dnsResCounterFallbacks }
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of objects providing basic instrumentation
|
|
of a DNS resolver implementation."
|
|
::= { dnsResMIBGroups 2 }
|
|
|
|
dnsResLameDelegationGroup OBJECT-GROUP
|
|
OBJECTS { dnsResLameDelegationOverflows,
|
|
dnsResLameDelegationSource,
|
|
dnsResLameDelegationName,
|
|
dnsResLameDelegationClass,
|
|
dnsResLameDelegationCounts,
|
|
dnsResLameDelegationStatus }
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of objects providing instrumentation of
|
|
`lame delegation' failures."
|
|
::= { dnsResMIBGroups 3 }
|
|
|
|
|
|
dnsResCacheGroup OBJECT-GROUP
|
|
OBJECTS { dnsResCacheStatus,
|
|
dnsResCacheMaxTTL,
|
|
dnsResCacheGoodCaches,
|
|
dnsResCacheBadCaches,
|
|
dnsResCacheRRName,
|
|
dnsResCacheRRClass,
|
|
dnsResCacheRRType,
|
|
dnsResCacheRRTTL,
|
|
dnsResCacheRRElapsedTTL,
|
|
dnsResCacheRRSource,
|
|
dnsResCacheRRData,
|
|
dnsResCacheRRStatus,
|
|
dnsResCacheRRIndex,
|
|
dnsResCacheRRPrettyName }
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of objects providing access to and control
|
|
of a DNS resolver's cache."
|
|
::= { dnsResMIBGroups 4 }
|
|
|
|
dnsResNCacheGroup OBJECT-GROUP
|
|
OBJECTS { dnsResNCacheStatus,
|
|
dnsResNCacheMaxTTL,
|
|
dnsResNCacheGoodNCaches,
|
|
dnsResNCacheBadNCaches,
|
|
dnsResNCacheErrQName,
|
|
dnsResNCacheErrQClass,
|
|
dnsResNCacheErrQType,
|
|
dnsResNCacheErrTTL,
|
|
dnsResNCacheErrElapsedTTL,
|
|
dnsResNCacheErrSource,
|
|
dnsResNCacheErrCode,
|
|
dnsResNCacheErrStatus,
|
|
dnsResNCacheErrIndex,
|
|
dnsResNCacheErrPrettyName }
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of objects providing access to and control
|
|
of a DNS resolver's negative response cache."
|
|
::= { dnsResMIBGroups 5 }
|
|
|
|
dnsResOptCounterGroup OBJECT-GROUP
|
|
OBJECTS { dnsResOptCounterReferals,
|
|
dnsResOptCounterRetrans,
|
|
dnsResOptCounterNoResponses,
|
|
dnsResOptCounterRootRetrans,
|
|
dnsResOptCounterInternals,
|
|
dnsResOptCounterInternalTimeOuts }
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of objects providing further
|
|
instrumentation applicable to many but not all DNS
|
|
resolvers."
|
|
::= { dnsResMIBGroups 6 }
|
|
|
|
|
|
-- Compliances.
|
|
|
|
dnsResMIBCompliances OBJECT IDENTIFIER ::= { dnsResMIB 3 }
|
|
|
|
dnsResMIBCompliance MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The compliance statement for agents implementing the DNS
|
|
resolver MIB extensions."
|
|
MODULE -- This MIB module
|
|
MANDATORY-GROUPS { dnsResConfigGroup, dnsResCounterGroup }
|
|
GROUP dnsResCacheGroup
|
|
DESCRIPTION
|
|
"The resolver cache group is mandatory for resolvers that
|
|
implement a cache."
|
|
GROUP dnsResNCacheGroup
|
|
DESCRIPTION
|
|
"The resolver negative cache group is mandatory for
|
|
resolvers that implement a negative response cache."
|
|
GROUP dnsResLameDelegationGroup
|
|
DESCRIPTION
|
|
"The lame delegation group is unconditionally optional."
|
|
GROUP dnsResOptCounterGroup
|
|
DESCRIPTION
|
|
"The optional counters group is unconditionally
|
|
optional."
|
|
OBJECT dnsResConfigMaxCnames
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"This object need not be writable."
|
|
OBJECT dnsResConfigSbeltName
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"This object need not be writable."
|
|
OBJECT dnsResConfigSbeltRecursion
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"This object need not be writable."
|
|
OBJECT dnsResConfigSbeltPref
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"This object need not be writable."
|
|
OBJECT dnsResConfigReset
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"This object need not be writable."
|
|
OBJECT dnsResCacheStatus
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"This object need not be writable."
|
|
OBJECT dnsResCacheMaxTTL
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"This object need not be writable."
|
|
OBJECT dnsResNCacheStatus
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"This object need not be writable."
|
|
|
|
OBJECT dnsResNCacheMaxTTL
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"This object need not be writable."
|
|
::= { dnsResMIBCompliances 1 }
|
|
|
|
END
|