1-- ********************************************************************
2-- CISCO-DNS-CLIENT-MIB.my: DNS Client Configuration MIB
3--
4-- Sep 2004, Arul Mozhi
5--
6-- Copyright (c) 2004 by cisco Systems, Inc.
7-- All rights reserved.
8--
9-- ********************************************************************
10
11CISCO-DNS-CLIENT-MIB DEFINITIONS ::= BEGIN
12
13IMPORTS
14     MODULE-IDENTITY,
15     OBJECT-TYPE,
16     Unsigned32
17           FROM SNMPv2-SMI
18
19     MODULE-COMPLIANCE,
20     OBJECT-GROUP
21           FROM SNMPv2-CONF
22
23     RowStatus
24           FROM SNMPv2-TC
25
26     SnmpAdminString
27           FROM SNMP-FRAMEWORK-MIB
28
29     InetAddressType,
30     InetAddress
31           FROM INET-ADDRESS-MIB
32
33     ciscoMgmt
34           FROM CISCO-SMI;
35
36
37ciscoDNSClientMIB MODULE-IDENTITY
38        LAST-UPDATED "200409090000Z"
39        ORGANIZATION "Cisco Systems Inc. "
40        CONTACT-INFO
41                "     Cisco Systems
42                      Customer Service
43                Postal: 170 W Tasman Drive
44                      San Jose, CA  95134
45                      USA
46                Tel: +1 800 553 -NETS
47                E-mail: cs-san@cisco.com"
48        DESCRIPTION
49              "The MIB module for entities implementing the client
50              side of the Domain Name System (DNS) protocol."
51        REVISION   "200409090000Z"
52        DESCRIPTION
53            "Initial version of this MIB module."
54        ::= { ciscoMgmt 436 }
55
56ciscoDNSClientMIBNotifs OBJECT IDENTIFIER
57                                  ::= { ciscoDNSClientMIB 0 }
58
59ciscoDNSClientMIBObjects OBJECT IDENTIFIER
60                                  ::= { ciscoDNSClientMIB 1 }
61
62ciscoDNSClientMIBConformance OBJECT IDENTIFIER
63                                  ::= { ciscoDNSClientMIB 2 }
64
65
66cdcConfigGroup OBJECT IDENTIFIER  ::= { ciscoDNSClientMIBObjects 1 }
67
68
69--
70-- The DNS Configuration
71--
72
73cdcDNSConfigEnable OBJECT-TYPE
74       SYNTAX        INTEGER {
75                          enabled(1),
76                          disabled(2) }
77       MAX-ACCESS    read-write
78       STATUS        current
79       DESCRIPTION
80               "This object indicates whether the DNS
81                configuration is enabled or disabled in the local
82                system."
83       DEFVAL { disabled }
84       ::= { cdcConfigGroup 1 }
85
86cdcNoOfDNSServerConfig OBJECT-TYPE
87       SYNTAX        Unsigned32 (0..64)
88       MAX-ACCESS    read-only
89       STATUS        current
90       DESCRIPTION
91               "This object represents the current number of entries
92                in the 'cdcDNSServerTable'. Indicates the number of
93                DNS Server entries that are configured in the system."
94       ::= { cdcConfigGroup 2 }
95
96cdcDNSServerNextAvailIndex OBJECT-TYPE
97       SYNTAX       Unsigned32 (0..65535)
98       MAX-ACCESS   read-only
99       STATUS       current
100       DESCRIPTION
101               "This object contains the next available value for
102                the object 'cdcDNSServerIndex'. If all values are
103                exhausted, then this object will contain a 0 value.
104                A management application should read this object,
105                get the (non-zero) value and use same for
106                creating an entry in the 'cdcDNSServerTable'.
107
108                If two network management applications read this
109                object at the same time and try to create an entry
110                in the 'cdcDNSServerTable', only one of them will
111                succeed. The network management application which
112                failed, will need to re-read this object and try
113                the SET again."
114        ::= { cdcConfigGroup 3 }
115
116cdcDNSServerTable OBJECT-TYPE
117       SYNTAX        SEQUENCE OF CdcDNSServerEntry
118       MAX-ACCESS    not-accessible
119       STATUS        current
120       DESCRIPTION
121               "This table contains information about the Domain Name
122                System (DNS) Server configurations in the system.
123                When the DNS configuration is disabled in the system,
124                i.e., 'cdcDNSConfigEnable' object is set to
125                'disabled', all entries of this table will be removed
126                automatically.
127                The index of this table is not persistent upon
128                system reboot."
129       ::= { cdcConfigGroup 4 }
130
131cdcDNSServerEntry OBJECT-TYPE
132       SYNTAX        CdcDNSServerEntry
133       MAX-ACCESS    not-accessible
134       STATUS        current
135       DESCRIPTION
136               "An Entry representing the information about a
137                DNS Server configuration.
138
139                The entries are contacted in turn by the system for
140                DNS services. The first entry in this table will be
141                contacted first, and so on."
142       INDEX       { cdcDNSServerIndex }
143       ::= { cdcDNSServerTable 1 }
144
145CdcDNSServerEntry ::=
146       SEQUENCE {
147                cdcDNSServerIndex    Unsigned32,
148                cdcDNSServerAddrType InetAddressType,
149                cdcDNSServerAddr     InetAddress,
150                cdcDNSServerStatus   RowStatus
151       }
152
153cdcDNSServerIndex OBJECT-TYPE
154       SYNTAX        Unsigned32 (1..65535)
155       MAX-ACCESS    not-accessible
156       STATUS        current
157       DESCRIPTION
158               "This object represents the index corresponding to the
159                particular DNS Server configuration in the system.
160                For creation of new entry, the value of this object
161                should be same as that of the value of
162                'cdcDNSServerNextAvailIndex' object. If this is not
163                the case, then the entry creation will fail."
164       ::= { cdcDNSServerEntry 1 }
165
166cdcDNSServerAddrType OBJECT-TYPE
167       SYNTAX        InetAddressType
168       MAX-ACCESS    read-create
169       STATUS        current
170       DESCRIPTION
171               "This object represents the Inet Address type of the
172                'cdcDNSServerAddr' object.
173
174                An attempt to modify this object will fail with
175                an 'inconsistentValue' error, if the value of the
176                corresponding instance of 'cdcDNSServerStatus'
177                object is active(1)."
178       DEFVAL { ipv4 }
179       ::= { cdcDNSServerEntry 2 }
180
181cdcDNSServerAddr OBJECT-TYPE
182       SYNTAX        InetAddress
183       MAX-ACCESS    read-create
184       STATUS        current
185       DESCRIPTION
186               "This object represents the address of the
187                DNS Server.
188
189                This object is a mandatory object for row creation.
190
191                An attempt to modify this object will fail with
192                an 'inconsistentValue' error, if the value of the
193                corresponding instance of 'cdcDNSServerStatus' object
194                is active(1)."
195       ::= { cdcDNSServerEntry 3 }
196
197cdcDNSServerStatus OBJECT-TYPE
198       SYNTAX        RowStatus
199       MAX-ACCESS    read-create
200       STATUS        current
201       DESCRIPTION
202               "The Status of this row."
203       ::= { cdcDNSServerEntry 4 }
204
205-- Domain Name Configuration
206
207cdcDefaultDNSDomainName OBJECT-TYPE
208       SYNTAX        SnmpAdminString (SIZE(0..80))
209       MAX-ACCESS    read-write
210       STATUS        current
211       DESCRIPTION
212               "This object represents the Default DNS domain name
213                of the system. When this object is set to a
214                non empty string value, the domain name part of the
215                fully qualified name represented by the 'sysName'
216                object is updated by the value of this object.
217
218                When there is no entry in the 'cdcDNSDomainNameTable',
219                the value of this object is used for the domain name
220                configuration of the system.
221
222                When there is an entry in the 'cdcDNSDomainNameTable',
223                the value of this object is not used."
224       DEFVAL {""}
225       ::= { cdcConfigGroup 5 }
226
227cdcDNSDomainNameTable OBJECT-TYPE
228       SYNTAX        SEQUENCE OF CdcDNSDomainNameEntry
229       MAX-ACCESS    not-accessible
230       STATUS        current
231       DESCRIPTION
232               "This table contains the list of DNS Domain Names
233                defined for the system. Each domain name to be
234                tried in turn, for the domain name configuration
235                of the system."
236       ::= { cdcConfigGroup 6 }
237
238cdcDNSDomainNameEntry OBJECT-TYPE
239       SYNTAX        CdcDNSDomainNameEntry
240       MAX-ACCESS    not-accessible
241       STATUS        current
242       DESCRIPTION
243               "An entry (conceptual row) in the
244                'cdcDNSDomainNameTable'.
245                Each row represents a DNS Domain name defined
246                for the system."
247       INDEX   { cdcDNSDomainNameIndex }
248       ::= { cdcDNSDomainNameTable 1 }
249
250CdcDNSDomainNameEntry ::=
251       SEQUENCE {
252                cdcDNSDomainNameIndex    Unsigned32,
253                cdcDNSDomainName         SnmpAdminString,
254                cdcDNSDomainNameStatus   RowStatus
255       }
256
257cdcDNSDomainNameIndex OBJECT-TYPE
258       SYNTAX        Unsigned32 (1..64)
259       MAX-ACCESS    not-accessible
260       STATUS        current
261       DESCRIPTION
262               "An arbitrary integer value, greater than zero,
263                which uniquely identifies a DNS Domain Name
264                defined for the system."
265       ::= { cdcDNSDomainNameEntry 1 }
266
267cdcDNSDomainName OBJECT-TYPE
268       SYNTAX        SnmpAdminString (SIZE(1..80))
269       MAX-ACCESS    read-create
270       STATUS        current
271       DESCRIPTION
272               "This object represents a DNS Domain Name
273                defined for the system. When this object is
274                set to a non empty string value, the domain name
275                part of the fully qualified name represented by
276                the 'sysName' object is updated by the value of
277                this object.
278
279                This object is a mandatory object for row creation.
280
281                An attempt to modify this object will fail with
282                an 'inconsistentValue' error, if the value of the
283                corresponding instance of 'cdcDNSDomainNameStatus'
284                object is active(1)."
285       ::= { cdcDNSDomainNameEntry 2 }
286
287cdcDNSDomainNameStatus OBJECT-TYPE
288       SYNTAX        RowStatus
289       MAX-ACCESS    read-create
290       STATUS        current
291       DESCRIPTION
292               "The status of this conceptual row.
293                Once value of  this object is set to 'active',
294                the associated entry can not be modified except
295                destroyed by setting this object to destroy(6)."
296       ::= { cdcDNSDomainNameEntry 3 }
297
298
299--
300-- Conformance
301--
302
303ciscoDNSClientMIBCompliances
304       OBJECT IDENTIFIER ::= { ciscoDNSClientMIBConformance 1 }
305
306ciscoDNSClientMIBGroups
307       OBJECT IDENTIFIER ::= { ciscoDNSClientMIBConformance 2 }
308
309ciscoDNSClientMIBCompliance MODULE-COMPLIANCE
310       STATUS   current
311       DESCRIPTION
312               "The compliance statement for entities which
313                implement the CISCO-DNS-CLIENT-MIB."
314       MODULE MANDATORY-GROUPS {
315                                ciscoDNSServerConfigGroup ,
316                                ciscoDNSDomainNameConfigGroup
317                                }
318       ::= { ciscoDNSClientMIBCompliances 1 }
319
320--
321-- Units of Conformance
322--
323
324ciscoDNSServerConfigGroup  OBJECT-GROUP
325       OBJECTS  {
326                   cdcDNSConfigEnable,
327                   cdcNoOfDNSServerConfig,
328                   cdcDNSServerNextAvailIndex,
329                   cdcDNSServerAddrType,
330                   cdcDNSServerAddr,
331                   cdcDNSServerStatus
332                 }
333       STATUS   current
334       DESCRIPTION
335               "A collection of objects for DNS Server
336                address Configuration."
337       ::= { ciscoDNSClientMIBGroups 1 }
338
339ciscoDNSDomainNameConfigGroup  OBJECT-GROUP
340       OBJECTS  {
341                   cdcDefaultDNSDomainName,
342                   cdcDNSDomainName,
343                   cdcDNSDomainNameStatus
344                 }
345       STATUS   current
346       DESCRIPTION
347               "A collection of objects for DNS
348                Domain Name Configuration."
349       ::= { ciscoDNSClientMIBGroups 2 }
350END
351