← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/net-snmp/intrepid-updates

« back to all changes in this revision

Viewing changes to mibs/DISMAN-PING-MIB.txt

  • Committer: Bazaar Package Importer
  • Author(s): Scott James Remnant
  • Date: 2006-11-28 12:29:34 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20061128122934-82xxzy2zcvypnvy7
Tags: 5.2.3-4ubuntu1
* Merge from debian unstable, remaining changes:
  - remove stop links from rc0 and rc6

Show diffs side-by-side

added added

removed removed

Lines of Context:
mibs/DISMAN-PING-MIB.txt
2
2
 
3
3
IMPORTS
4
4
    MODULE-IDENTITY, OBJECT-TYPE, Integer32,
5
 
    Unsigned32, mib-2,
 
5
    Unsigned32, Gauge32, mib-2,
6
6
    NOTIFICATION-TYPE, OBJECT-IDENTITY
7
7
        FROM SNMPv2-SMI                  -- RFC2578
8
8
    TEXTUAL-CONVENTION, RowStatus,
14
14
    InterfaceIndexOrZero                 -- RFC2863
15
15
        FROM IF-MIB
16
16
    SnmpAdminString
17
 
        FROM SNMP-FRAMEWORK-MIB          -- RFC2571
 
17
        FROM SNMP-FRAMEWORK-MIB          -- RFC3411
18
18
    InetAddressType, InetAddress
19
 
        FROM INET-ADDRESS-MIB;           -- RFC2851
 
19
        FROM INET-ADDRESS-MIB;           -- RFC4001
20
20
 
21
21
 pingMIB MODULE-IDENTITY
22
 
    LAST-UPDATED "200009210000Z"         -- 21 September 2000
 
22
    LAST-UPDATED "200606130000Z"         -- 13 June 2006
23
23
    ORGANIZATION "IETF Distributed Management Working Group"
24
24
    CONTACT-INFO
25
 
 
26
 
 
27
 
 
28
 
 
29
 
 
30
 
        "Kenneth White
31
 
 
32
 
        International Business Machines Corporation
33
 
        Network Computing Software Division
34
 
        Research Triangle Park, NC, USA
35
 
 
36
 
        E-mail: wkenneth@us.ibm.com"
 
25
        "Juergen Quittek
 
26
 
 
27
        NEC Europe Ltd.
 
28
        Network Laboratories
 
29
        Kurfuersten-Anlage 36
 
30
        69115 Heidelberg
 
31
        Germany
 
32
 
 
33
        Phone: +49 6221 4342-115
 
34
 
 
35
        Email: quittek@netlab.nec.de"
37
36
    DESCRIPTION
38
37
        "The Ping MIB (DISMAN-PING-MIB) provides the capability of
39
38
        controlling the use of the ping function at a remote
40
 
        host."
 
39
        host.
 
40
 
 
41
        Copyright (C) The Internet Society (2006).  This version of
 
42
        this MIB module is part of RFC 4560; see the RFC itself for
 
43
        full legal notices."
41
44
 
42
45
     --  Revision history
43
46
 
 
47
     REVISION     "200606130000Z"         -- 13 June 2006
 
48
     DESCRIPTION
 
49
         "Updated version, published as RFC 4560.
 
50
             - Correctly considered IPv6 in DESCRIPTION
 
51
               clause of pingCtlDataSize
 
52
             - Replaced references to RFC 2575 by RFC 3415
 
53
             - Replaced references to RFC 2571 by RFC 3411
 
54
             - Replaced references to RFC 2851 by RFC 4001
 
55
             - Added DEFVAL { {} } to definition of
 
56
               pingCtlTrapGeneration
 
57
             - Changed DEFVAL of object pingCtlDescr from
 
58
               DEFVAL { '00'H } to DEFVAL { ''H }
 
59
             - Changed DEFVAL of object pingCtlSourceAddressType
 
60
               from DEFVAL { ipv4 } to DEFVAL { unknown }
 
61
             - Extended DESCRIPTION clause of pingResultsTable
 
62
               describing re-initialization of entries
 
63
             - Changed SYNTAX of pingResultsProbeResponses and
 
64
               pingResultsSentProbes from Unsigned32 to Gauge32
 
65
             - Changed status of pingCompliance to deprecated
 
66
             - Added pingFullCompliance and pingMinimumCompliance
 
67
             - Changed status of pingGroup and pingTimeStampGroup
 
68
               to deprecated
 
69
             - Added pingMinimumGroup, pingCtlRowStatusGroup,
 
70
               and pingHistoryGroup"
 
71
 
44
72
     REVISION     "200009210000Z"         -- 21 September 2000
45
73
     DESCRIPTION
46
74
         "Initial version, published as RFC 2925."
47
 
 
48
75
    ::= { mib-2 80 }
49
76
 
50
77
 -- Textual Conventions
54
81
    DESCRIPTION
55
82
        "Used to report the result of an operation:
56
83
 
57
 
         responseReceived(1) - Operation completes successfully.
 
84
         responseReceived(1) - Operation is completed successfully.
58
85
         unknown(2) - Operation failed due to unknown error.
59
86
         internalError(3) - An implementation detected an error
60
87
              in its own processing that caused an operation
65
92
              address.
66
93
         noRouteToTarget(6) - Could not find a route to target.
67
94
         interfaceInactiveToTarget(7) - The interface to be
68
 
              used in sending a probe is inactive without an
69
 
              alternate route existing.
 
95
              used in sending a probe is inactive, and an
 
96
              alternate route does not exist.
70
97
         arpFailure(8) - Unable to resolve a target address to a
71
 
              media specific address.
 
98
              media-specific address.
72
99
         maxConcurrentLimitReached(9) - The maximum number of
73
100
              concurrent active operations would have been exceeded
74
101
              if the corresponding operation was allowed.
75
102
         unableToResolveDnsName(10) - The DNS name specified was
76
103
              unable to be mapped to an IP address.
77
104
         invalidHostAddress(11) - The IP address for a host
78
 
 
79
 
 
80
 
 
81
 
 
82
 
 
83
105
              has been determined to be invalid.  Examples of this
84
106
              are broadcast or multicast addresses."
85
107
    SYNTAX INTEGER {
102
124
 pingObjects                    OBJECT IDENTIFIER ::= { pingMIB 1 }
103
125
 pingConformance                OBJECT IDENTIFIER ::= { pingMIB 2 }
104
126
 
105
 
 
106
127
 -- The registration node (point) for ping implementation types
107
128
 
108
129
 pingImplementationTypeDomains  OBJECT IDENTIFIER ::= { pingMIB 3 }
126
147
 pingSnmpQuery OBJECT-IDENTITY
127
148
    STATUS      current
128
149
    DESCRIPTION
129
 
        "Indicates that an implementation is an SNMP query to
130
 
        calculate a round trip time."
131
 
 
132
 
 
133
 
 
134
 
 
135
 
 
 
150
        "Indicates that an implementation is using an SNMP query
 
151
         to calculate a round trip time."
136
152
    ::= { pingImplementationTypeDomains 3 }
137
153
 
138
154
 pingTcpConnectionAttempt OBJECT-IDENTITY
143
159
        trip time."
144
160
    ::= { pingImplementationTypeDomains 4 }
145
161
 
146
 
 
147
162
 -- Simple Object Definitions
148
163
 
149
164
 pingMaxConcurrentRequests OBJECT-TYPE
155
170
       "The maximum number of concurrent active ping requests
156
171
       that are allowed within an agent implementation.  A value
157
172
       of 0 for this object implies that there is no limit for
158
 
       the number of concurrent active requests in effect."
 
173
       the number of concurrent active requests in effect.
 
174
 
 
175
       The limit applies only to new requests being activated.
 
176
       When a new value is set, the agent will continue processing
 
177
       all the requests already active, even if their number
 
178
       exceeds the limit just imposed."
159
179
    DEFVAL { 10 }
160
180
    ::= { pingObjects 1 }
161
181
 
181
201
        "Defines an entry in the pingCtlTable.  The first index
182
202
        element, pingCtlOwnerIndex, is of type SnmpAdminString,
183
203
        a textual convention that allows for use of the SNMPv3
184
 
 
185
 
 
186
 
 
187
 
 
188
 
 
189
 
        View-Based Access Control Model (RFC 2575 [11], VACM)
190
 
        and allows an management application to identify its
 
204
        View-Based Access Control Model (RFC 3415, VACM)
 
205
        and that allows a management application to identify its
191
206
        entries.  The second index, pingCtlTestName (also an
192
207
        SnmpAdminString), enables the same management
193
208
        application to have multiple outstanding requests."
232
247
       "To facilitate the provisioning of access control by a
233
248
       security administrator using the View-Based Access
234
249
       Control Model (RFC 2575, VACM) for tables in which
235
 
       multiple users may need to independently create or
236
 
       modify entries, the initial index is used as an 'owner
237
 
 
238
 
 
239
 
 
240
 
 
241
 
 
242
 
       index'.  Such an initial index has a syntax of
243
 
       SnmpAdminString, and can thus be trivially mapped to a
244
 
       securityName or groupName as defined in VACM, in
 
250
       multiple users may need to create or
 
251
       modify entries independently, the initial index is used
 
252
       as an 'owner index'.  Such an initial index has a syntax
 
253
       of SnmpAdminString and can thus be trivially mapped to a
 
254
       securityName or groupName defined in VACM, in
245
255
       accordance with a security policy.
246
256
 
247
 
       When used in conjunction with such a security policy all
 
257
       When used in conjunction with such a security policy, all
248
258
       entries in the table belonging to a particular user (or
249
259
       group) will have the same value for this initial index.
250
260
       For a given user's entries in a particular table, the
265
275
    STATUS      current
266
276
    DESCRIPTION
267
277
        "The name of the ping test.  This is locally unique, within
268
 
        the scope of an pingCtlOwnerIndex."
 
278
        the scope of a pingCtlOwnerIndex."
269
279
    ::= { pingCtlEntry 2 }
270
280
 
271
281
 pingCtlTargetAddressType OBJECT-TYPE
285
295
    DESCRIPTION
286
296
        "Specifies the host address to be used at a remote host for
287
297
        performing a ping operation.  The host address type is
288
 
        determined by the object value of corresponding
 
298
        determined by the value of the corresponding
289
299
        pingCtlTargetAddressType.
290
300
 
291
 
 
292
 
 
293
 
 
294
 
 
295
301
        A value for this object MUST be set prior to transitioning
296
302
        its corresponding pingCtlEntry to active(1) via
297
303
        pingCtlRowStatus."
305
311
    STATUS      current
306
312
    DESCRIPTION
307
313
        "Specifies the size of the data portion to be
308
 
        transmitted in a ping operation in octets.  A ping
309
 
        request is usually an ICMP message encoded
310
 
        into an IP packet.  An IP packet has a maximum size
311
 
        of 65535 octets.  Subtracting the size of the ICMP
312
 
        or UDP header (both 8 octets) and the size of the IP
313
 
        header (20 octets) yields a maximum size of 65507
314
 
        octets."
 
314
        transmitted in a ping operation, in octets.  Whether this
 
315
        value can be applied depends on the selected
 
316
        implementation method for performing a ping operation,
 
317
        indicated by pingCtlType in the same conceptual row.
 
318
        If the method used allows applying the value contained
 
319
 
 
320
        in this object, then it MUST be applied.  If the specified
 
321
        size is not appropriate for the chosen ping method, the
 
322
        implementation SHOULD use whatever size (appropriate to
 
323
        the method) is closest to the specified size.
 
324
 
 
325
        The maximum value for this object was computed by
 
326
        subtracting the smallest possible IP header size of
 
327
        20 octets (IPv4 header with no options) and the UDP
 
328
        header size of 8 octets from the maximum IP packet size.
 
329
        An IP packet has a maximum size of 65535 octets
 
330
        (excluding IPv6 Jumbograms)."
315
331
    DEFVAL { 0 }
316
332
    ::= { pingCtlEntry 5 }
317
333
 
333
349
    STATUS      current
334
350
    DESCRIPTION
335
351
        "Specifies the number of times to perform a ping
336
 
        operation at a remote host."
 
352
        operation at a remote host as part of a single ping test."
337
353
    DEFVAL { 1 }
338
354
    ::= { pingCtlEntry 7 }
339
355
 
340
356
 pingCtlAdminStatus OBJECT-TYPE
341
357
    SYNTAX      INTEGER {
342
358
                          enabled(1), -- test should be started
343
 
 
344
 
 
345
 
 
346
 
 
347
 
 
348
359
                          disabled(2) -- test should be stopped
349
360
                        }
350
361
    MAX-ACCESS  read-create
373
384
        corresponding pingCtlDataSize value to determine how to
374
385
        fill the data portion of a probe packet.  The option of
375
386
        selecting a data fill pattern can be useful when links
376
 
        are compressed or have data pattern sensitivities. The
 
387
        are compressed or have data pattern sensitivities.  The
377
388
        contents of pingCtlDataFill should be repeated in a ping
378
389
        packet when the size of the data portion of the ping
379
390
        packet is greater than the size of pingCtlDataFill."
393
404
        A single ping test consists of a series of ping probes.
394
405
        The number of probes is determined by the value of the
395
406
        corresponding pingCtlProbeCount object.  After a single
396
 
 
397
 
 
398
 
 
399
 
 
400
 
 
401
 
        test completes the number of seconds as defined by the
 
407
        test is completed the number of seconds as defined by the
402
408
        value of pingCtlFrequency MUST elapse before the
403
409
        next ping test is started.
404
410
 
414
420
    MAX-ACCESS  read-create
415
421
    STATUS      current
416
422
    DESCRIPTION
417
 
        "The maximum number of entries allowed in the
418
 
        pingProbeHistoryTable.  An implementation of this
419
 
        MIB will remove the oldest entry in the
 
423
        "The maximum number of corresponding entries allowed
 
424
        in the pingProbeHistoryTable.  An implementation of this
 
425
        MIB will remove the oldest corresponding entry in the
420
426
        pingProbeHistoryTable to allow the addition of an
421
 
        new entry once the number of rows in the
 
427
        new entry once the number of corresponding rows in the
422
428
        pingProbeHistoryTable reaches this value.
423
429
 
424
430
        Old entries are not removed when a new test is
446
452
    SYNTAX      BITS {
447
453
                   probeFailure(0),
448
454
                   testFailure(1),
449
 
 
450
 
 
451
 
 
452
 
 
453
 
 
454
455
                   testCompletion(2)
455
456
                  }
456
457
    MAX-ACCESS  read-create
457
458
    STATUS      current
458
459
    DESCRIPTION
459
 
        "The value of this object determines when and if
 
460
        "The value of this object determines when and whether
460
461
        to generate a notification for this entry:
461
462
 
462
463
        probeFailure(0)   - Generate a pingProbeFailed
463
464
            notification subject to the value of
464
465
            pingCtlTrapProbeFailureFilter.  The object
465
466
            pingCtlTrapProbeFailureFilter can be used
466
 
            to specify the number of successive probe failures
467
 
            that are required before a pingProbeFailed
468
 
            notification can be generated.
 
467
            to specify the number of consecutive probe
 
468
            failures that are required before a
 
469
            pingProbeFailed notification can be generated.
469
470
        testFailure(1)    - Generate a pingTestFailed
470
 
            notification. In this instance the object
 
471
            notification.  In this instance the object
471
472
            pingCtlTrapTestFailureFilter can be used to
472
473
            determine the number of probe failures that
473
474
            signal when a test fails.
474
475
        testCompletion(2) - Generate a pingTestCompleted
475
476
            notification.
476
477
 
477
 
        The value of this object defaults to zero, indicating
478
 
        that none of the above options have been selected."
 
478
        By default, no bits are set, indicating that
 
479
        none of the above options is selected."
 
480
    DEFVAL { {} }  -- no bits set.
479
481
    ::= { pingCtlEntry 13 }
480
482
 
481
483
 pingCtlTrapProbeFailureFilter OBJECT-TYPE
486
488
        "The value of this object is used to determine when
487
489
        to generate a pingProbeFailed NOTIFICATION.
488
490
 
489
 
        Setting pingCtlTrapGeneration
490
 
        to probeFailure(0) implies that a pingProbeFailed
491
 
        NOTIFICATION is generated only when the number of
492
 
        successive probe failures as indicated by the
493
 
        value of pingCtlTrapPrbefailureFilter fail within
494
 
        a given ping test."
 
491
        Setting BIT probeFailure(0) of object
 
492
        pingCtlTrapGeneration to '1' implies that a
 
493
        pingProbeFailed NOTIFICATION is generated only when
 
494
 
 
495
        a number of consecutive ping probes equal to the
 
496
        value of pingCtlTrapProbeFailureFilter fail within
 
497
        a given ping test.  After triggering the notification,
 
498
        the probe failure counter is reset to zero."
495
499
    DEFVAL { 1 }
496
500
    ::= { pingCtlEntry 14 }
497
501
 
499
503
    SYNTAX      Unsigned32 (0..15)
500
504
    MAX-ACCESS  read-create
501
505
    STATUS      current
502
 
 
503
 
 
504
 
 
505
 
 
506
 
 
507
506
    DESCRIPTION
508
507
        "The value of this object is used to determine when
509
508
        to generate a pingTestFailed NOTIFICATION.
510
509
 
511
 
        Setting pingCtlTrapGeneration to testFailure(1)
512
 
        implies that a pingTestFailed NOTIFICATION is
513
 
        generated only when the number of ping failures
514
 
        within a test exceed the value of
515
 
        pingCtlTrapTestFailureFilter."
 
510
        Setting BIT testFailure(1) of object
 
511
 
 
512
        pingCtlTrapGeneration to '1' implies that a
 
513
        pingTestFailed NOTIFICATION is generated only when
 
514
        a number of consecutive ping tests equal to the
 
515
        value of pingCtlTrapProbeFailureFilter fail.
 
516
        After triggering the notification, the test failure
 
517
        counter is reset to zero."
516
518
    DEFVAL { 1 }
517
519
    ::= { pingCtlEntry 15 }
518
520
 
521
523
    MAX-ACCESS  read-create
522
524
    STATUS      current
523
525
    DESCRIPTION
524
 
        "The value of this object is used to either report or
525
 
        select the implementation method to be used for
 
526
        "The value of this object is used either to report or
 
527
        to select the implementation method to be used for
526
528
        calculating a ping response time.  The value of this
527
529
        object MAY be selected from pingImplementationTypeDomains.
528
530
 
529
531
        Additional implementation types SHOULD be allocated as
530
532
        required by implementers of the DISMAN-PING-MIB under
531
 
        their enterprise specific registration point and not
 
533
        their enterprise-specific registration point and not
532
534
        beneath pingImplementationTypeDomains."
533
535
    DEFVAL { pingIcmpEcho }
534
536
    ::= { pingCtlEntry 16 }
540
542
    DESCRIPTION
541
543
        "The purpose of this object is to provide a
542
544
        descriptive name of the remote ping test."
543
 
    DEFVAL { '00'H }
 
545
    DEFVAL { ''H }
544
546
    ::= { pingCtlEntry 17 }
545
547
 
546
548
 pingCtlSourceAddressType OBJECT-TYPE
550
552
    DESCRIPTION
551
553
        "Specifies the type of the source address,
552
554
        pingCtlSourceAddress, to be used at a remote host
553
 
        when performing a ping operation."
554
 
    DEFVAL { ipv4 }
555
 
 
556
 
 
557
 
 
558
 
 
559
 
 
 
555
        when a ping operation is performed."
 
556
    DEFVAL { unknown }
560
557
    ::= { pingCtlEntry 18 }
561
558
 
562
559
  pingCtlSourceAddress OBJECT-TYPE
564
561
    MAX-ACCESS  read-create
565
562
    STATUS      current
566
563
    DESCRIPTION
567
 
        "Use the specified IP address (which must be given
568
 
        in numeric form, not as a hostname) as the source
569
 
        address in outgoing probe packets.  On hosts with
570
 
        more than one IP address, this option can be used
571
 
        to force the source address to be something other
572
 
        than the primary IP address of the interface the
573
 
        probe packet is sent on.  If the IP address is not
574
 
        one of this machine's interface addresses, an error
575
 
        is returned and nothing is sent.  A zero length
576
 
        octet string value for this object disables source
577
 
        address specification.
 
564
        "Use the specified IP address (which must be given in
 
565
        numeric form, not as a hostname) as the source address
 
566
        in outgoing probe packets.  On hosts with more than one
 
567
        IP address, this option can be used to select the address
 
568
        to be used.  If the IP address is not one of this
 
569
        machine's interface addresses, an error is returned and
 
570
        nothing is sent.  A zero-length octet string value for
 
571
        this object disables source address specification.
578
572
 
579
573
        The address type (InetAddressType) that relates to
580
574
        this object is specified by the corresponding value
596
590
    ::= { pingCtlEntry 20 }
597
591
 
598
592
 pingCtlByPassRouteTable OBJECT-TYPE
599
 
    SYNTAX TruthValue
 
593
    SYNTAX      TruthValue
600
594
    MAX-ACCESS  read-create
601
595
    STATUS      current
602
596
    DESCRIPTION
603
 
       "The purpose of this object is to optionally enable
 
597
       "The purpose of this object is to enable optional
604
598
       bypassing the route table.  If enabled, the remote
605
599
       host will bypass the normal routing tables and send
606
600
       directly to a host on an attached network.  If the
607
 
       host is not on a directly-attached network, an
608
 
 
609
 
 
610
 
 
611
 
 
612
 
 
 
601
       host is not on a directly attached network, an
613
602
       error is returned.  This option can be used to perform
614
603
       the ping operation to a local host through an
615
604
       interface that has no route defined (e.g., after the
616
 
       interface was dropped by routed)."
 
605
       interface was dropped by the routing daemon at the host)."
617
606
    DEFVAL { false }
618
607
    ::= { pingCtlEntry 21 }
619
608
 
622
611
    MAX-ACCESS  read-create
623
612
    STATUS      current
624
613
    DESCRIPTION
625
 
        "Specifies the value to store in the Differentiated
626
 
        Services (DS) Field in the IP packet used to
627
 
        encapsulate the ping probe.  The DS Field is defined
628
 
        as the Type of Service (TOS) octet in a IPv4 header
629
 
        or as the Traffic Class octet in a IPv6 header.
630
 
 
631
 
        The value of this object must be a decimal integer
632
 
        in the range from 0 to 255.  This option can be used
633
 
        to determine what effect an explicit DS Field setting
634
 
        has on a ping response.  Not all values are legal or
635
 
        meaningful.  A value of 0 means that the function
636
 
     represented by this option is not supported.  DS Field
637
 
     usage is often not supported by IP implementations and
638
 
     not all values are supported.  Refer to RFC 2474 for
639
 
     guidance on usage of this field."
 
614
        "Specifies the value to store in the Type of Service
 
615
        (TOS) octet in the IPv4 header or in the Traffic
 
616
        Class octet in the IPv6 header, respectively, of the
 
617
        IP packet used to encapsulate the ping probe.
 
618
 
 
619
        The octet to be set in the IP header contains the
 
620
        Differentiated Services (DS) Field in the six most
 
621
        significant bits.
 
622
 
 
623
        This option can be used to determine what effect an
 
624
        explicit DS Field setting has on a ping response.
 
625
        Not all values are legal or meaningful.  A value of 0
 
626
        means that the function represented by this option is
 
627
        not supported.  DS Field usage is often not supported
 
628
        by IP implementations, and not all values are supported.
 
629
        Refer to RFC 2474 and RFC 3260 for guidance on usage of
 
630
        this field."
640
631
    REFERENCE
641
 
        "Refer to RFC 2474 for the definition of the
642
 
        Differentiated Services Field and to RFC 1812
643
 
        Section 5.3.2 for Type of Service (TOS)."
 
632
        "Refer to RFC 1812 for the definition of the IPv4 TOS
 
633
        octet and to RFC 2460 for the definition of the IPv6
 
634
        Traffic Class octet.  Refer to RFC 2474 and RFC 3260
 
635
        for the definition of the Differentiated Services Field."
644
636
    DEFVAL { 0 }
645
637
    ::= { pingCtlEntry 22 }
646
638
 
651
643
    DESCRIPTION
652
644
        "This object allows entries to be created and deleted
653
645
        in the pingCtlTable.  Deletion of an entry in this
654
 
        table results in all corresponding (same
 
646
        table results in the deletion of all corresponding (same
655
647
        pingCtlOwnerIndex and pingCtlTestName index values)
656
 
        pingResultsTable and pingProbeHistoryTable entries
657
 
        being deleted.
 
648
        pingResultsTable and pingProbeHistoryTable entries.
658
649
 
659
650
        A value MUST be specified for pingCtlTargetAddress
660
 
        prior to a transition to active(1) state being
661
 
 
662
 
 
663
 
 
664
 
 
665
 
 
666
 
        accepted.
 
651
        prior to acceptance of a transition to active(1) state.
 
652
 
 
653
        When a value for pingCtlTargetAddress is set,
 
654
        the value of object pingCtlRowStatus changes
 
655
        from notReady(3) to notInService(2).
667
656
 
668
657
        Activation of a remote ping operation is controlled
669
 
        via pingCtlAdminStatus and not by changing
 
658
        via pingCtlAdminStatus, not by changing
670
659
        this object's value to active(1).
671
660
 
672
661
        Transitions in and out of active(1) state are not
673
662
        allowed while an entry's pingResultsOperStatus is
674
 
        active(1) with the exception that deletion of
 
663
        active(1), with the exception that deletion of
675
664
        an entry in this table by setting its RowStatus
676
665
        object to destroy(6) will stop an active
677
666
        ping operation.
694
683
        "Defines the Ping Results Table for providing
695
684
        the capability of performing ping operations at
696
685
        a remote host.  The results of these operations are
697
 
        stored in the pingResultsTable and the pingPastProbeTable.
 
686
        stored in the pingResultsTable and the pingProbeHistoryTable.
698
687
 
699
688
        An entry is added to the pingResultsTable when an
700
689
        pingCtlEntry is started by successful transition
701
690
        of its pingCtlAdminStatus object to enabled(1).
 
691
 
 
692
        If the object pingCtlAdminStatus already has the value
 
693
        enabled(1), and if the corresponding pingResultsOperStatus
 
694
        object has the value completed(3), then successfully writing
 
695
        enabled(1) to object pingCtlAdminStatus re-initializes the
 
696
        already existing entry in the pingResultsTable.  The values
 
697
        of objects in the re-initialized entry are the same as the
 
698
        values of objects in a new entry would be.
 
699
 
702
700
        An entry is removed from the pingResultsTable when
703
701
        its corresponding pingCtlEntry is deleted."
704
702
   ::= { pingObjects 3 }
710
708
    DESCRIPTION
711
709
        "Defines an entry in the pingResultsTable.  The
712
710
        pingResultsTable has the same indexing as the
713
 
        pingCtlTable in order for a pingResultsEntry to
714
 
 
715
 
 
716
 
 
717
 
 
718
 
 
719
 
        correspond to the pingCtlEntry that caused it to
 
711
        pingCtlTable so that a pingResultsEntry
 
712
        corresponds to the pingCtlEntry that caused it to
720
713
        be created."
721
714
    INDEX {
722
715
             pingCtlOwnerIndex,
732
725
        pingResultsMinRtt              Unsigned32,
733
726
        pingResultsMaxRtt              Unsigned32,
734
727
        pingResultsAverageRtt          Unsigned32,
735
 
        pingResultsProbeResponses      Unsigned32,
736
 
        pingResultsSentProbes          Unsigned32,
 
728
        pingResultsProbeResponses      Gauge32,
 
729
        pingResultsSentProbes          Gauge32,
737
730
        pingResultsRttSumOfSquares     Unsigned32,
738
731
        pingResultsLastGoodProbe       DateAndTime
739
732
     }
740
733
 
741
734
 pingResultsOperStatus OBJECT-TYPE
742
735
    SYNTAX      INTEGER {
743
 
                          enabled(1),  -- test is in progress
744
 
                          disabled(2)  -- test has stopped
 
736
                          enabled(1),   -- test is in progress
 
737
                          disabled(2),  -- test has stopped
 
738
                          completed(3)  -- test is completed
745
739
                        }
746
740
    MAX-ACCESS  read-only
747
741
    STATUS      current
748
742
    DESCRIPTION
749
743
        "Reflects the operational state of a pingCtlEntry:
750
 
           enabled(1)   - Test is active.
751
 
           disabled(2)  - Test has stopped."
 
744
 
 
745
           enabled(1)    - Test is active.
 
746
           disabled(2)   - Test has stopped.
 
747
           completed(3)  - Test is completed."
752
748
    ::= { pingResultsEntry 1 }
753
749
 
754
750
 pingResultsIpTargetAddressType OBJECT-TYPE
756
752
    MAX-ACCESS  read-only
757
753
    STATUS      current
758
754
    DESCRIPTION
759
 
        "This objects indicates the type of address stored
 
755
        "This object indicates the type of address stored
760
756
        in the corresponding pingResultsIpTargetAddress
761
757
        object."
762
758
    DEFVAL { unknown }
764
760
 
765
761
 pingResultsIpTargetAddress OBJECT-TYPE
766
762
    SYNTAX      InetAddress
767
 
 
768
 
 
769
 
 
770
 
 
771
 
 
772
763
    MAX-ACCESS  read-only
773
764
    STATUS      current
774
765
    DESCRIPTION
775
 
        "This objects reports the IP address associated
 
766
        "This object reports the IP address associated
776
767
        with a pingCtlTargetAddress value when the destination
777
768
        address is specified as a DNS name.  The value of
778
 
        this object should be a zero length octet string
 
769
        this object should be a zero-length octet string
779
770
        when a DNS name is not specified or when a
780
 
        specified DNS name fails to resolve."
 
771
        specified DNS name fails to resolve.
 
772
 
 
773
        The address type (InetAddressType) that relates to
 
774
        this object is specified by the corresponding value
 
775
        of pingResultsIpTargetAddressType."
781
776
    DEFVAL { ''H }
782
777
    ::= { pingResultsEntry 3 }
783
778
 
811
806
    ::= { pingResultsEntry 6 }
812
807
 
813
808
  pingResultsProbeResponses OBJECT-TYPE
814
 
    SYNTAX      Unsigned32
 
809
    SYNTAX      Gauge32
815
810
    UNITS       "responses"
816
811
    MAX-ACCESS  read-only
817
812
    STATUS      current
818
813
    DESCRIPTION
819
814
        "Number of responses received for the corresponding
820
 
 
821
 
 
822
 
 
823
 
 
824
 
 
825
815
        pingCtlEntry and pingResultsEntry.  The value of this object
826
816
        MUST be reported as 0 when no probe responses have been
827
817
        received."
828
818
    ::= { pingResultsEntry 7 }
829
819
 
830
820
  pingResultsSentProbes OBJECT-TYPE
831
 
    SYNTAX      Unsigned32
 
821
    SYNTAX      Gauge32
832
822
    UNITS       "probes"
833
823
    MAX-ACCESS  read-only
834
824
    STATUS      current
868
858
    MAX-ACCESS  not-accessible
869
859
    STATUS      current
870
860
    DESCRIPTION
871
 
        "Defines a table for storing the results of a ping
872
 
        operation.  Entries in this table are limited by
873
 
 
874
 
 
875
 
 
876
 
 
877
 
 
878
 
        the value of the corresponding pingCtlMaxRows
879
 
        object.
 
861
        "Defines a table for storing the results of ping
 
862
        operations.  The number of entries in this table is
 
863
        limited per entry in the pingCtlTable by the value
 
864
        of the corresponding pingCtlMaxRows object.
880
865
 
881
866
        An entry in this table is created when the result of
882
867
        a ping probe is determined.  The initial 2 instance
886
871
        its corresponding pingCtlEntry is deleted.
887
872
 
888
873
        An implementation of this MIB will remove the oldest
889
 
        entry in the pingProbeHistoryTable to allow the
890
 
        addition of an new entry once the number of rows in
891
 
        the pingProbeHistoryTable reaches the value specified
892
 
        by pingCtlMaxRows."
 
874
        entry in the pingProbeHistoryTable of the
 
875
        corresponding entry in the pingCtlTable to allow
 
876
        the addition of an new entry once the number of rows
 
877
        in the pingProbeHistoryTable reaches the value
 
878
        specified by pingCtlMaxRows for the corresponding
 
879
        entry in the pingCtlTable."
893
880
   ::= { pingObjects 4 }
894
881
 
895
882
 pingProbeHistoryEntry OBJECT-TYPE
903
890
        to.  The third index element selects a single
904
891
        probe result."
905
892
    INDEX {
 
893
 
906
894
             pingCtlOwnerIndex,
907
895
             pingCtlTestName,
908
896
             pingProbeHistoryIndex
923
911
    MAX-ACCESS  not-accessible
924
912
    STATUS      current
925
913
    DESCRIPTION
926
 
 
927
 
 
928
 
 
929
 
 
930
 
 
931
914
        "An entry in this table is created when the result of
932
915
        a ping probe is determined.  The initial 2 instance
933
916
        identifier index values identify the pingCtlEntry
965
948
    MAX-ACCESS  read-only
966
949
    STATUS      current
967
950
    DESCRIPTION
968
 
        "The last implementation method specific reply code received.
969
 
        If the ICMP Echo capability is being used then a successful
 
951
        "The last implementation-method-specific reply code received.
 
952
        If the ICMP Echo capability is being used, then a successful
970
953
        probe ends when an ICMP response is received that contains
971
 
        the code ICMP_ECHOREPLY(0).  The ICMP responses are defined
972
 
        normally in the ip_icmp include file."
 
954
        the code ICMP_ECHOREPLY(0).  The ICMP codes are maintained
 
955
        by IANA.  Standardized ICMP codes are listed at
 
956
        http://www.iana.org/assignments/icmp-parameters.
 
957
        The ICMPv6 codes are listed at
 
958
        http://www.iana.org/assignments/icmpv6-parameters."
973
959
    ::= { pingProbeHistoryEntry 4 }
974
960
 
975
961
 pingProbeHistoryTime OBJECT-TYPE
976
962
    SYNTAX      DateAndTime
977
963
    MAX-ACCESS  read-only
978
964
    STATUS      current
979
 
 
980
 
 
981
 
 
982
 
 
983
 
 
984
965
    DESCRIPTION
985
966
        "Timestamp for when this probe result was determined."
986
967
    ::= { pingProbeHistoryEntry 5 }
987
968
 
988
 
 
989
969
 -- Notification Definition section
990
970
 
991
971
 pingProbeFailed NOTIFICATION-TYPE
1005
985
      }
1006
986
      STATUS  current
1007
987
      DESCRIPTION
1008
 
          "Generated when a probe failure is detected when the
 
988
          "Generated when a probe failure is detected, when the
 
989
 
1009
990
          corresponding pingCtlTrapGeneration object is set to
1010
 
          probeFailure(0) subject to the value of
 
991
          probeFailure(0), subject to the value of
1011
992
          pingCtlTrapProbeFailureFilter.  The object
1012
993
          pingCtlTrapProbeFailureFilter can be used to specify the
1013
 
          number of successive probe failures that are required
 
994
          number of consecutive probe failures that are required
1014
995
          before this notification can be generated."
1015
996
      ::= { pingNotifications 1 }
1016
997
 
1029
1010
        pingResultsRttSumOfSquares,
1030
1011
        pingResultsLastGoodProbe
1031
1012
      }
1032
 
 
1033
 
 
1034
 
 
1035
 
 
1036
 
 
1037
1013
      STATUS  current
1038
1014
      DESCRIPTION
1039
 
          "Generated when a ping test is determined to have failed
 
1015
          "Generated when a ping test is determined to have failed,
1040
1016
          when the corresponding pingCtlTrapGeneration object is
1041
 
          set to testFailure(1).  In this instance
 
1017
          set to testFailure(1).  In this instance,
1042
1018
          pingCtlTrapTestFailureFilter should specify the number of
1043
1019
          probes in a test required to have failed in order to
1044
 
          consider the test as failed."
 
1020
          consider the test failed."
1045
1021
      ::= { pingNotifications 2 }
1046
1022
 
1047
1023
 pingTestCompleted NOTIFICATION-TYPE
1058
1034
        pingResultsSentProbes,
1059
1035
        pingResultsRttSumOfSquares,
1060
1036
        pingResultsLastGoodProbe
 
1037
 
1061
1038
      }
1062
1039
      STATUS  current
1063
1040
      DESCRIPTION
1064
1041
          "Generated at the completion of a ping test when the
1065
 
          corresponding pingCtlTrapGeneration object is set to
1066
 
          testCompletion(4)."
 
1042
          corresponding pingCtlTrapGeneration object has the
 
1043
          testCompletion(2) bit set."
1067
1044
      ::= { pingNotifications 3 }
1068
1045
 
1069
1046
 -- Conformance information
 
1047
 
1070
1048
 -- Compliance statements
1071
1049
 
1072
1050
 pingCompliances OBJECT IDENTIFIER ::= { pingConformance 1 }
1074
1052
 
1075
1053
 -- Compliance statements
1076
1054
 
 
1055
 pingFullCompliance MODULE-COMPLIANCE
 
1056
    STATUS  current
 
1057
    DESCRIPTION
 
1058
            "The compliance statement for SNMP entities that
 
1059
            fully implement the DISMAN-PING-MIB."
 
1060
    MODULE  -- this module
 
1061
        MANDATORY-GROUPS {
 
1062
                            pingMinimumGroup,
 
1063
                            pingCtlRowStatusGroup,
 
1064
                            pingHistoryGroup,
 
1065
                            pingNotificationsGroup
 
1066
                          }
 
1067
 
 
1068
        OBJECT pingMaxConcurrentRequests
 
1069
        MIN-ACCESS  read-only
 
1070
        DESCRIPTION
 
1071
            "The agent is not required to support set
 
1072
            operations to this object."
 
1073
 
 
1074
        OBJECT pingCtlStorageType
 
1075
        MIN-ACCESS  read-only
 
1076
        DESCRIPTION
 
1077
            "Write access is not required."
 
1078
 
 
1079
        OBJECT pingCtlType
 
1080
        MIN-ACCESS  read-only
 
1081
        DESCRIPTION
 
1082
            "Write access is not required.  In addition, the only
 
1083
            value that MUST be supported by an implementation is
 
1084
            pingIcmpEcho."
 
1085
 
 
1086
        OBJECT pingCtlSourceAddressType
 
1087
        SYNTAX  InetAddressType { unknown(0), ipv4(1), ipv6(2) }
 
1088
        MIN-ACCESS  read-only
 
1089
        DESCRIPTION
 
1090
            "Write access to this object is not required by
 
1091
            implementations that are not capable of binding the
 
1092
            send socket with a source address.  An implementation
 
1093
            is only required to support IPv4 and IPv6 addresses."
 
1094
 
 
1095
        OBJECT pingCtlSourceAddress
 
1096
        SYNTAX  InetAddress (SIZE(0|4|16))
 
1097
        MIN-ACCESS  read-only
 
1098
        DESCRIPTION
 
1099
            "Write access to this object is not required by
 
1100
            implementations that are not capable of binding the
 
1101
            send socket with a source address.  An implementation
 
1102
            is only required to support IPv4 and IPv6 addresses."
 
1103
 
 
1104
        OBJECT pingCtlIfIndex
 
1105
        MIN-ACCESS  read-only
 
1106
        DESCRIPTION
 
1107
            "Write access is not required.  If write access is
 
1108
            not supported, return a 0 as the value of this object.
 
1109
            A value of 0 means that the function represented by
 
1110
            this option is not supported."
 
1111
 
 
1112
        OBJECT pingCtlByPassRouteTable
 
1113
        MIN-ACCESS  read-only
 
1114
        DESCRIPTION
 
1115
            "Write access to this object is not required by
 
1116
            implementations that are not capable of its
 
1117
            implementation.  The function represented by this
 
1118
            object is implementable if the setsockopt
 
1119
            SOL_SOCKET SO_DONTROUTE option is supported."
 
1120
 
 
1121
        OBJECT pingCtlDSField
 
1122
        MIN-ACCESS  read-only
 
1123
        DESCRIPTION
 
1124
            "Write access is not required.  If write access is
 
1125
            not supported, return a 0 as the value of this object.
 
1126
            A value of 0 means that the function represented by
 
1127
            this option is not supported."
 
1128
 
 
1129
        OBJECT pingResultsIpTargetAddressType
 
1130
        SYNTAX  InetAddressType { unknown(0), ipv4(1), ipv6(2) }
 
1131
        DESCRIPTION
 
1132
            "An implementation is only required to
 
1133
 
 
1134
            support IPv4 and IPv6 addresses."
 
1135
 
 
1136
        OBJECT pingResultsIpTargetAddress
 
1137
        SYNTAX  InetAddress (SIZE(0|4|16))
 
1138
        DESCRIPTION
 
1139
            "An implementation is only required to
 
1140
            support IPv4 and globally unique IPv6 addresses."
 
1141
 
 
1142
        OBJECT pingResultsLastGoodProbe
 
1143
        DESCRIPTION
 
1144
            "This object is mandatory for implementations that have
 
1145
            access to a system clock and that are capable of setting
 
1146
            the values for DateAndTime objects.  It is RECOMMENDED
 
1147
            that when this object is not supported its values
 
1148
            be reported as '0000000000000000'H."
 
1149
 
 
1150
        OBJECT pingProbeHistoryTime
 
1151
        DESCRIPTION
 
1152
            "This object is mandatory for implementations that have
 
1153
            access to a system clock and that are capable of setting
 
1154
            the values for DateAndTime objects.  It is RECOMMENDED
 
1155
            that when this object is not supported its values
 
1156
            be reported as '0000000000000000'H."
 
1157
    ::= { pingCompliances 2 }
 
1158
 
 
1159
 pingMinimumCompliance MODULE-COMPLIANCE
 
1160
    STATUS  current
 
1161
    DESCRIPTION
 
1162
            "The minimum compliance statement for SNMP entities
 
1163
            that implement the minimal subset of the
 
1164
            DISMAN-PING-MIB.  Implementors might choose this
 
1165
            subset for small devices with limited resources."
 
1166
    MODULE  -- this module
 
1167
        MANDATORY-GROUPS { pingMinimumGroup }
 
1168
 
 
1169
        GROUP pingCtlRowStatusGroup
 
1170
        DESCRIPTION
 
1171
            "A compliant implementation does not have to implement
 
1172
            the pingCtlRowStatusGroup."
 
1173
 
 
1174
        GROUP pingHistoryGroup
 
1175
        DESCRIPTION
 
1176
            "A compliant implementation does not have to implement
 
1177
            the pingHistoryGroup."
 
1178
 
 
1179
        GROUP pingNotificationsGroup
 
1180
        DESCRIPTION
 
1181
            "A compliant implementation does not have to implement
 
1182
 
 
1183
            the pingNotificationsGroup."
 
1184
 
 
1185
        OBJECT pingMaxConcurrentRequests
 
1186
        MIN-ACCESS  read-only
 
1187
        DESCRIPTION
 
1188
            "The agent is not required to support set
 
1189
            operations to this object."
 
1190
 
 
1191
        OBJECT pingCtlDataFill
 
1192
        MIN-ACCESS  read-only
 
1193
        DESCRIPTION
 
1194
            "The agent is not required to support set
 
1195
            operations to this object."
 
1196
 
 
1197
        OBJECT pingCtlFrequency
 
1198
        MIN-ACCESS  read-only
 
1199
        DESCRIPTION
 
1200
            "Write access is not required.  If write access is
 
1201
            not supported, return a 0 as the value of this object.
 
1202
            A value of 0 means that the function represented by
 
1203
            this option is not supported."
 
1204
 
 
1205
        OBJECT pingCtlMaxRows
 
1206
        MIN-ACCESS  read-only
 
1207
        DESCRIPTION
 
1208
            "Write access is not required.  If the
 
1209
            pingHistoryGroup is not implemented, then write
 
1210
            access to this object MUST be disabled, and the object
 
1211
            MUST return a value of 0 when retrieved."
 
1212
 
 
1213
        OBJECT pingCtlStorageType
 
1214
        MIN-ACCESS  read-only
 
1215
        DESCRIPTION
 
1216
            "Write access is not required."
 
1217
 
 
1218
        OBJECT pingCtlTrapGeneration
 
1219
        MIN-ACCESS  read-only
 
1220
        DESCRIPTION
 
1221
            "Write access is not required.  If the
 
1222
            pingNotificationsGroup is not implemented, then write
 
1223
            access to this object MUST be disabled, and the object
 
1224
            MUST return a value with no bit set when retrieved.
 
1225
            No bit set indicates that not notification is
 
1226
            generated."
 
1227
 
 
1228
        OBJECT pingCtlTrapProbeFailureFilter
 
1229
        MIN-ACCESS  read-only
 
1230
        DESCRIPTION
 
1231
            "If write access to pingCtlTrapGeneration is not
 
1232
            supported, then write access to this object must also
 
1233
            not be supported.  In this case, return 0 as the value
 
1234
            of this object."
 
1235
 
 
1236
        OBJECT pingCtlTrapTestFailureFilter
 
1237
        MIN-ACCESS  read-only
 
1238
        DESCRIPTION
 
1239
            "If write access to pingCtlTrapGeneration is not
 
1240
            supported, then write access to this object must also
 
1241
            not be supported.  In this case, return 0 as the value
 
1242
            of this object."
 
1243
 
 
1244
        OBJECT pingCtlType
 
1245
        MIN-ACCESS  read-only
 
1246
        DESCRIPTION
 
1247
            "Write access is not required.  In addition, the only
 
1248
            value that MUST be supported by an implementation is
 
1249
            pingIcmpEcho."
 
1250
 
 
1251
        OBJECT pingCtlDescr
 
1252
        MIN-ACCESS  read-only
 
1253
        DESCRIPTION
 
1254
            "The agent is not required to support set
 
1255
            operations to this object."
 
1256
 
 
1257
        OBJECT pingCtlSourceAddressType
 
1258
        SYNTAX  InetAddressType { unknown(0), ipv4(1), ipv6(2) }
 
1259
        MIN-ACCESS  read-only
 
1260
        DESCRIPTION
 
1261
            "Write access to this object is not required by
 
1262
            implementations that are not capable of binding the
 
1263
            send socket with a source address.  An implementation
 
1264
            is only required to support IPv4 and IPv6 addresses."
 
1265
 
 
1266
        OBJECT pingCtlSourceAddress
 
1267
        SYNTAX  InetAddress (SIZE(0|4|16))
 
1268
        MIN-ACCESS  read-only
 
1269
        DESCRIPTION
 
1270
            "Write access to this object is not required by
 
1271
            implementations that are not capable of binding the
 
1272
            send socket with a source address.  An implementation
 
1273
            is only required to support IPv4 and IPv6 addresses."
 
1274
 
 
1275
        OBJECT pingCtlIfIndex
 
1276
        MIN-ACCESS  read-only
 
1277
        DESCRIPTION
 
1278
            "Write access is not required.  If write access is
 
1279
 
 
1280
            not supported, return a 0 as the value of this object.
 
1281
            A value of 0 means that the function represented by
 
1282
            this option is not supported."
 
1283
 
 
1284
        OBJECT pingCtlByPassRouteTable
 
1285
        MIN-ACCESS  read-only
 
1286
        DESCRIPTION
 
1287
            "Write access is not required.  If write access is
 
1288
            not supported, return false(2) as the value of this
 
1289
            object.  A value of false(2) means that the function
 
1290
            represented by this option is not supported."
 
1291
 
 
1292
        OBJECT pingCtlDSField
 
1293
        MIN-ACCESS  read-only
 
1294
        DESCRIPTION
 
1295
            "Write access is not required.  If write access is
 
1296
            not supported, return a 0 as the value of this object.
 
1297
            A value of 0 means that the function represented by
 
1298
            this option is not supported."
 
1299
 
 
1300
        OBJECT pingResultsIpTargetAddressType
 
1301
        SYNTAX  InetAddressType { unknown(0), ipv4(1), ipv6(2) }
 
1302
        DESCRIPTION
 
1303
            "An implementation is only required to
 
1304
            support IPv4 and IPv6 addresses."
 
1305
 
 
1306
        OBJECT pingResultsIpTargetAddress
 
1307
        SYNTAX  InetAddress (SIZE(0|4|16))
 
1308
        DESCRIPTION
 
1309
            "An implementation is only required to
 
1310
            support IPv4 and globally unique IPv6 addresses."
 
1311
 
 
1312
        OBJECT pingResultsLastGoodProbe
 
1313
        DESCRIPTION
 
1314
            "This object is mandatory for implementations that have
 
1315
            access to a system clock and that are capable of setting
 
1316
            the values for DateAndTime objects.  It is RECOMMENDED
 
1317
            that when this object is not supported its values
 
1318
            be reported as '0000000000000000'H."
 
1319
 
 
1320
        OBJECT pingProbeHistoryTime
 
1321
        DESCRIPTION
 
1322
            "If the pingHistoryGroup is implemented, then this
 
1323
            object is mandatory for implementations that have
 
1324
            access to a system clock and that are capable of setting
 
1325
            the values for DateAndTime objects.  It is RECOMMENDED
 
1326
            that when this object is not supported its values
 
1327
 
 
1328
            be reported as '0000000000000000'H."
 
1329
    ::= { pingCompliances 3 }
 
1330
 
1077
1331
 pingCompliance MODULE-COMPLIANCE
1078
 
    STATUS  current
 
1332
    STATUS  deprecated
1079
1333
    DESCRIPTION
1080
 
            "The compliance statement for the DISMAN-PING-MIB."
 
1334
            "The compliance statement for the DISMAN-PING-MIB.  This
 
1335
            compliance statement has been deprecated because the
 
1336
            group pingGroup and the pingTimeStampGroup have been
 
1337
            split and deprecated.  The pingFullCompliance statement
 
1338
            is semantically identical to the deprecated
 
1339
            pingCompliance statement."
 
1340
 
1081
1341
    MODULE  -- this module
1082
1342
        MANDATORY-GROUPS {
1083
1343
                            pingGroup,
1084
1344
                            pingNotificationsGroup
1085
 
 
1086
 
 
1087
 
 
1088
 
 
1089
 
 
1090
1345
                          }
1091
1346
        GROUP pingTimeStampGroup
1092
1347
        DESCRIPTION
1093
1348
            "This group is mandatory for implementations that have
1094
 
            access to a system clock and are capable of setting
 
1349
            access to a system clock and that are capable of setting
1095
1350
            the values for DateAndTime objects.  It is RECOMMENDED
1096
 
            that when this group is not supported that the values
 
1351
            that when this group is not supported the values
1097
1352
            for the objects in this group be reported as
1098
1353
            '0000000000000000'H."
1099
1354
 
1107
1362
        MIN-ACCESS  read-only
1108
1363
        DESCRIPTION
1109
1364
            "Write access is not required.  It is also allowed
1110
 
            for implementations to support only the volatile
 
1365
            that implementations support only the volatile
1111
1366
            StorageType enumeration."
1112
1367
 
1113
1368
        OBJECT pingCtlType
1132
1387
        DESCRIPTION
1133
1388
            "This object is not required by implementations that
1134
1389
            are not capable of binding the send socket with a
1135
 
            source address. An implementation is only required to
 
1390
            source address.  An implementation is only required to
1136
1391
            support IPv4 and IPv6 addresses."
1137
1392
 
1138
 
 
1139
 
 
1140
 
 
1141
 
 
1142
 
 
1143
1393
        OBJECT pingCtlSourceAddress
1144
1394
        SYNTAX  InetAddress (SIZE(0|4|16))
1145
1395
        MIN-ACCESS  read-only
1146
1396
        DESCRIPTION
1147
1397
            "This object is not required by implementations that
1148
1398
            are not capable of binding the send socket with a
1149
 
            source address. An implementation is only required to
 
1399
            source address.  An implementation is only required to
1150
1400
            support IPv4 and globally unique IPv6 addresses."
1151
1401
 
1152
1402
        OBJECT pingCtlIfIndex
1153
1403
        MIN-ACCESS  read-only
1154
1404
        DESCRIPTION
1155
 
            "Write access is not required.   When write access is
1156
 
            not supported return a 0 as the value of this object.
 
1405
            "Write access is not required.  When write access is
 
1406
            not supported, return a 0 as the value of this object.
1157
1407
            A value of 0 means that the function represented by
1158
1408
            this option is not supported."
1159
1409
 
1160
1410
        OBJECT pingCtlDSField
1161
1411
        MIN-ACCESS  read-only
1162
1412
        DESCRIPTION
1163
 
            "Write access is not required.   When write access is
1164
 
            not supported return a 0 as the value of this object.
 
1413
            "Write access is not required.  When write access is
 
1414
            not supported, return a 0 as the value of this object.
1165
1415
            A value of 0 means that the function represented by
1166
1416
            this option is not supported."
1167
1417
 
1176
1426
        DESCRIPTION
1177
1427
            "An implementation is only required to
1178
1428
            support IPv4 and globally unique IPv6 addresses."
1179
 
 
1180
1429
    ::= { pingCompliances 1 }
1181
1430
 
1182
1431
 -- MIB groupings
1183
1432
 
 
1433
 pingMinimumGroup OBJECT-GROUP
 
1434
   OBJECTS {
 
1435
             pingMaxConcurrentRequests,
 
1436
             pingCtlTargetAddressType,
 
1437
             pingCtlTargetAddress,
 
1438
             pingCtlDataSize,
 
1439
             pingCtlTimeOut,
 
1440
             pingCtlProbeCount,
 
1441
             pingCtlAdminStatus,
 
1442
             pingCtlDataFill,
 
1443
             pingCtlFrequency,
 
1444
             pingCtlMaxRows,
 
1445
             pingCtlStorageType,
 
1446
             pingCtlTrapGeneration,
 
1447
             pingCtlTrapProbeFailureFilter,
 
1448
             pingCtlTrapTestFailureFilter,
 
1449
             pingCtlType,
 
1450
             pingCtlDescr,
 
1451
             pingCtlByPassRouteTable,
 
1452
             pingCtlSourceAddressType,
 
1453
             pingCtlSourceAddress,
 
1454
             pingCtlIfIndex,
 
1455
             pingCtlDSField,
 
1456
             pingResultsOperStatus,
 
1457
             pingResultsIpTargetAddressType,
 
1458
             pingResultsIpTargetAddress,
 
1459
             pingResultsMinRtt,
 
1460
             pingResultsMaxRtt,
 
1461
             pingResultsAverageRtt,
 
1462
             pingResultsProbeResponses,
 
1463
             pingResultsSentProbes,
 
1464
             pingResultsRttSumOfSquares,
 
1465
             pingResultsLastGoodProbe
 
1466
           }
 
1467
   STATUS  current
 
1468
   DESCRIPTION
 
1469
       "The group of objects that constitute the remote ping
 
1470
       capability."
 
1471
    ::= { pingGroups 4 }
 
1472
 
 
1473
 pingCtlRowStatusGroup OBJECT-GROUP
 
1474
   OBJECTS {
 
1475
             pingCtlRowStatus
 
1476
           }
 
1477
   STATUS  current
 
1478
   DESCRIPTION
 
1479
       "The RowStatus object of the pingCtlTable."
 
1480
    ::= { pingGroups 5 }
 
1481
 
 
1482
 pingHistoryGroup OBJECT-GROUP
 
1483
   OBJECTS {
 
1484
             pingProbeHistoryResponse,
 
1485
             pingProbeHistoryStatus,
 
1486
             pingProbeHistoryLastRC,
 
1487
             pingProbeHistoryTime
 
1488
           }
 
1489
   STATUS  current
 
1490
   DESCRIPTION
 
1491
       "The group of objects that constitute the history
 
1492
       capability."
 
1493
    ::= { pingGroups 6 }
 
1494
 
 
1495
 pingNotificationsGroup NOTIFICATION-GROUP
 
1496
   NOTIFICATIONS {
 
1497
             pingProbeFailed,
 
1498
             pingTestFailed,
 
1499
             pingTestCompleted
 
1500
          }
 
1501
   STATUS        current
 
1502
   DESCRIPTION
 
1503
       "The notification that are required to be supported by
 
1504
       implementations of this MIB."
 
1505
   ::= { pingGroups 3 }
 
1506
 
1184
1507
 pingGroup OBJECT-GROUP
1185
1508
   OBJECTS {
1186
1509
             pingMaxConcurrentRequests,
1188
1511
             pingCtlTargetAddress,
1189
1512
             pingCtlDataSize,
1190
1513
             pingCtlTimeOut,
1191
 
 
1192
 
 
1193
 
 
1194
 
 
1195
 
 
1196
1514
             pingCtlProbeCount,
1197
1515
             pingCtlAdminStatus,
1198
1516
             pingCtlDataFill,
1223
1541
             pingProbeHistoryStatus,
1224
1542
             pingProbeHistoryLastRC
1225
1543
           }
1226
 
   STATUS  current
 
1544
   STATUS  deprecated
1227
1545
   DESCRIPTION
1228
 
       "The group of objects that comprise the remote ping
 
1546
       "The group of objects that constitute the remote ping
1229
1547
       capability."
1230
1548
    ::= { pingGroups 1 }
1231
1549
 
1232
1550
 pingTimeStampGroup OBJECT-GROUP
 
1551
 
1233
1552
   OBJECTS {
1234
1553
             pingResultsLastGoodProbe,
1235
1554
             pingProbeHistoryTime
1236
1555
           }
1237
 
   STATUS  current
 
1556
   STATUS  deprecated
1238
1557
   DESCRIPTION
1239
1558
       "The group of DateAndTime objects."
1240
1559
    ::= { pingGroups 2 }
1241
1560
 
1242
 
 pingNotificationsGroup NOTIFICATION-GROUP
1243
 
   NOTIFICATIONS {
1244
 
 
1245
 
 
1246
 
 
1247
 
 
1248
 
 
1249
 
             pingProbeFailed,
1250
 
             pingTestFailed,
1251
 
             pingTestCompleted
1252
 
          }
1253
 
   STATUS        current
1254
 
   DESCRIPTION
1255
 
       "The notification which are required to be supported by
1256
 
       implementations of this MIB."
1257
 
   ::= { pingGroups 3 }
1258
 
 
1259
1561
END