Imported Upstream version 0.4.8
[platform/upstream/libsmi.git] / mibs / ietf / WWW-MIB
1 WWW-MIB DEFINITIONS ::= BEGIN
2
3 IMPORTS
4     MODULE-IDENTITY, OBJECT-TYPE, mib-2,
5     Counter32, Counter64, Integer32, Unsigned32, TimeTicks
6         FROM SNMPv2-SMI
7     TEXTUAL-CONVENTION, DisplayString, DateAndTime, TimeInterval
8         FROM SNMPv2-TC
9
10     MODULE-COMPLIANCE, OBJECT-GROUP
11         FROM SNMPv2-CONF
12
13     Utf8String
14         FROM SYSAPPL-MIB;
15
16 wwwMIB MODULE-IDENTITY
17     LAST-UPDATED "9902251400Z"
18     ORGANIZATION "IETF Application MIB Working Group"
19     CONTACT-INFO
20         "        Harrie Hazewinkel
21
22          Postal: Joint Research Centre of the E.C.
23                  via Fermi - Ispra 21020 (VA)
24                  Italy
25
26             Tel: +39+(0)332 786322
27             Fax: +39+(0)332 785641
28          E-mail: harrie.hazewinkel@jrc.it
29
30                  Carl W. Kalbfleisch
31
32          Postal: Verio, Inc.
33                  1950 Stemmons Freeway
34                  Suite 2006
35                  Dallas, TX 75207
36                  US
37
38             Tel: +1 214 290-8653
39             Fax: +1 214 744-0742
40          E-mail: cwk@verio.net
41
42                  Juergen Schoenwaelder
43
44          Postal: TU Braunschweig
45                  Bueltenweg 74/75
46                  38106 Braunschweig
47                  Germany
48
49             Tel: +49 531 391-3683
50             Fax: +49 531 489-5936
51          E-mail: schoenw@ibr.cs.tu-bs.de"
52     DESCRIPTION
53         "This WWW service MIB module is applicable to services
54          realized by a family of 'Document Transfer Protocols'
55          (DTP). Examples of DTPs are HTTP and FTP."
56
57        -- revision history
58
59        REVISION    "9902251400Z"
60        DESCRIPTION "Initial version, published as RFC2594."
61
62        ::= { mib-2 65 }
63
64 --
65 --  Object Identifier Assignments
66 --
67
68 wwwMIBObjects     OBJECT IDENTIFIER ::= { wwwMIB 1 }
69 wwwMIBConformance OBJECT IDENTIFIER ::= { wwwMIB 2 }
70
71 --
72 -- Textual Conventions
73 --
74
75 WwwRequestType ::= TEXTUAL-CONVENTION
76     STATUS      current
77     DESCRIPTION
78         "The WwwRequestType defines the textual identification of
79          request types used by a document transfer protocol. For
80          the proper values for a given DTP, refer to the protocol
81          mappings for that DTP."
82     SYNTAX      OCTET STRING (SIZE (1..40))
83
84 WwwResponseType ::= TEXTUAL-CONVENTION
85     STATUS      current
86     DESCRIPTION
87         "The WwwResponseType defines the different response values
88          used by document transfer protocols. For the proper values
89          for a given DTP, refer to the protocol mappings for that
90          DTP."
91     SYNTAX      Integer32 (0..2147483647)
92
93 WwwOperStatus ::= TEXTUAL-CONVENTION
94     STATUS      current
95     DESCRIPTION
96         "The operational status of a WWW service. 'down' indicates
97          that the service is not available. 'running' indicates
98          that the service is operational and available. 'halted'
99          indicates that the service is operational but not
100          available. 'congested' indicates that the service is
101          operational but no additional inbound associations can be
102          accommodated. 'restarting' indicates that the service is
103          currently unavailable but is in the process of restarting
104          and will be available soon."
105     SYNTAX      INTEGER {
106                     down(1),
107                     running(2),
108                     halted(3),
109                     congested(4),
110                     restarting(5)
111                 }
112
113 WwwDocName ::= TEXTUAL-CONVENTION
114     DISPLAY-HINT "255a"
115     STATUS      current
116     DESCRIPTION
117         "The server relative name of a document. If the URL were
118          http://www.x.org/standards/search/search.cgi?string=test
119          then the value of this textual convention would resolve
120          to '/standards/search/search.cgi'. This textual convention
121          uses the character set for URIs as defined in RFC 2396
122          section 2."
123     SYNTAX      OCTET STRING (SIZE (0..255))
124
125
126 -- The WWW Service Information Group
127 --
128 -- The WWW service information group contains information about
129 -- the WWW services known by the SNMP agent.
130
131 wwwService OBJECT IDENTIFIER ::= { wwwMIBObjects 1 }
132
133 wwwServiceTable OBJECT-TYPE
134     SYNTAX      SEQUENCE OF WwwServiceEntry
135     MAX-ACCESS  not-accessible
136     STATUS      current
137     DESCRIPTION
138         "The table of the WWW services known by the SNMP agent."
139     ::= { wwwService 1 }
140
141 wwwServiceEntry OBJECT-TYPE
142     SYNTAX      WwwServiceEntry
143     MAX-ACCESS  not-accessible
144     STATUS      current
145     DESCRIPTION
146         "Details about a particular WWW service."
147     INDEX       { wwwServiceIndex }
148     ::= { wwwServiceTable 1 }
149
150 WwwServiceEntry ::= SEQUENCE {
151     wwwServiceIndex             Unsigned32,
152     wwwServiceDescription       Utf8String,
153     wwwServiceContact           Utf8String,
154     wwwServiceProtocol          OBJECT IDENTIFIER,
155     wwwServiceName              DisplayString,
156     wwwServiceType              INTEGER,
157     wwwServiceStartTime         DateAndTime,
158     wwwServiceOperStatus        WwwOperStatus,
159     wwwServiceLastChange        DateAndTime
160 }
161
162 wwwServiceIndex OBJECT-TYPE
163     SYNTAX      Unsigned32 (1..4294967295)
164     MAX-ACCESS  not-accessible
165     STATUS      current
166     DESCRIPTION
167         "An integer used to uniquely identify a WWW service. The
168          value must be the same as the corresponding value of the
169          applSrvIndex defined in the Application Management MIB
170          (APPLICATION-MIB) if the applSrvIndex object is available.
171          It might be necessary to manually configure sub-agents in
172          order to meet this requirement."
173     ::= { wwwServiceEntry 1 }
174
175 wwwServiceDescription OBJECT-TYPE
176     SYNTAX      Utf8String
177     MAX-ACCESS  read-only
178     STATUS      current
179     DESCRIPTION
180         "Textual description of the WWW service. This shall include
181          at least the vendor and version number of the application
182          realizing the WWW service. In a minimal case, this might
183          be the Product Token (see RFC 2068) for the application."
184     ::= { wwwServiceEntry 2 }
185
186 wwwServiceContact OBJECT-TYPE
187     SYNTAX      Utf8String
188     MAX-ACCESS  read-only
189     STATUS      current
190     DESCRIPTION
191         "The textual identification of the contact person for this
192          service, together with information on how to contact this
193          person. For instance, this might be a string containing an
194          email address, e.g. '<webmaster@domain.name>'."
195     ::= { wwwServiceEntry 3 }
196
197 wwwServiceProtocol OBJECT-TYPE
198     SYNTAX      OBJECT IDENTIFIER
199     MAX-ACCESS  read-only
200     STATUS      current
201     DESCRIPTION
202         "An identification of the primary protocol in use by this
203          service. For Internet applications, the IANA maintains
204          a registry of the OIDs which correspond to well-known
205          application protocols.  If the application protocol is not
206          listed in the registry, an OID value of the form
207          {applTCPProtoID port} or {applUDPProtoID port} are used for
208          TCP-based and UDP-based protocols, respectively. In either
209          case 'port' corresponds to the primary port number being
210          used by the protocol."
211     REFERENCE
212         "The OID values applTCPProtoID and applUDPProtoID are
213          defined in the NETWORK-SERVICES-MIB (RFC 2248)."
214     ::= { wwwServiceEntry 4 }
215
216 wwwServiceName OBJECT-TYPE
217     SYNTAX      DisplayString
218     MAX-ACCESS  read-only
219     STATUS      current
220     DESCRIPTION
221         "The fully qualified domain name by which this service is
222          known. This object must contain the virtual host name if
223          the service is realized for a virtual host."
224     ::= { wwwServiceEntry 5 }
225
226 wwwServiceType OBJECT-TYPE
227     SYNTAX      INTEGER {
228                     wwwOther(1),
229                     wwwServer(2),
230                     wwwClient(3),
231                     wwwProxy(4),
232                     wwwCachingProxy(5)
233                 }
234     MAX-ACCESS  read-only
235     STATUS      current
236     DESCRIPTION
237         "The application type using or realizing this WWW service."
238     ::= { wwwServiceEntry 6 }
239
240 wwwServiceStartTime OBJECT-TYPE
241     SYNTAX      DateAndTime
242     MAX-ACCESS  read-only
243     STATUS      current
244     DESCRIPTION
245         "The date and time when this WWW service was last started.
246          The value SHALL be '0000000000000000'H if the last start
247          time of this WWW service is not known."
248     ::= { wwwServiceEntry 7 }
249
250 wwwServiceOperStatus OBJECT-TYPE
251     SYNTAX      WwwOperStatus
252     MAX-ACCESS  read-only
253     STATUS      current
254     DESCRIPTION
255         "Indicates the operational status of the WWW service."
256     ::= { wwwServiceEntry 8 }
257
258 wwwServiceLastChange OBJECT-TYPE
259     SYNTAX      DateAndTime
260     MAX-ACCESS  read-only
261     STATUS      current
262     DESCRIPTION
263         "The date and time when this WWW service entered its current
264          operational state. The value SHALL be '0000000000000000'H if
265          the time of the last state change is not known."
266     ::= { wwwServiceEntry 9 }
267
268
269 -- The WWW Protocol Statistics Group
270 --
271 -- The WWW protocol statistics group contains statistics about
272 -- the DTP requests and responses sent or received.
273
274 wwwProtocolStatistics OBJECT IDENTIFIER ::= { wwwMIBObjects 2 }
275
276 wwwSummaryTable OBJECT-TYPE
277     SYNTAX      SEQUENCE OF WwwSummaryEntry
278     MAX-ACCESS  not-accessible
279     STATUS      current
280     DESCRIPTION
281         "The table providing overview statistics for the
282          WWW services on this system."
283     ::= { wwwProtocolStatistics 1 }
284
285 wwwSummaryEntry OBJECT-TYPE
286     SYNTAX      WwwSummaryEntry
287     MAX-ACCESS  not-accessible
288     STATUS      current
289     DESCRIPTION
290         "Overview statistics for an individual service."
291     INDEX       { wwwServiceIndex }
292     ::= { wwwSummaryTable 1 }
293
294 WwwSummaryEntry ::= SEQUENCE {
295     wwwSummaryInRequests        Counter32,
296     wwwSummaryOutRequests       Counter32,
297     wwwSummaryInResponses       Counter32,
298     wwwSummaryOutResponses      Counter32,
299     wwwSummaryInBytes           Counter64,
300     wwwSummaryInLowBytes        Counter32,
301     wwwSummaryOutBytes          Counter64,
302     wwwSummaryOutLowBytes       Counter32
303 }
304
305 wwwSummaryInRequests OBJECT-TYPE
306     SYNTAX      Counter32
307     MAX-ACCESS  read-only
308     STATUS      current
309     DESCRIPTION
310         "The number of requests successfully received."
311     ::= { wwwSummaryEntry 1 }
312
313 wwwSummaryOutRequests OBJECT-TYPE
314     SYNTAX      Counter32
315     MAX-ACCESS  read-only
316     STATUS      current
317     DESCRIPTION
318         "The number of requests generated."
319     ::= { wwwSummaryEntry 2 }
320
321 wwwSummaryInResponses OBJECT-TYPE
322     SYNTAX      Counter32
323     MAX-ACCESS  read-only
324     STATUS      current
325     DESCRIPTION
326         "The number of responses successfully received."
327     ::= { wwwSummaryEntry 3 }
328
329 wwwSummaryOutResponses OBJECT-TYPE
330     SYNTAX      Counter32
331     MAX-ACCESS  read-only
332     STATUS      current
333     DESCRIPTION
334         "The number of responses generated."
335     ::= { wwwSummaryEntry 4 }
336
337 wwwSummaryInBytes OBJECT-TYPE
338     SYNTAX      Counter64
339     MAX-ACCESS  read-only
340     STATUS      current
341     DESCRIPTION
342         "The number of content bytes received."
343     ::= { wwwSummaryEntry 5 }
344
345 wwwSummaryInLowBytes OBJECT-TYPE
346     SYNTAX      Counter32
347     MAX-ACCESS  read-only
348     STATUS      current
349     DESCRIPTION
350         "The lowest thirty-two bits of wwwSummaryInBytes."
351     ::= { wwwSummaryEntry 6 }
352
353 wwwSummaryOutBytes OBJECT-TYPE
354     SYNTAX      Counter64
355     MAX-ACCESS  read-only
356     STATUS      current
357     DESCRIPTION
358         "The number of content bytes transmitted."
359     ::= { wwwSummaryEntry 7 }
360
361 wwwSummaryOutLowBytes OBJECT-TYPE
362     SYNTAX      Counter32
363     MAX-ACCESS  read-only
364     STATUS      current
365     DESCRIPTION
366         "The lowest thirty-two bits of wwwSummaryOutBytes."
367     ::= { wwwSummaryEntry 8 }
368
369 -- The WWW request tables contain detailed information about
370 -- requests send or received by WWW services.
371
372 wwwRequestInTable OBJECT-TYPE
373     SYNTAX      SEQUENCE OF WwwRequestInEntry
374     MAX-ACCESS  not-accessible
375     STATUS      current
376     DESCRIPTION
377         "The table providing detailed statistics for requests
378          received by WWW services on this system."
379     ::= { wwwProtocolStatistics 2 }
380
381 wwwRequestInEntry OBJECT-TYPE
382     SYNTAX      WwwRequestInEntry
383     MAX-ACCESS  not-accessible
384     STATUS      current
385     DESCRIPTION
386         "Request statistics for an individual service."
387     INDEX       { wwwServiceIndex, wwwRequestInIndex }
388     ::= { wwwRequestInTable 1 }
389
390 WwwRequestInEntry ::= SEQUENCE {
391     wwwRequestInIndex           WwwRequestType,
392     wwwRequestInRequests        Counter32,
393     wwwRequestInBytes           Counter32,
394     wwwRequestInLastTime        DateAndTime
395 }
396
397 wwwRequestInIndex OBJECT-TYPE
398     SYNTAX      WwwRequestType
399     MAX-ACCESS  not-accessible
400     STATUS      current
401     DESCRIPTION
402         "The particular request type the statistics apply to."
403     ::= { wwwRequestInEntry 1 }
404
405 wwwRequestInRequests OBJECT-TYPE
406     SYNTAX      Counter32
407     MAX-ACCESS  read-only
408     STATUS      current
409     DESCRIPTION
410         "The number of requests of this type received by this
411          WWW service."
412     ::= { wwwRequestInEntry 2 }
413
414 wwwRequestInBytes OBJECT-TYPE
415     SYNTAX      Counter32
416     MAX-ACCESS  read-only
417     STATUS      current
418     DESCRIPTION
419         "The number of content bytes per request type received
420          by this WWW service."
421     ::= { wwwRequestInEntry 3 }
422
423 wwwRequestInLastTime OBJECT-TYPE
424     SYNTAX      DateAndTime
425     MAX-ACCESS  read-only
426     STATUS      current
427     DESCRIPTION
428         "The date and time when the last byte of the last complete
429          request of this type was received by this WWW service. The
430          value SHALL be '0000000000000000'H if no request of this
431          type has been received yet."
432     ::= { wwwRequestInEntry 4 }
433
434 wwwRequestOutTable OBJECT-TYPE
435     SYNTAX      SEQUENCE OF WwwRequestOutEntry
436     MAX-ACCESS  not-accessible
437     STATUS      current
438     DESCRIPTION
439         "The table providing detailed statistics for requests
440          generated by the services on this system."
441     ::= { wwwProtocolStatistics 3 }
442
443 wwwRequestOutEntry OBJECT-TYPE
444     SYNTAX      WwwRequestOutEntry
445     MAX-ACCESS  not-accessible
446     STATUS      current
447     DESCRIPTION
448         "Request statistics for an individual service."
449     INDEX       { wwwServiceIndex, wwwRequestOutIndex }
450     ::= { wwwRequestOutTable 1 }
451
452 WwwRequestOutEntry ::= SEQUENCE {
453     wwwRequestOutIndex          WwwRequestType,
454     wwwRequestOutRequests       Counter32,
455     wwwRequestOutBytes          Counter32,
456     wwwRequestOutLastTime       DateAndTime
457 }
458
459 wwwRequestOutIndex OBJECT-TYPE
460     SYNTAX      WwwRequestType
461     MAX-ACCESS  not-accessible
462     STATUS      current
463     DESCRIPTION
464         "The particular request type the statistics apply to."
465     ::= { wwwRequestOutEntry 1 }
466
467 wwwRequestOutRequests OBJECT-TYPE
468     SYNTAX      Counter32
469     MAX-ACCESS  read-only
470     STATUS      current
471     DESCRIPTION
472         "The number of requests of this type generated by this
473          WWW service."
474     ::= { wwwRequestOutEntry 2 }
475
476 wwwRequestOutBytes OBJECT-TYPE
477     SYNTAX      Counter32
478     MAX-ACCESS  read-only
479     STATUS      current
480     DESCRIPTION
481         "The number of content bytes per requests type generated
482          by this WWW service."
483     ::= { wwwRequestOutEntry 3 }
484
485 wwwRequestOutLastTime OBJECT-TYPE
486     SYNTAX      DateAndTime
487     MAX-ACCESS  read-only
488     STATUS      current
489     DESCRIPTION
490         "The date and time when the first byte of the last request
491          of this type was send by this WWW service. The value SHALL
492          be '0000000000000000'H if no request of this type has been
493          send yet."
494     ::= { wwwRequestOutEntry 4 }
495
496 -- The WWW response tables contain detailed information about
497 -- responses sent or received by WWW services.
498
499 wwwResponseInTable OBJECT-TYPE
500     SYNTAX      SEQUENCE OF WwwResponseInEntry
501     MAX-ACCESS  not-accessible
502     STATUS      current
503     DESCRIPTION
504         "The table providing detailed statistics for responses
505          received by WWW services on this system."
506     ::= { wwwProtocolStatistics 4 }
507
508 wwwResponseInEntry OBJECT-TYPE
509     SYNTAX      WwwResponseInEntry
510     MAX-ACCESS  not-accessible
511     STATUS      current
512     DESCRIPTION
513         "Response statistics for an individual service."
514     INDEX       { wwwServiceIndex, wwwResponseInIndex }
515     ::= { wwwResponseInTable 1 }
516
517 WwwResponseInEntry ::= SEQUENCE {
518     wwwResponseInIndex          WwwResponseType,
519     wwwResponseInResponses      Counter32,
520     wwwResponseInBytes          Counter32,
521     wwwResponseInLastTime       DateAndTime
522 }
523
524 wwwResponseInIndex OBJECT-TYPE
525     SYNTAX      WwwResponseType
526     MAX-ACCESS  not-accessible
527     STATUS      current
528     DESCRIPTION
529         "The particular response type the statistics apply to."
530     ::= { wwwResponseInEntry 1 }
531
532 wwwResponseInResponses OBJECT-TYPE
533     SYNTAX      Counter32
534     MAX-ACCESS  read-only
535     STATUS      current
536     DESCRIPTION
537         "The number of responses of this type received by this
538          WWW service."
539     ::= { wwwResponseInEntry 2 }
540
541 wwwResponseInBytes OBJECT-TYPE
542     SYNTAX      Counter32
543     MAX-ACCESS  read-only
544     STATUS      current
545     DESCRIPTION
546         "The number of content bytes per response type received
547          by this WWW service."
548     ::= { wwwResponseInEntry 3 }
549
550 wwwResponseInLastTime OBJECT-TYPE
551     SYNTAX      DateAndTime
552     MAX-ACCESS  read-only
553     STATUS      current
554     DESCRIPTION
555         "The date and time when the last byte of the last complete
556          response of this type was received by this WWW service. The
557          value SHALL be '0000000000000000'H if no response of this
558          type has been received yet."
559     ::= { wwwResponseInEntry 4 }
560
561 wwwResponseOutTable OBJECT-TYPE
562     SYNTAX      SEQUENCE OF WwwResponseOutEntry
563     MAX-ACCESS  not-accessible
564     STATUS      current
565     DESCRIPTION
566         "The table providing detailed statistics for responses
567          generated by services on this system."
568     ::= { wwwProtocolStatistics 5 }
569
570 wwwResponseOutEntry OBJECT-TYPE
571     SYNTAX      WwwResponseOutEntry
572     MAX-ACCESS  not-accessible
573     STATUS      current
574     DESCRIPTION
575         "Response statistics for an individual service."
576     INDEX       { wwwServiceIndex, wwwResponseOutIndex }
577     ::= { wwwResponseOutTable 1 }
578
579 WwwResponseOutEntry ::= SEQUENCE {
580     wwwResponseOutIndex         WwwResponseType,
581     wwwResponseOutResponses     Counter32,
582     wwwResponseOutBytes         Counter32,
583     wwwResponseOutLastTime      DateAndTime
584 }
585
586 wwwResponseOutIndex OBJECT-TYPE
587     SYNTAX      WwwResponseType
588     MAX-ACCESS  not-accessible
589     STATUS      current
590     DESCRIPTION
591         "The particular response type the statistics apply to."
592     ::= { wwwResponseOutEntry 1 }
593
594 wwwResponseOutResponses OBJECT-TYPE
595     SYNTAX      Counter32
596     MAX-ACCESS  read-only
597     STATUS      current
598     DESCRIPTION
599         "The number of responses of this type generated by this
600          WWW service."
601     ::= { wwwResponseOutEntry 2 }
602
603 wwwResponseOutBytes OBJECT-TYPE
604     SYNTAX      Counter32
605     MAX-ACCESS  read-only
606     STATUS      current
607     DESCRIPTION
608         "The number of content bytes per response type generated
609          by this WWW service."
610     ::= { wwwResponseOutEntry 3 }
611
612 wwwResponseOutLastTime OBJECT-TYPE
613     SYNTAX      DateAndTime
614     MAX-ACCESS  read-only
615     STATUS      current
616     DESCRIPTION
617         "The date and time when the first byte of the last response of
618          this type was sent by this WWW service. The value SHALL be
619          '0000000000000000'H if response of this type has been send
620          yet."
621     ::= { wwwResponseOutEntry 4 }
622
623
624 -- The WWW Document Statistics Group
625 --
626 -- The WWW document statistics group contains statistics about
627 -- document read attempts.
628
629 wwwDocumentStatistics OBJECT IDENTIFIER ::= { wwwMIBObjects 3 }
630
631 wwwDocCtrlTable OBJECT-TYPE
632     SYNTAX      SEQUENCE OF WwwDocCtrlEntry
633     MAX-ACCESS  not-accessible
634     STATUS      current
635     DESCRIPTION
636         "A table which controls how the MIB implementation
637          collects and maintains document statistics."
638     ::= { wwwDocumentStatistics 1 }
639
640 wwwDocCtrlEntry OBJECT-TYPE
641     SYNTAX      WwwDocCtrlEntry
642     MAX-ACCESS  not-accessible
643     STATUS      current
644     DESCRIPTION
645         "An entry used to configure the wwwDocLastNTable,
646          the wwwDocBucketTable, the wwwDocAccessTopNTable,
647          and the wwwDocBytesTopNTable."
648     INDEX       { wwwServiceIndex }
649     ::= { wwwDocCtrlTable 1 }
650
651 WwwDocCtrlEntry ::= SEQUENCE {
652     wwwDocCtrlLastNSize           Unsigned32,
653     wwwDocCtrlLastNLock           TimeTicks,
654     wwwDocCtrlBuckets             Unsigned32,
655     wwwDocCtrlBucketTimeInterval  TimeInterval,
656     wwwDocCtrlTopNSize            Unsigned32
657 }
658
659 wwwDocCtrlLastNSize OBJECT-TYPE
660     SYNTAX      Unsigned32
661     MAX-ACCESS  read-write
662     STATUS      current
663     DESCRIPTION
664         "The maximum number of entries in the wwwDocLastNTable."
665     DEFVAL { 25 }
666     ::= { wwwDocCtrlEntry 1 }
667
668 wwwDocCtrlLastNLock OBJECT-TYPE
669     SYNTAX      TimeTicks
670     MAX-ACCESS  read-write
671     STATUS      current
672     DESCRIPTION
673         "This object allows a manager to lock the wwwDocLastNTable
674          in order to retrieve the wwwDocLastNTable in a consistent
675          state. The agent is expected to take a snapshot of the
676          wwwDocLastNTable when it is locked and to continue updating
677          the real wwwDocLastNTable table so that recent information is
678          available as soon as the wwwDocLastNTable is unlocked again.
679
680          Setting this object to a value greater than 0 will lock
681          the table. The timer ticks backwards until it reaches 0.
682          The table unlocks automatically once the timer reaches 0
683          and the timer stops ticking.
684
685          A manager can increase the timer to request more time to
686          read the table. However, any attempt to decrease the timer
687          will fail with an inconsistentValue error. This rule ensures
688          that multiple managers can simultaneously lock and retrieve
689          the wwwDocLastNTable. Note that managers must cooperate in
690          using wwwDocCtrlLastNLock. In particular, a manager MUST not
691          keep the wwwDocLastNTable locked when it is not necessary to
692          finish a retrieval operation."
693     ::= { wwwDocCtrlEntry 2 }
694
695 wwwDocCtrlBuckets OBJECT-TYPE
696     SYNTAX      Unsigned32
697     MAX-ACCESS  read-write
698     STATUS      current
699     DESCRIPTION
700         "The maximum number of buckets maintained by the agent
701          before the oldest bucket is deleted. The buckets are
702          used to populate the wwwDocAccessTopNTable and the
703          wwwDocBytesTopNTable. The time interval captured in
704          each bucket can be configured by setting the
705          wwwDocCtrlBucketTimeInterval object."
706     DEFVAL { 4 }        -- 4 buckets times 15 minutes = 1 hour
707     ::= { wwwDocCtrlEntry 3 }
708
709 wwwDocCtrlBucketTimeInterval OBJECT-TYPE
710     SYNTAX      TimeInterval
711     MAX-ACCESS  read-write
712     STATUS      current
713     DESCRIPTION
714         "The time interval after which a new bucket is created.
715          Changing this object has no effect on existing buckets."
716     DEFVAL { 90000 }    -- 15 minutes (resolution .01 s)
717     ::= { wwwDocCtrlEntry 4 }
718
719 wwwDocCtrlTopNSize OBJECT-TYPE
720     SYNTAX      Unsigned32
721     MAX-ACCESS  read-write
722     STATUS      current
723     DESCRIPTION
724         "The maximum number of entries shown in the
725          wwwDocAccessTopNTable and the wwwDocBytesTopNTable.
726          Changing this object has no effect on existing buckets."
727     DEFVAL { 25 }
728     ::= { wwwDocCtrlEntry 5 }
729
730
731 wwwDocLastNTable OBJECT-TYPE
732     SYNTAX      SEQUENCE OF WwwDocLastNEntry
733     MAX-ACCESS  not-accessible
734     STATUS      current
735     DESCRIPTION
736         "The table which logs the last N access attempts."
737     ::= { wwwDocumentStatistics 2 }
738
739 wwwDocLastNEntry OBJECT-TYPE
740     SYNTAX      WwwDocLastNEntry
741     MAX-ACCESS  not-accessible
742     STATUS      current
743     DESCRIPTION
744         "An entry which describes a recent access attempt."
745     INDEX       { wwwServiceIndex, wwwDocLastNIndex }
746     ::= { wwwDocLastNTable 1 }
747
748 WwwDocLastNEntry ::= SEQUENCE {
749     wwwDocLastNIndex            Unsigned32,
750     wwwDocLastNName             WwwDocName,
751     wwwDocLastNTimeStamp        DateAndTime,
752     wwwDocLastNRequestType      WwwRequestType,
753     wwwDocLastNResponseType     WwwResponseType,
754     wwwDocLastNStatusMsg        Utf8String,
755     wwwDocLastNBytes            Unsigned32
756 }
757
758 wwwDocLastNIndex OBJECT-TYPE
759     SYNTAX      Unsigned32 (1..4294967295)
760     MAX-ACCESS  not-accessible
761     STATUS      current
762     DESCRIPTION
763         "An arbitrary monotonically increasing integer number used
764          for indexing the wwwDocLastNTable. The first document
765          accessed appears in the table with this index value equal
766          to one. Each subsequent document is indexed with the next
767          sequential index value. The Nth document accessed will be
768          indexed by N. This table presents a sliding window of the
769          last wwwDocCtrlLastNSize documents accessed. Thus, entries
770          in this table will be indexed by N-wwwDocCtrlLastNSize
771          thru N if N > wwwDocCtrlLastNSize and 1 thru N if
772          N <= wwwDocCtrlLastNSize.
773
774          The wwwDocCtrlLastNLock attribute can be used to lock
775          this table to allow the manager to read its contents."
776     ::= { wwwDocLastNEntry 1 }
777
778 wwwDocLastNName OBJECT-TYPE
779     SYNTAX      WwwDocName
780     MAX-ACCESS  read-only
781     STATUS      current
782     DESCRIPTION
783         "The name of the document for which access was attempted."
784     ::= { wwwDocLastNEntry 2 }
785
786 wwwDocLastNTimeStamp OBJECT-TYPE
787     SYNTAX      DateAndTime
788     MAX-ACCESS  read-only
789     STATUS      current
790     DESCRIPTION
791         "The date and time of the last attempt to access this
792          document."
793     ::= { wwwDocLastNEntry 3 }
794
795 wwwDocLastNRequestType OBJECT-TYPE
796     SYNTAX      WwwRequestType
797     MAX-ACCESS  read-only
798     STATUS      current
799     DESCRIPTION
800         "The protocol request type which was received by the
801          server when this document access was attempted."
802     ::= { wwwDocLastNEntry 4 }
803
804 wwwDocLastNResponseType OBJECT-TYPE
805     SYNTAX      WwwResponseType
806     MAX-ACCESS  read-only
807     STATUS      current
808     DESCRIPTION
809         "The protocol response type which was sent to the client
810          as a result of this attempt to access a document. This
811          object contains the type of the primary response if
812          there were multiple responses to a single request."
813     ::= { wwwDocLastNEntry 5 }
814
815 wwwDocLastNStatusMsg OBJECT-TYPE
816     SYNTAX      Utf8String
817     MAX-ACCESS  read-only
818     STATUS      current
819     DESCRIPTION
820         "This object contains a human readable description of the
821          reason why the wwwDocLastNResponseType was returned to the
822          client. This object defines the implementation-specific
823          reason if the value of wwwDocLastNResponseType indicates
824          an error. For example, this object can indicate that the
825          requested document could not be transferred due to a
826          timeout condition or the document could not be transferred
827          because a 'soft link' pointing to the document could not be
828          resolved."
829     ::= { wwwDocLastNEntry 6 }
830
831 wwwDocLastNBytes OBJECT-TYPE
832     SYNTAX      Unsigned32
833     MAX-ACCESS  read-only
834     STATUS      current
835     DESCRIPTION
836         "The number of content bytes that were returned as a
837          result of this attempt to access a document."
838     ::= { wwwDocLastNEntry 7 }
839
840
841 wwwDocBucketTable OBJECT-TYPE
842     SYNTAX      SEQUENCE OF WwwDocBucketEntry
843     MAX-ACCESS  not-accessible
844     STATUS      current
845     DESCRIPTION
846         "This table provides administrative summary information for
847          the buckets maintained per WWW service."
848     ::= { wwwDocumentStatistics 3 }
849
850 wwwDocBucketEntry OBJECT-TYPE
851     SYNTAX      WwwDocBucketEntry
852     MAX-ACCESS  not-accessible
853     STATUS      current
854     DESCRIPTION
855         "An entry which describes the parameters associated with a
856          particular bucket."
857     INDEX       { wwwServiceIndex, wwwDocBucketIndex }
858     ::= { wwwDocBucketTable 1 }
859
860 WwwDocBucketEntry ::= SEQUENCE {
861     wwwDocBucketIndex           Unsigned32,
862     wwwDocBucketTimeStamp       DateAndTime,
863     wwwDocBucketAccesses        Unsigned32,
864     wwwDocBucketDocuments       Unsigned32,
865     wwwDocBucketBytes           Unsigned32
866 }
867
868 wwwDocBucketIndex OBJECT-TYPE
869     SYNTAX      Unsigned32 (1..4294967295)
870     MAX-ACCESS  not-accessible
871     STATUS      current
872     DESCRIPTION
873         "An arbitrary monotonically increasing integer number
874          used for indexing the wwwDocBucketTable. The index number
875          wraps to 1 whenever the maximum value is reached."
876     ::= { wwwDocBucketEntry 1 }
877
878 wwwDocBucketTimeStamp OBJECT-TYPE
879     SYNTAX      DateAndTime
880     MAX-ACCESS  read-only
881     STATUS      current
882     DESCRIPTION
883         "The date and time when the bucket was made available."
884     ::= { wwwDocBucketEntry 2 }
885
886 wwwDocBucketAccesses OBJECT-TYPE
887     SYNTAX      Unsigned32
888     MAX-ACCESS  read-only
889     STATUS      current
890     DESCRIPTION
891         "The total number of access attempts for any document
892          provided by this WWW service during the time interval
893          over which this bucket was created."
894     ::= { wwwDocBucketEntry 3 }
895
896 wwwDocBucketDocuments OBJECT-TYPE
897     SYNTAX      Unsigned32
898     MAX-ACCESS  read-only
899     STATUS      current
900     DESCRIPTION
901         "The total number of different documents for which access
902          was attempted this this WWW service during the time interval
903          over which this bucket was created."
904     ::= { wwwDocBucketEntry 4 }
905
906 wwwDocBucketBytes OBJECT-TYPE
907     SYNTAX      Unsigned32
908     MAX-ACCESS  read-only
909     STATUS      current
910     DESCRIPTION
911         "The total number of content bytes which were transferred
912          from this WWW service during the time interval over which
913          this bucket was created."
914     ::= { wwwDocBucketEntry 5 }
915
916
917 wwwDocAccessTopNTable OBJECT-TYPE
918     SYNTAX      SEQUENCE OF WwwDocAccessTopNEntry
919     MAX-ACCESS  not-accessible
920     STATUS      current
921     DESCRIPTION
922         "The table of the most frequently accessed documents in a
923          given bucket. This table is sorted by the column
924          wwwDocAccessTopNAccesses. Entries having the same number
925          of accesses are secondarily sorted by wwwDocAccessTopNBytes.
926          Entries with the same number of accesses and the same
927          number of bytes will have an arbitrary order."
928     ::= { wwwDocumentStatistics 4 }
929
930 wwwDocAccessTopNEntry OBJECT-TYPE
931     SYNTAX      WwwDocAccessTopNEntry
932     MAX-ACCESS  not-accessible
933     STATUS      current
934     DESCRIPTION
935         "An entry in the top N table sorted by document accesses."
936     INDEX       { wwwServiceIndex, wwwDocBucketIndex,
937                   wwwDocAccessTopNIndex }
938     ::= { wwwDocAccessTopNTable 1 }
939
940 WwwDocAccessTopNEntry ::= SEQUENCE {
941     wwwDocAccessTopNIndex             Unsigned32,
942     wwwDocAccessTopNName              WwwDocName,
943     wwwDocAccessTopNAccesses          Unsigned32,
944     wwwDocAccessTopNBytes             Unsigned32,
945     wwwDocAccessTopNLastResponseType  WwwResponseType
946 }
947
948 wwwDocAccessTopNIndex OBJECT-TYPE
949     SYNTAX      Unsigned32 (1..4294967295)
950     MAX-ACCESS  not-accessible
951     STATUS      current
952     DESCRIPTION
953         "An arbitrary monotonically increasing integer number
954          used for indexing the wwwDocAccessTopNTable. The index is
955          inversely correlated to the sorting order of the table. The
956          document with the highest access count will get the index
957          value 1."
958     ::= { wwwDocAccessTopNEntry 1 }
959
960 wwwDocAccessTopNName OBJECT-TYPE
961     SYNTAX      WwwDocName
962     MAX-ACCESS  read-only
963     STATUS      current
964     DESCRIPTION
965         "The name of the document for which access was attempted."
966     ::= { wwwDocAccessTopNEntry 2 }
967
968 wwwDocAccessTopNAccesses OBJECT-TYPE
969     SYNTAX      Unsigned32
970     MAX-ACCESS  read-only
971     STATUS      current
972     DESCRIPTION
973         "The total number of access attempts for this document."
974     ::= { wwwDocAccessTopNEntry 3 }
975
976 wwwDocAccessTopNBytes OBJECT-TYPE
977     SYNTAX      Unsigned32
978     MAX-ACCESS  read-only
979     STATUS      current
980     DESCRIPTION
981         "The total number of content bytes that were transmitted
982          as a result of attempts to access this document."
983     ::= { wwwDocAccessTopNEntry 4 }
984
985 wwwDocAccessTopNLastResponseType OBJECT-TYPE
986     SYNTAX      WwwResponseType
987     MAX-ACCESS  read-only
988     STATUS      current
989     DESCRIPTION
990         "The protocol response type which was sent to the client
991          as a result of the last attempt to access this document.
992          This object contains the type of the primary response if
993          there were multiple responses to a single request."
994     ::= { wwwDocAccessTopNEntry 5 }
995
996
997 wwwDocBytesTopNTable OBJECT-TYPE
998     SYNTAX      SEQUENCE OF WwwDocBytesTopNEntry
999     MAX-ACCESS  not-accessible
1000     STATUS      current
1001     DESCRIPTION
1002         "The table of the documents which caused most network
1003          traffic in a given bucket. This table is sorted by the
1004          column wwwDocBytesTopNBytes. Entries having the same number
1005          bytes are secondarily sorted by wwwDocBytesTopNAccesses.
1006          Entries with the same number of accesses and the same
1007          number of bytes will have an arbitrary order."
1008     ::= { wwwDocumentStatistics 5 }
1009
1010 wwwDocBytesTopNEntry OBJECT-TYPE
1011     SYNTAX      WwwDocBytesTopNEntry
1012     MAX-ACCESS  not-accessible
1013     STATUS      current
1014     DESCRIPTION
1015         "An entry in the top N table sorted by network traffic."
1016     INDEX       { wwwServiceIndex, wwwDocBucketIndex,
1017                   wwwDocBytesTopNIndex }
1018     ::= { wwwDocBytesTopNTable 1 }
1019
1020 WwwDocBytesTopNEntry ::= SEQUENCE {
1021     wwwDocBytesTopNIndex             Unsigned32,
1022     wwwDocBytesTopNName              WwwDocName,
1023     wwwDocBytesTopNAccesses          Unsigned32,
1024     wwwDocBytesTopNBytes             Unsigned32,
1025     wwwDocBytesTopNLastResponseType  WwwResponseType
1026 }
1027
1028 wwwDocBytesTopNIndex OBJECT-TYPE
1029     SYNTAX      Unsigned32 (1..4294967295)
1030     MAX-ACCESS  not-accessible
1031     STATUS      current
1032     DESCRIPTION
1033         "An arbitrary monotonically increasing integer number
1034          used for indexing the wwwDocBytesTopNTable. The index is
1035          inversely correlated to the sorting order of the table. The
1036          document with the highest byte count will get the index
1037          value 1."
1038     ::= { wwwDocBytesTopNEntry 1 }
1039
1040 wwwDocBytesTopNName OBJECT-TYPE
1041     SYNTAX      WwwDocName
1042     MAX-ACCESS  read-only
1043     STATUS      current
1044     DESCRIPTION
1045         "The name of the document for which access was attempted."
1046     ::= { wwwDocBytesTopNEntry 2 }
1047
1048 wwwDocBytesTopNAccesses OBJECT-TYPE
1049     SYNTAX      Unsigned32
1050     MAX-ACCESS  read-only
1051     STATUS      current
1052     DESCRIPTION
1053         "The total number of access attempts for this document."
1054     ::= { wwwDocBytesTopNEntry 3 }
1055
1056 wwwDocBytesTopNBytes OBJECT-TYPE
1057     SYNTAX      Unsigned32
1058     MAX-ACCESS  read-only
1059     STATUS      current
1060     DESCRIPTION
1061         "The total number of content bytes that were transmitted
1062          as a result of attempts to access this document."
1063     ::= { wwwDocBytesTopNEntry 4 }
1064
1065 wwwDocBytesTopNLastResponseType OBJECT-TYPE
1066     SYNTAX      WwwResponseType
1067     MAX-ACCESS  read-only
1068     STATUS      current
1069     DESCRIPTION
1070         "The protocol response type which was sent to the client
1071          as a result of the last attempt to access this document.
1072          This object contains the type of the primary response if
1073          there were multiple responses to a single request."
1074     ::= { wwwDocBytesTopNEntry 5 }
1075
1076 --
1077 -- Conformance Definitions
1078 --
1079
1080 wwwMIBCompliances OBJECT IDENTIFIER ::= { wwwMIBConformance 1 }
1081 wwwMIBGroups      OBJECT IDENTIFIER ::= { wwwMIBConformance 2 }
1082
1083 wwwMinimalCompliance MODULE-COMPLIANCE
1084     STATUS      current
1085     DESCRIPTION
1086         "The compliance statement for SNMP agents which implement
1087          the minimal subset of the WWW-MIB. Implementors might
1088          choose this subset for high-performance server where
1089          full compliance might be to expensive."
1090     MODULE  -- this module
1091     MANDATORY-GROUPS {
1092         wwwServiceGroup,
1093         wwwSummaryGroup
1094     }
1095     OBJECT wwwSummaryOutRequests
1096     DESCRIPTION
1097         "Instances of wwwSummaryOutRequests do not exist on pure
1098          WWW server implementations."
1099     OBJECT wwwSummaryInResponses
1100     DESCRIPTION
1101         "Instances of wwwSummaryOutRequests do not exist on pure
1102          WWW server implementations."
1103     OBJECT wwwSummaryInRequests
1104     DESCRIPTION
1105         "Instances of wwwSummaryInRequests do not exist on pure
1106          WWW client implementations."
1107     OBJECT wwwSummaryOutResponses
1108     DESCRIPTION
1109         "Instances of wwwSummaryOutResponses do not exist on pure
1110          WWW client implementations."
1111     ::= { wwwMIBCompliances 1 }
1112
1113 wwwFullCompliance MODULE-COMPLIANCE
1114     STATUS      current
1115     DESCRIPTION
1116         "The compliance statement for SNMP agents which implement
1117          the full WWW-MIB."
1118     MODULE  -- this module
1119     MANDATORY-GROUPS {
1120         wwwServiceGroup,
1121         wwwSummaryGroup
1122     }
1123     GROUP  wwwRequestInGroup
1124     DESCRIPTION
1125         "The wwwRequestInGroup is mandatory only for WWW server
1126          or proxy server implementations."
1127     GROUP wwwResponseOutGroup
1128     DESCRIPTION
1129         "The wwwResponseOutGroup is mandatory only for WWW server
1130          or proxy server implementations."
1131     GROUP wwwRequestOutGroup
1132     DESCRIPTION
1133         "The wwwRequestOutGroup is mandatory only for WWW client
1134          or proxy server implementations."
1135     GROUP wwwResponseInGroup
1136     DESCRIPTION
1137         "The wwwRequestOutGroup is mandatory only for WWW client
1138          or proxy server implementations."
1139     GROUP wwwDocumentGroup
1140     DESCRIPTION
1141         "The wwwDocumentGroup is mandatory only for WWW server
1142          or proxy server implementations."
1143     OBJECT wwwSummaryOutRequests
1144     DESCRIPTION
1145         "Instances of wwwSummaryOutRequests do not exist on pure
1146          WWW server implementations."
1147     OBJECT wwwSummaryInResponses
1148     DESCRIPTION
1149         "Instances of wwwSummaryOutRequests do not exist on pure
1150          WWW server implementations."
1151     OBJECT wwwSummaryInRequests
1152     DESCRIPTION
1153         "Instances of wwwSummaryInRequests do not exist on pure
1154          WWW client implementations."
1155     OBJECT wwwSummaryOutResponses
1156     DESCRIPTION
1157         "Instances of wwwSummaryOutResponses do not exist on pure
1158          WWW client implementations."
1159     ::= { wwwMIBCompliances 2 }
1160
1161 wwwServiceGroup OBJECT-GROUP
1162     OBJECTS {
1163         wwwServiceDescription,
1164         wwwServiceContact,
1165         wwwServiceProtocol,
1166         wwwServiceName,
1167         wwwServiceType,
1168         wwwServiceStartTime,
1169         wwwServiceOperStatus,
1170         wwwServiceLastChange
1171     }
1172     STATUS      current
1173     DESCRIPTION
1174         "A collection of objects providing information about
1175          the WWW services known by the SNMP agent."
1176     ::= { wwwMIBGroups 1 }
1177
1178 wwwSummaryGroup OBJECT-GROUP
1179     OBJECTS {
1180         wwwSummaryInRequests,
1181         wwwSummaryOutRequests,
1182         wwwSummaryInResponses,
1183         wwwSummaryOutResponses,
1184         wwwSummaryInBytes,
1185         wwwSummaryInLowBytes,
1186         wwwSummaryOutBytes,
1187         wwwSummaryOutLowBytes
1188     }
1189     STATUS      current
1190     DESCRIPTION
1191         "A collection of objects providing summary statistics
1192          about requests and responses generated and received
1193          by a WWW service."
1194     ::= { wwwMIBGroups 2 }
1195
1196 wwwRequestInGroup OBJECT-GROUP
1197     OBJECTS {
1198         wwwRequestInRequests,
1199         wwwRequestInBytes,
1200         wwwRequestInLastTime
1201     }
1202     STATUS      current
1203     DESCRIPTION
1204         "A collection of objects providing detailed statistics
1205          about requests received by a WWW service."
1206     ::= { wwwMIBGroups 3 }
1207
1208 wwwRequestOutGroup OBJECT-GROUP
1209     OBJECTS {
1210         wwwRequestOutRequests,
1211         wwwRequestOutBytes,
1212         wwwRequestOutLastTime
1213     }
1214     STATUS      current
1215     DESCRIPTION
1216         "A collection of objects providing detailed statistics
1217          about requests generated by a WWW service."
1218     ::= { wwwMIBGroups 4 }
1219
1220 wwwResponseInGroup OBJECT-GROUP
1221     OBJECTS {
1222         wwwResponseInResponses,
1223         wwwResponseInBytes,
1224         wwwResponseInLastTime
1225     }
1226     STATUS      current
1227     DESCRIPTION
1228         "A collection of objects providing detailed statistics
1229          about responses received by a WWW service."
1230     ::= { wwwMIBGroups 5 }
1231
1232 wwwResponseOutGroup OBJECT-GROUP
1233     OBJECTS {
1234         wwwResponseOutResponses,
1235         wwwResponseOutBytes,
1236         wwwResponseOutLastTime
1237     }
1238     STATUS      current
1239     DESCRIPTION
1240         "A collection of objects providing detailed statistics
1241          about responses generated by a WWW service."
1242     ::= { wwwMIBGroups 6 }
1243
1244 wwwDocumentGroup OBJECT-GROUP
1245     OBJECTS {
1246         wwwDocCtrlLastNSize,
1247         wwwDocCtrlLastNLock,
1248         wwwDocCtrlBuckets,
1249         wwwDocCtrlBucketTimeInterval,
1250         wwwDocCtrlTopNSize,
1251         wwwDocLastNName,
1252         wwwDocLastNTimeStamp,
1253         wwwDocLastNRequestType,
1254         wwwDocLastNResponseType,
1255         wwwDocLastNStatusMsg,
1256         wwwDocLastNBytes,
1257         wwwDocBucketTimeStamp,
1258         wwwDocBucketAccesses,
1259         wwwDocBucketDocuments,
1260         wwwDocBucketBytes,
1261         wwwDocAccessTopNName,
1262         wwwDocAccessTopNAccesses,
1263         wwwDocAccessTopNBytes,
1264         wwwDocAccessTopNLastResponseType,
1265         wwwDocBytesTopNName,
1266         wwwDocBytesTopNAccesses,
1267         wwwDocBytesTopNBytes,
1268         wwwDocBytesTopNLastResponseType
1269     }
1270     STATUS  current
1271     DESCRIPTION
1272         "A collection of objects providing information about
1273          accesses to documents."
1274     ::= { wwwMIBGroups 7 }
1275
1276 END