mibs/ietf/ROHC-MIB

   1 ROHC-MIB DEFINITIONS ::= BEGIN
   2
   3 IMPORTS
   4     MODULE-IDENTITY, OBJECT-TYPE,
   5     Unsigned32, Counter32, mib-2
   6         FROM SNMPv2-SMI                                -- [RFC2578]
   7
   8     TEXTUAL-CONVENTION, TruthValue,
   9     TimeInterval, DateAndTime
  10         FROM SNMPv2-TC                                 -- [RFC2579]
  11
  12     MODULE-COMPLIANCE, OBJECT-GROUP
  13         FROM SNMPv2-CONF                               -- [RFC2580]
  14
  15     SnmpAdminString
  16         FROM SNMP-FRAMEWORK-MIB                        -- [RFC3411]
  17
  18     ifIndex
  19         FROM IF-MIB;                                   -- [RFC2863]
  20
  21 rohcMIB MODULE-IDENTITY
  22     LAST-UPDATED "200406030000Z"  -- June 3, 2004
  23     ORGANIZATION "IETF Robust Header Compression Working Group"
  24     CONTACT-INFO
  25        "WG charter:
  26           http://www.ietf.org/html.charters/rohc-charter.html
  27
  28         Mailing Lists:
  29           General Discussion: rohc@ietf.org
  30           To Subscribe: rohc-request@ietf.org
  31           In Body: subscribe your_email_address
  32
  33         Editor:
  34           Juergen Quittek
  35           NEC Europe Ltd.
  36           Network Laboratories
  37           Kurfuersten-Anlage 36
  38
  39
  40
  41           69221 Heidelberg
  42           Germany
  43           Tel: +49 6221 90511-15
  44           EMail: quittek@netlab.nec.de"
  45     DESCRIPTION
  46         "This MIB module defines a set of basic objects for
  47          monitoring and configuring robust header compression.
  48          The module covers information about running instances
  49          of ROHC (compressors or decompressors) at IP interfaces.
  50
  51          Information about compressor contexts and decompressor
  52          contexts has different structure for different profiles.
  53          Therefore it is not provided by this MIB module, but by
  54          individual modules for different profiles.
  55
  56          Copyright (C) The Internet Society (2004). The
  57          initial version of this MIB module was published
  58          in RFC 3816. For full legal notices see the RFC
  59          itself or see:
  60          http://www.ietf.org/copyrights/ianamib.html"
  61
  62     REVISION    "200406030000Z"  -- June 3, 2004
  63     DESCRIPTION "Initial version, published as RFC 3816."
  64     ::= { mib-2 112 }
  65
  66 RohcChannelIdentifier ::= TEXTUAL-CONVENTION
  67     DISPLAY-HINT "d"
  68     STATUS       current
  69     DESCRIPTION
  70         "A number identifying a channel.
  71          The value of 0 must not be used as identifier
  72          of an existing channel."
  73     SYNTAX       Unsigned32 (1..4294967295)
  74
  75 RohcChannelIdentifierOrZero ::= TEXTUAL-CONVENTION
  76     DISPLAY-HINT "d"
  77     STATUS       current
  78     DESCRIPTION
  79         "A number identifying a channel.
  80          The value of 0 is indicates that
  81          no channel is identified."
  82     SYNTAX       Unsigned32 (0..4294967295)
  83
  84 RohcCompressionRatio ::= TEXTUAL-CONVENTION
  85     DISPLAY-HINT "d"
  86     STATUS       current
  87     DESCRIPTION
  88         "A number indicating a compression ratio over
  89
  90
  91
  92          a set of bytes.  The value is defined as
  93          1000 * bytes(compressed) / bytes(original)
  94          rounded to the next integer value.
  95
  96          Note that compressed sets of bytes can be larger
  97          than the corresponding uncompressed ones.
  98          Therefore, the number can be greater than 1000."
  99     SYNTAX       Unsigned32
 100
 101 --
 102 -- The groups defined within this MIB module:
 103 --
 104
 105 rohcObjects       OBJECT IDENTIFIER ::= { rohcMIB 1 }
 106 rohcConformance   OBJECT IDENTIFIER ::= { rohcMIB 2 }
 107
 108 --
 109 -- The ROHC Instance group lists properties of ROHC
 110 -- instances in the rohcInstanceTable, about the channels used
 111 -- by the instances in the rohcChanneltable and about the profiles
 112 -- available at the instances in the rohcProfileTable.
 113 --
 114
 115 rohcInstanceObjects       OBJECT IDENTIFIER ::= { rohcObjects 1 }
 116
 117 --
 118 -- Channel Table
 119 --
 120 -- Listing all channels used for ROHC data channel
 121 -- and/or as feedback channel.
 122 --
 123
 124 rohcChannelTable OBJECT-TYPE
 125     SYNTAX      SEQUENCE OF RohcChannelEntry
 126     MAX-ACCESS  not-accessible
 127     STATUS      current
 128     DESCRIPTION
 129         "This table lists and describes all ROHC channels
 130          per interface."
 131     ::= { rohcInstanceObjects 1 }
 132
 133 rohcChannelEntry OBJECT-TYPE
 134     SYNTAX      RohcChannelEntry
 135     MAX-ACCESS  not-accessible
 136     STATUS      current
 137     DESCRIPTION
 138         "An entry describing a particular script.  Every script that
 139          is stored in non-volatile memory is required to appear in
 140
 141
 142
 143          this script table.
 144
 145          Note, that the rohcChannelID identifies the channel
 146          uniquely.  The ifIndex is part of the index of this table
 147          just in order to allow addressing channels per interface."
 148     INDEX { ifIndex, rohcChannelID }
 149     ::= { rohcChannelTable 1 }
 150
 151 RohcChannelEntry ::= SEQUENCE {
 152     rohcChannelID               RohcChannelIdentifier,
 153     rohcChannelType             INTEGER,
 154     rohcChannelFeedbackFor      RohcChannelIdentifierOrZero,
 155     rohcChannelDescr            SnmpAdminString,
 156     rohcChannelStatus           INTEGER
 157 }
 158
 159 rohcChannelID OBJECT-TYPE
 160     SYNTAX      RohcChannelIdentifier
 161     MAX-ACCESS  not-accessible
 162     STATUS      current
 163     DESCRIPTION
 164         "The locally arbitrary, but unique identifier associated
 165          with this channel.  The value is REQUIRED to be unique
 166          per ROHC MIB implementation independent of the associated
 167          interface.
 168
 169          The value is REQUIRED to remain constant at least from one
 170          re-initialization of the entity's network management system
 171          to the next re-initialization.  It is RECOMMENDED that the
 172          value persist across such re-initializations."
 173     REFERENCE
 174         "RFC 3095, Section 5.1.1"
 175     ::= { rohcChannelEntry 2 }
 176
 177 rohcChannelType OBJECT-TYPE
 178     SYNTAX      INTEGER {
 179                     notInUse(1),
 180                     rohc(2),
 181                     dedicatedFeedback(3)
 182                 }
 183     MAX-ACCESS  read-only
 184     STATUS      current
 185     DESCRIPTION
 186         "Type of usage of the channel.  A channel might be currently
 187          not in use for ROHC or feedback, it might be in use as
 188          a ROHC channel carrying packets and optional piggy-backed
 189          feedback, or it might be used as a dedicated feedback
 190          channel exclusively carrying feedback."
 191
 192
 193
 194     ::= { rohcChannelEntry 3 }
 195
 196 rohcChannelFeedbackFor OBJECT-TYPE
 197     SYNTAX      RohcChannelIdentifierOrZero
 198     MAX-ACCESS  read-only
 199     STATUS      current
 200     DESCRIPTION
 201         "The index of another channel of this interface for which
 202          the channel serves as feedback channel.
 203
 204          If no feedback information is transferred on this channel,
 205          then the value of this ID is 0.  If the channel type is set
 206          to notInUse(1), then the value of this object must be 0.
 207          If the channel type is rohc(2) and the value of this object
 208          is a valid channel ID, then feedback information is
 209          piggy-backed on the ROHC channel.  If the channel type is
 210          dedicatedFeedback(3), then feedback is transferred on this
 211          channel and the value of this object MUST be different from
 212          0 and MUST identify an existing ROHC channel."
 213     REFERENCE
 214         "RFC 3095, Section 5.1.1"
 215     ::= { rohcChannelEntry 4 }
 216
 217 rohcChannelDescr OBJECT-TYPE
 218     SYNTAX      SnmpAdminString
 219     MAX-ACCESS  read-only
 220     STATUS      current
 221     DESCRIPTION
 222         "A textual description of the channel."
 223     ::= { rohcChannelEntry 5 }
 224
 225 rohcChannelStatus OBJECT-TYPE
 226     SYNTAX      INTEGER {
 227                     enabled(1),
 228                     disabled(2)
 229                 }
 230     MAX-ACCESS  read-only
 231     STATUS      current
 232     DESCRIPTION
 233         "Status of the channel."
 234     ::= { rohcChannelEntry 6 }
 235
 236 --
 237 -- Instances of ROHC
 238 --
 239 -- This table lists properties of running instances of ROHC
 240 -- compressors and decompressors at the managed node.
 241 --
 242
 243
 244
 245
 246 rohcInstanceTable OBJECT-TYPE
 247     SYNTAX      SEQUENCE OF RohcInstanceEntry
 248     MAX-ACCESS  not-accessible
 249     STATUS      current
 250     DESCRIPTION
 251         "This table lists properties of running instances
 252          of robust header compressors and decompressors
 253          at IP interfaces.  It is indexed by interface number,
 254          the type of instance (compressor or decompressor),
 255          and the ID of the channel used by the instance as
 256          ROHC channel.
 257
 258          Note that the rohcChannelID uniquely identifies an
 259          instance.  The ifIndex and rohcInstanceType are part
 260          of the index, because it simplifies accessing instances
 261          per interface and for addressing either compressors or
 262          decompressors only."
 263     ::= { rohcInstanceObjects 2 }
 264
 265 rohcInstanceEntry OBJECT-TYPE
 266     SYNTAX      RohcInstanceEntry
 267     MAX-ACCESS  not-accessible
 268     STATUS      current
 269     DESCRIPTION
 270         "An entry describing a particular instance
 271          of a robust header compressor or decompressor."
 272     INDEX { ifIndex, rohcInstanceType, rohcChannelID }
 273     ::= { rohcInstanceTable 1 }
 274
 275 RohcInstanceEntry ::= SEQUENCE {
 276     rohcInstanceType               INTEGER,
 277     rohcInstanceFBChannelID        RohcChannelIdentifierOrZero,
 278     rohcInstanceVendor             OBJECT IDENTIFIER,
 279     rohcInstanceVersion            SnmpAdminString,
 280     rohcInstanceDescr              SnmpAdminString,
 281     rohcInstanceClockRes           Unsigned32,
 282     rohcInstanceMaxCID             Unsigned32,
 283     rohcInstanceLargeCIDs          TruthValue,
 284     rohcInstanceMRRU               Unsigned32,
 285     rohcInstanceContextStorageTime TimeInterval,
 286     rohcInstanceStatus             INTEGER,
 287     rohcInstanceContextsTotal      Counter32,
 288     rohcInstanceContextsCurrent    Unsigned32,
 289     rohcInstancePackets            Counter32,
 290     rohcInstanceIRs                Counter32,
 291     rohcInstanceIRDYNs             Counter32,
 292     rohcInstanceFeedbacks          Counter32,
 293
 294
 295
 296     rohcInstanceCompressionRatio   RohcCompressionRatio
 297 }
 298
 299 rohcInstanceType OBJECT-TYPE
 300     SYNTAX      INTEGER {
 301                     compressor(1),
 302                     decompressor(2)
 303                 }
 304     MAX-ACCESS  not-accessible
 305     STATUS      current
 306     DESCRIPTION
 307         "Type of the instance of ROHC. It is either a
 308          compressor instance or a decompressor instance."
 309     ::= { rohcInstanceEntry 2 }
 310
 311 rohcInstanceFBChannelID OBJECT-TYPE
 312     SYNTAX      RohcChannelIdentifierOrZero
 313     MAX-ACCESS  read-only
 314     STATUS      current
 315     DESCRIPTION
 316         "Identifier of the channel used for feedback.
 317          If no feedback channel is used, the value of
 318          this object is 0 ."
 319     REFERENCE
 320         "RFC 3095, Section 5.1.1"
 321     ::= { rohcInstanceEntry 4 }
 322
 323 rohcInstanceVendor OBJECT-TYPE
 324     SYNTAX      OBJECT IDENTIFIER
 325     MAX-ACCESS  read-only
 326     STATUS      current
 327     DESCRIPTION
 328         "An object identifier that identifies the vendor who
 329          provides the implementation of robust header description.
 330          This object identifier SHALL point to the object identifier
 331          directly below the enterprise object identifier
 332          {1 3 6 1 4 1} allocated for the vendor.  The value must be
 333          the object identifier {0 0} if the vendor is not known."
 334     ::= { rohcInstanceEntry 5 }
 335
 336 rohcInstanceVersion OBJECT-TYPE
 337     SYNTAX      SnmpAdminString (SIZE (0..32))
 338     MAX-ACCESS  read-only
 339     STATUS      current
 340     DESCRIPTION
 341         "The version number of the implementation of robust header
 342          compression.  The zero-length string shall be used if the
 343          implementation does not have a version number.
 344
 345
 346
 347
 348          It is suggested that the version number consist of one or
 349          more decimal numbers separated by dots, where the first
 350          number is called the major version number."
 351     ::= { rohcInstanceEntry 6 }
 352
 353 rohcInstanceDescr OBJECT-TYPE
 354     SYNTAX      SnmpAdminString
 355     MAX-ACCESS  read-only
 356     STATUS      current
 357     DESCRIPTION
 358         "A textual description of the implementation."
 359     ::= { rohcInstanceEntry 7 }
 360
 361 rohcInstanceClockRes OBJECT-TYPE
 362     SYNTAX      Unsigned32
 363     UNITS       "milliseconds"
 364     MAX-ACCESS  read-only
 365     STATUS      current
 366     DESCRIPTION
 367         "This object indicates the system clock resolution in
 368          units of milliseconds.  A zero (0) value means that there
 369          is no clock available."
 370     ::= { rohcInstanceEntry 8 }
 371
 372 rohcInstanceMaxCID OBJECT-TYPE
 373     SYNTAX      Unsigned32 (1..16383)
 374     MAX-ACCESS  read-only
 375     STATUS      current
 376     DESCRIPTION
 377         "The highest context ID number to be used by the
 378          compressor.  Note that this parameter is not coupled to,
 379          but in effect further constrained by,
 380          rohcChannelLargeCIDs."
 381     REFERENCE
 382         "RFC 3095, Section 5.1.1"
 383     ::= { rohcInstanceEntry 9 }
 384
 385 rohcInstanceLargeCIDs OBJECT-TYPE
 386     SYNTAX      TruthValue
 387     MAX-ACCESS  read-only
 388     STATUS      current
 389     DESCRIPTION
 390         "When retrieved, this boolean object returns false if
 391          the short CID representation (0 bytes or 1 prefix byte,
 392          covering CID 0 to 15) is used; it returns true, if the
 393          embedded CID representation (1 or 2 embedded CID bytes
 394          covering CID 0 to 16383) is used."
 395
 396
 397
 398     REFERENCE
 399         "RFC 3095, Section 5.1.1"
 400     ::= { rohcInstanceEntry 10 }
 401
 402 rohcInstanceMRRU OBJECT-TYPE
 403     SYNTAX      Unsigned32
 404     MAX-ACCESS  read-only
 405     STATUS      current
 406     DESCRIPTION
 407         "Maximum reconstructed reception unit.  This is the
 408          size of the largest reconstructed unit in octets that
 409          the decompressor is expected to reassemble from
 410          segments (see RFC 3095, Section 5.2.5).  Note that this
 411          size includes the CRC.  If MRRU is negotiated to be 0,
 412          no segment headers are allowed on the channel."
 413     REFERENCE
 414         "RFC 3095, Section 5.1.1"
 415     ::= { rohcInstanceEntry 11 }
 416
 417 rohcInstanceContextStorageTime OBJECT-TYPE
 418     SYNTAX      TimeInterval
 419     UNITS       "centi-seconds"
 420     MAX-ACCESS  read-write
 421     STATUS      current
 422     DESCRIPTION
 423         "This object indicates the default maximum amount of time
 424          information on a context belonging to this instance is kept
 425          as entry in the rohcContextTable after the context is
 426          expired or terminated.  The value of this object is used
 427          to initialize rohcContexStorageTime object when a new
 428          context is created.
 429          Changing the value of an rohcInstanceContextStorageTime
 430          instance does not affect any entry of the rohcContextTable
 431          created previously.
 432          ROHC-MIB implementations SHOULD store the set value of this
 433          object persistently."
 434     DEFVAL { 360000 }
 435     ::= { rohcInstanceEntry 12 }
 436
 437 rohcInstanceStatus OBJECT-TYPE
 438     SYNTAX      INTEGER {
 439                     enabled(1),
 440                     disabled(2)
 441                 }
 442     MAX-ACCESS  read-only
 443     STATUS      current
 444     DESCRIPTION
 445         "Status of the instance of ROHC."
 446
 447
 448
 449     ::= { rohcInstanceEntry 13 }
 450
 451 rohcInstanceContextsTotal OBJECT-TYPE
 452     SYNTAX      Counter32
 453     MAX-ACCESS  read-only
 454     STATUS      current
 455     DESCRIPTION
 456         "Counter of all contexts created by this instance.
 457
 458          Discontinuities in the value of this counter can
 459          occur at re-initialization of the management
 460          system, and at other times as indicated by the
 461          value of ifCounterDiscontinuityTime."
 462     ::= { rohcInstanceEntry 14 }
 463
 464 rohcInstanceContextsCurrent OBJECT-TYPE
 465     SYNTAX      Unsigned32
 466     MAX-ACCESS  read-only
 467     STATUS      current
 468     DESCRIPTION
 469         "Number of currently active contexts created by this
 470          instance."
 471     ::= { rohcInstanceEntry 15 }
 472
 473 rohcInstancePackets OBJECT-TYPE
 474     SYNTAX      Counter32
 475     MAX-ACCESS  read-only
 476     STATUS      current
 477     DESCRIPTION
 478         "Counter of all packets passing this instance.
 479
 480          Discontinuities in the value of this counter can
 481          occur at re-initialization of the management
 482          system, and at other times as indicated by the
 483          value of ifCounterDiscontinuityTime."
 484     ::= { rohcInstanceEntry 16 }
 485
 486 rohcInstanceIRs OBJECT-TYPE
 487     SYNTAX      Counter32
 488     MAX-ACCESS  read-only
 489     STATUS      current
 490     DESCRIPTION
 491         "The number of all IR packets that are either sent
 492          or received by this instance.
 493
 494          Discontinuities in the value of this counter can
 495          occur at re-initialization of the management
 496          system, and at other times as indicated by the
 497
 498
 499
 500          value of ifCounterDiscontinuityTime."
 501     REFERENCE
 502         "RFC 3095, Section 5.7.7.1"
 503     ::= { rohcInstanceEntry 17 }
 504
 505 rohcInstanceIRDYNs OBJECT-TYPE
 506     SYNTAX      Counter32
 507     MAX-ACCESS  read-only
 508     STATUS      current
 509     DESCRIPTION
 510         "The number of all IR-DYN packets that are either sent
 511          or received by this instance.
 512
 513          Discontinuities in the value of this counter can
 514          occur at re-initialization of the management
 515          system, and at other times as indicated by the
 516          value of ifCounterDiscontinuityTime."
 517     REFERENCE
 518         "RFC 3095, Section 5.7.7.2"
 519     ::= { rohcInstanceEntry 18 }
 520
 521 rohcInstanceFeedbacks OBJECT-TYPE
 522     SYNTAX      Counter32
 523     MAX-ACCESS  read-only
 524     STATUS      current
 525     DESCRIPTION
 526         "The number of all feedbacks that are either sent
 527          or received by this instance.
 528
 529          Discontinuities in the value of this counter can
 530          occur at re-initialization of the management
 531          system, and at other times as indicated by the
 532          value of ifCounterDiscontinuityTime."
 533     ::= { rohcInstanceEntry 19 }
 534
 535 rohcInstanceCompressionRatio OBJECT-TYPE
 536     SYNTAX      RohcCompressionRatio
 537     MAX-ACCESS  read-only
 538     STATUS      current
 539     DESCRIPTION
 540         "This object indicates the compression ratio so far over all
 541          packets on the channel served by this instance.  The
 542          compression is computed over all bytes of the IP packets
 543          including the IP header but excluding all lower layer
 544          headers."
 545     ::= { rohcInstanceEntry 20 }
 546
 547 --
 548
 549
 550
 551 -- Profile Table
 552 --
 553
 554 rohcProfileTable OBJECT-TYPE
 555     SYNTAX      SEQUENCE OF RohcProfileEntry
 556     MAX-ACCESS  not-accessible
 557     STATUS      current
 558     DESCRIPTION
 559         "This table lists a set of profiles supported by the
 560          instance."
 561     REFERENCE
 562         "RFC 3095, Section 5.1.1"
 563     ::= { rohcInstanceObjects 3 }
 564
 565 rohcProfileEntry OBJECT-TYPE
 566     SYNTAX      RohcProfileEntry
 567     MAX-ACCESS  not-accessible
 568     STATUS      current
 569     DESCRIPTION
 570         "An entry describing a particular profile supported by
 571          the instance.  It is indexed by the rohcChannelID
 572          identifying the instance and by the rohcProfile."
 573     INDEX { rohcChannelID, rohcProfile }
 574     ::= { rohcProfileTable 1 }
 575
 576 RohcProfileEntry ::= SEQUENCE {
 577     rohcProfile            Unsigned32,
 578     rohcProfileVendor      OBJECT IDENTIFIER,
 579     rohcProfileVersion     SnmpAdminString,
 580     rohcProfileDescr       SnmpAdminString,
 581     rohcProfileNegotiated  TruthValue
 582 }
 583
 584 rohcProfile OBJECT-TYPE
 585     SYNTAX      Unsigned32 (0..65535)
 586     MAX-ACCESS  not-accessible
 587     STATUS      current
 588     DESCRIPTION
 589         "Identifier of a profile supported.  For a listing of
 590          possible profile values, see the IANA registry for
 591          'RObust Header Compression (ROHC) Profile Identifiers'
 592          at http://www.iana.org/assignments/rohc-pro-ids"
 593     ::= { rohcProfileEntry 2 }
 594
 595 rohcProfileVendor OBJECT-TYPE
 596     SYNTAX      OBJECT IDENTIFIER
 597     MAX-ACCESS  read-only
 598     STATUS      current
 599
 600
 601
 602     DESCRIPTION
 603         "An object identifier that identifies the vendor who
 604          provides the implementation of robust header description.
 605          This object identifier SHALL point to the object identifier
 606          directly below the enterprise object identifier
 607          {1 3 6 1 4 1} allocated for the vendor.  The value must be
 608          the object identifier {0 0} if the vendor is not known."
 609     ::= { rohcProfileEntry 3 }
 610
 611 rohcProfileVersion OBJECT-TYPE
 612     SYNTAX      SnmpAdminString (SIZE (0..32))
 613     MAX-ACCESS  read-only
 614     STATUS      current
 615     DESCRIPTION
 616         "The version number of the implementation of robust header
 617          compression.  The zero-length string shall be used if the
 618          implementation does not have a version number.
 619
 620          It is suggested that the version number consist of one or
 621          more decimal numbers separated by dots, where the first
 622          number is called the major version number."
 623     ::= { rohcProfileEntry 4 }
 624
 625 rohcProfileDescr OBJECT-TYPE
 626     SYNTAX      SnmpAdminString
 627     MAX-ACCESS  read-only
 628     STATUS      current
 629     DESCRIPTION
 630         "A textual description of the implementation."
 631     ::= { rohcProfileEntry 5 }
 632
 633 rohcProfileNegotiated OBJECT-TYPE
 634     SYNTAX      TruthValue
 635     MAX-ACCESS  read-only
 636     STATUS      current
 637     DESCRIPTION
 638         "When retrieved, this boolean object returns true
 639          if the profile has been negotiated to be used at
 640          the instance, i.e., is supported also be the
 641          corresponding compressor/decompressor."
 642     ::= { rohcProfileEntry 6 }
 643
 644 --
 645 -- Context Table
 646 --
 647
 648 rohcContextTable OBJECT-TYPE
 649     SYNTAX      SEQUENCE OF RohcContextEntry
 650
 651
 652
 653     MAX-ACCESS  not-accessible
 654     STATUS      current
 655     DESCRIPTION
 656         "This table lists and describes all compressor contexts
 657          per instance."
 658     ::= { rohcObjects 2 }
 659
 660 rohcContextEntry OBJECT-TYPE
 661     SYNTAX      RohcContextEntry
 662     MAX-ACCESS  not-accessible
 663     STATUS      current
 664     DESCRIPTION
 665         "An entry describing a particular compressor context."
 666     INDEX {
 667         rohcChannelID,
 668         rohcContextCID
 669     }
 670     ::= { rohcContextTable 1 }
 671
 672 RohcContextEntry ::= SEQUENCE {
 673     rohcContextCID                  Unsigned32,
 674     rohcContextCIDState             INTEGER,
 675     rohcContextProfile              Unsigned32,
 676     rohcContextDecompressorDepth    Unsigned32,
 677     rohcContextStorageTime          TimeInterval,
 678     rohcContextActivationTime       DateAndTime,
 679     rohcContextDeactivationTime     DateAndTime,
 680     rohcContextPackets              Counter32,
 681     rohcContextIRs                  Counter32,
 682     rohcContextIRDYNs               Counter32,
 683     rohcContextFeedbacks            Counter32,
 684     rohcContextDecompressorFailures Counter32,
 685     rohcContextDecompressorRepairs  Counter32,
 686     rohcContextAllPacketsRatio      RohcCompressionRatio,
 687     rohcContextAllHeadersRatio      RohcCompressionRatio,
 688     rohcContextAllPacketsMeanSize   Unsigned32,
 689     rohcContextAllHeadersMeanSize   Unsigned32,
 690     rohcContextLastPacketsRatio     RohcCompressionRatio,
 691     rohcContextLastHeadersRatio     RohcCompressionRatio,
 692     rohcContextLastPacketsMeanSize  Unsigned32,
 693     rohcContextLastHeadersMeanSize  Unsigned32
 694 }
 695
 696 rohcContextCID OBJECT-TYPE
 697     SYNTAX      Unsigned32 (0..16383)
 698     MAX-ACCESS  not-accessible
 699     STATUS      current
 700     DESCRIPTION
 701
 702
 703
 704         "The context identifier (CID) of this context."
 705     REFERENCE
 706         "RFC 3095, Sections 5.1.1 and 5.1.3"
 707     ::= { rohcContextEntry 2 }
 708
 709 rohcContextCIDState OBJECT-TYPE
 710     SYNTAX      INTEGER {
 711                     unused(1),
 712                     active(2),
 713                     expired(3),
 714                     terminated(4)
 715                 }
 716     MAX-ACCESS  read-only
 717     STATUS      current
 718     DESCRIPTION
 719         "State of the CID.  When a CID is assigned to a context,
 720          its state changes from `unused' to `active'.  The active
 721          context may stop operation due to some explicit
 722          signalling or after observing no packet for some specified
 723          time.  In the first case then the CID state changes to
 724          `terminated', in the latter case it changes to `expired'.
 725          If the CID is re-used again for another context, the
 726          state changes back to `active'."
 727     ::= { rohcContextEntry 3 }
 728
 729 rohcContextProfile OBJECT-TYPE
 730     SYNTAX      Unsigned32 (0..65535)
 731     MAX-ACCESS  read-only
 732     STATUS      current
 733     DESCRIPTION
 734         "Identifier of the profile for this context.
 735          The profile is identified by its index in the
 736          rohcProfileTable for this instance.  There MUST exist a
 737          corresponding entry in the rohcProfileTable using the
 738          value of rohcContextProfile as second part of the index
 739          (and using the same rohcChannelID as first part of the
 740          index)."
 741     ::= { rohcContextEntry 4 }
 742
 743 rohcContextDecompressorDepth OBJECT-TYPE
 744     SYNTAX      Unsigned32
 745     MAX-ACCESS  read-only
 746     STATUS      current
 747     DESCRIPTION
 748         "This object indicates whether reverse decompression, for
 749          example as described in RFC 3095, Section 6.1, is used
 750          on this channel or not, and if used, to what extent.
 751
 752
 753
 754
 755          Its value is only valid for decompressor contexts, i.e.,
 756          if rohcInstanceType has the value decompressor(2).  For
 757          compressor contexts where rohcInstanceType has the value
 758          compressor(1), the value of this object is irrelevant
 759          and MUST be set to zero (0).
 760
 761          The value of the reverse decompression depth indicates
 762          the maximum number of packets that are buffered, and thus
 763          possibly be reverse decompressed by the decompressor.
 764          A zero (0) value means that reverse decompression is not
 765          used."
 766     ::= { rohcContextEntry 5 }
 767
 768 rohcContextStorageTime OBJECT-TYPE
 769     SYNTAX      TimeInterval
 770     UNITS       "centi-seconds"
 771     MAX-ACCESS  read-write
 772     STATUS      current
 773     DESCRIPTION
 774         "The value of this object specifies how long this row
 775          can exist in the rohcContextTable after the
 776          rohcContextCIDState switched to expired(3) or
 777          terminated(4).  This object returns  the remaining time
 778          that the row may exist before it is aged out.  The object
 779          is initialized with the value of the  associated
 780          rohcContextStorageTime object.  After expiration or
 781          termination of the context, the value of this object ticks
 782          backwards.  The entry in the rohcContextTable is destroyed
 783          when the value reaches 0.
 784
 785          The value of this object may be set in order to increase or
 786          reduce the remaining time that the row may exist.  Setting
 787          the value to 0 will destroy this entry as soon as the
 788          rochContextCIDState has the value expired(3) or
 789          terminated(4).
 790
 791          Note that there is no guarantee that the row is stored as
 792          long as this object indicates.  In case of limited CID
 793          space, the instance may re-use a CID before the storage
 794          time of the corresponding row in rohcContextTable reaches
 795          the value of 0.  In this case the information stored in this
 796          row is not anymore available."
 797     ::= { rohcContextEntry 6 }
 798
 799 rohcContextActivationTime OBJECT-TYPE
 800     SYNTAX      DateAndTime
 801     MAX-ACCESS  read-only
 802     STATUS      current
 803
 804
 805
 806     DESCRIPTION
 807         "The date and time when the context started to be able to
 808          compress packets or decompress packets, respectively.
 809          The value '0000000000000000'H is returned if the context
 810          has not been activated yet."
 811     DEFVAL { '0000000000000000'H }
 812     ::= { rohcContextEntry 7 }
 813
 814 rohcContextDeactivationTime OBJECT-TYPE
 815     SYNTAX      DateAndTime
 816     MAX-ACCESS  read-only
 817     STATUS      current
 818     DESCRIPTION
 819         "The date and time when the context stopped being able to
 820          compress packets or decompress packets, respectively,
 821          because it expired or was terminated for other reasons.
 822          The value '0000000000000000'H is returned if the context
 823          has not been deactivated yet."
 824     DEFVAL { '0000000000000000'H }
 825     ::= { rohcContextEntry 8 }
 826
 827 rohcContextPackets OBJECT-TYPE
 828     SYNTAX      Counter32
 829     MAX-ACCESS  read-only
 830     STATUS      current
 831     DESCRIPTION
 832         "The number of all packets passing this context.
 833
 834          Discontinuities in the value of this counter can
 835          occur at re-initialization of the management
 836          system, and at other times as indicated by the
 837          value of ifCounterDiscontinuityTime.  For checking
 838          ifCounterDiscontinuityTime, the interface index is
 839          required.  It can be determined by reading the
 840          rohcChannelTable."
 841     ::= { rohcContextEntry 9 }
 842
 843 rohcContextIRs OBJECT-TYPE
 844     SYNTAX      Counter32
 845     MAX-ACCESS  read-only
 846     STATUS      current
 847     DESCRIPTION
 848         "The number of all IR packets sent or received,
 849          respectively, by this context.
 850
 851          Discontinuities in the value of this counter can
 852          occur at re-initialization of the management
 853          system, and at other times as indicated by the
 854
 855
 856
 857          value of ifCounterDiscontinuityTime.  For checking
 858          ifCounterDiscontinuityTime, the interface index is
 859          required.  It can be determined by reading the
 860          rohcChannelTable."
 861     REFERENCE
 862         "RFC 3095, Section 5.7.7.1"
 863     ::= { rohcContextEntry 10 }
 864
 865 rohcContextIRDYNs OBJECT-TYPE
 866     SYNTAX      Counter32
 867     MAX-ACCESS  read-only
 868     STATUS      current
 869     DESCRIPTION
 870         "The number of all IR-DYN packets sent or received,
 871          respectively, by this context.
 872
 873          Discontinuities in the value of this counter can
 874          occur at re-initialization of the management
 875          system, and at other times as indicated by the
 876          value of ifCounterDiscontinuityTime.  For checking
 877          ifCounterDiscontinuityTime, the interface index is
 878          required.  It can be determined by reading the
 879          rohcChannelTable."
 880     REFERENCE
 881         "RFC 3095, Section 5.7.7.2"
 882     ::= { rohcContextEntry 11 }
 883
 884 rohcContextFeedbacks OBJECT-TYPE
 885     SYNTAX      Counter32
 886     MAX-ACCESS  read-only
 887     STATUS      current
 888     DESCRIPTION
 889         "The number of all feedbacks sent or received,
 890          respectively, by this context.
 891
 892          Discontinuities in the value of this counter can
 893          occur at re-initialization of the management
 894          system, and at other times as indicated by the
 895          value of ifCounterDiscontinuityTime.  For checking
 896          ifCounterDiscontinuityTime, the interface index is
 897          required.  It can be determined by reading the
 898          rohcChannelTable."
 899     ::= { rohcContextEntry 12 }
 900
 901 rohcContextDecompressorFailures OBJECT-TYPE
 902     SYNTAX      Counter32
 903     MAX-ACCESS  read-only
 904     STATUS      current
 905
 906
 907
 908     DESCRIPTION
 909         "The number of all decompressor failures so far in this
 910          context. The number is only valid for decompressor
 911          contexts, i.e., if rohcInstanceType has the value
 912          decompressor(2).
 913
 914          Discontinuities in the value of this counter can
 915          occur at re-initialization of the management
 916          system, and at other times as indicated by the
 917          value of ifCounterDiscontinuityTime.  For checking
 918          ifCounterDiscontinuityTime, the interface index is
 919          required.  It can be determined by reading the
 920          rohcChannelTable."
 921     ::= { rohcContextEntry 13 }
 922
 923 rohcContextDecompressorRepairs OBJECT-TYPE
 924     SYNTAX      Counter32
 925     MAX-ACCESS  read-only
 926     STATUS      current
 927     DESCRIPTION
 928         "The number of all context repairs so far in this
 929          context.  The number is only valid for decompressor
 930          contexts, i.e., if rohcInstanceType has the value
 931          decompressor(2).
 932
 933          Discontinuities in the value of this counter can
 934          occur at re-initialization of the management
 935          system, and at other times as indicated by the
 936          value of ifCounterDiscontinuityTime.  For checking
 937          ifCounterDiscontinuityTime, the interface index is
 938          required.  It can be determined by reading the
 939          rohcChannelTable."
 940     ::= { rohcContextEntry 14 }
 941
 942 rohcContextAllPacketsRatio OBJECT-TYPE
 943     SYNTAX      RohcCompressionRatio
 944     MAX-ACCESS  read-only
 945     STATUS      current
 946     DESCRIPTION
 947         "This object indicates the compression ratio so far over all
 948          packets passing this context.  The compression is computed
 949          over all bytes of the IP packets including the IP header
 950          but excluding all lower layer headers."
 951     ::= { rohcContextEntry 15 }
 952
 953 rohcContextAllHeadersRatio OBJECT-TYPE
 954     SYNTAX      RohcCompressionRatio
 955     MAX-ACCESS  read-only
 956
 957
 958
 959     STATUS      current
 960     DESCRIPTION
 961         "This object indicates the compression ratio so far over all
 962          packet headers passing this context.  The compression is
 963          computed over all bytes of all headers that are subject to
 964          compression for the used profile."
 965     ::= { rohcContextEntry 16 }
 966
 967 rohcContextAllPacketsMeanSize OBJECT-TYPE
 968     SYNTAX      Unsigned32
 969     MAX-ACCESS  read-only
 970     STATUS      current
 971     DESCRIPTION
 972         "This object indicates the mean compressed packet size
 973          of all packets passing this context.  The packet size
 974          includes the IP header and payload but excludes all lower
 975          layer headers.  The mean value is given in byte rounded
 976          to the next integer value."
 977     ::= { rohcContextEntry 17 }
 978
 979 rohcContextAllHeadersMeanSize OBJECT-TYPE
 980     SYNTAX      Unsigned32
 981     MAX-ACCESS  read-only
 982     STATUS      current
 983     DESCRIPTION
 984         "This object indicates the mean compressed packet header size
 985          of all packets passing this context.  The packet header size
 986          is the sum of the size of all headers of a packet that are
 987          subject to compression for the used profile.  The mean value
 988          is given in byte rounded to the next integer value."
 989     ::= { rohcContextEntry 18 }
 990
 991 rohcContextLastPacketsRatio OBJECT-TYPE
 992     SYNTAX      RohcCompressionRatio
 993     MAX-ACCESS  read-only
 994     STATUS      current
 995     DESCRIPTION
 996         "This object indicates the compression ratio
 997          concerning the last 16 packets passing this context
 998          or concerning all packets passing this context
 999          if they are less than 16, so far.  The compression is
1000          computed over all bytes of the IP packets including the IP
1001          header but excluding all lower layer headers."
1002     ::= { rohcContextEntry 19 }
1003
1004 rohcContextLastHeadersRatio OBJECT-TYPE
1005     SYNTAX      RohcCompressionRatio
1006     MAX-ACCESS  read-only
1007
1008
1009
1010     STATUS      current
1011     DESCRIPTION
1012         "This object indicates the compression ratio concerning the
1013          headers of the last 16 packets passing this context or
1014          concerning the headers of all packets passing this context
1015          if they are less than 16, so far.  The compression is
1016          computed over all bytes of all headers that are subject to
1017          compression for the used profile."
1018     ::= { rohcContextEntry 20 }
1019
1020 rohcContextLastPacketsMeanSize OBJECT-TYPE
1021     SYNTAX      Unsigned32
1022     MAX-ACCESS  read-only
1023     STATUS      current
1024     DESCRIPTION
1025         "This object indicates the mean compressed packet size
1026          concerning the last 16 packets passing this context or
1027          concerning all packets passing this context if they are
1028          less than 16, so far.  The packet size includes the IP
1029          header and payload but excludes all lower layer headers.
1030          The mean value is given in byte rounded to the next
1031          integer value."
1032     ::= { rohcContextEntry 21 }
1033
1034 rohcContextLastHeadersMeanSize OBJECT-TYPE
1035     SYNTAX      Unsigned32
1036     MAX-ACCESS  read-only
1037     STATUS      current
1038     DESCRIPTION
1039         "This object indicates the mean compressed packet header size
1040          concerning the last 16 packets passing this context or
1041          concerning all packets passing this context if they are
1042          less than 16, so far.  The packet header size is the sum of
1043          the size of all headers of a packet that are subject to
1044          compression for the used profile.  The mean value is given
1045          in byte rounded to the next integer value."
1046     ::= { rohcContextEntry 22 }
1047
1048 --
1049 -- conformance information
1050 --
1051
1052 rohcCompliances OBJECT IDENTIFIER ::= { rohcConformance 1 }
1053 rohcGroups      OBJECT IDENTIFIER ::= { rohcConformance 2 }
1054
1055 --
1056 -- compliance statements
1057 --
1058
1059
1060
1061
1062
1063 rohcCompliance MODULE-COMPLIANCE
1064     STATUS      current
1065     DESCRIPTION
1066         "The compliance statement for SNMP entities that implement
1067          the ROHC-MIB.
1068
1069          Note that compliance with this compliance
1070          statement requires compliance with the
1071          ifCompliance3 MODULE-COMPLIANCE statement of the
1072          IF-MIB (RFC2863)."
1073     MODULE      -- this module
1074     MANDATORY-GROUPS {
1075             rohcInstanceGroup, rohcContextGroup
1076     }
1077     GROUP   rohcStatisticsGroup
1078     DESCRIPTION
1079        "A compliant implementation does not have to implement
1080         the rohcStatisticsGroup."
1081     GROUP   rohcTimerGroup
1082     DESCRIPTION
1083        "A compliant implementation does not have to implement
1084         the rohcTimerGroup."
1085     OBJECT  rohcInstanceContextStorageTime
1086     MIN-ACCESS  read-only
1087     DESCRIPTION
1088         "A compliant implementation does not have to support changing
1089          the value of object rohcInstanceContextStorageTime."
1090     OBJECT  rohcContextStorageTime
1091     MIN-ACCESS  read-only
1092     DESCRIPTION
1093         "A compliant implementation does not have to support changing
1094          the value of object rohcContextStorageTime."
1095     GROUP   rohcContextStatisticsGroup
1096     DESCRIPTION
1097        "A compliant implementation does not have to implement
1098         the rohcContextStatisticsGroup."
1099     ::= { rohcCompliances 1 }
1100
1101 rohcInstanceGroup OBJECT-GROUP
1102     OBJECTS {
1103         rohcChannelType,
1104         rohcChannelFeedbackFor,
1105         rohcChannelDescr,
1106         rohcChannelStatus,
1107         rohcInstanceFBChannelID,
1108         rohcInstanceVendor,
1109
1110
1111
1112         rohcInstanceVersion,
1113         rohcInstanceDescr,
1114         rohcInstanceClockRes,
1115         rohcInstanceMaxCID,
1116         rohcInstanceLargeCIDs,
1117         rohcInstanceMRRU,
1118         rohcInstanceStatus,
1119         rohcProfileVendor,
1120         rohcProfileVersion,
1121         rohcProfileDescr,
1122         rohcProfileNegotiated
1123     }
1124     STATUS      current
1125     DESCRIPTION
1126         "A collection of objects providing information about
1127          ROHC instances, used channels and available profiles."
1128     ::= { rohcGroups 2 }
1129
1130 rohcStatisticsGroup OBJECT-GROUP
1131     OBJECTS {
1132         rohcInstanceContextsTotal,
1133         rohcInstanceContextsCurrent,
1134         rohcInstancePackets,
1135         rohcInstanceIRs,
1136         rohcInstanceIRDYNs,
1137         rohcInstanceFeedbacks,
1138         rohcInstanceCompressionRatio
1139     }
1140     STATUS      current
1141     DESCRIPTION
1142         "A collection of objects providing ROHC statistics."
1143     ::= { rohcGroups 4 }
1144
1145 rohcContextGroup OBJECT-GROUP
1146     OBJECTS {
1147         rohcContextCIDState,
1148         rohcContextProfile,
1149         rohcContextDecompressorDepth
1150     }
1151     STATUS      current
1152     DESCRIPTION
1153         "A collection of objects providing information about
1154          ROHC compressor contexts and decompressor contexts."
1155     ::= { rohcGroups 5 }
1156
1157 rohcTimerGroup OBJECT-GROUP
1158     OBJECTS {
1159         rohcInstanceContextStorageTime,
1160
1161
1162
1163         rohcContextStorageTime,
1164         rohcContextActivationTime,
1165         rohcContextDeactivationTime
1166
1167     }
1168     STATUS      current
1169     DESCRIPTION
1170         "A collection of objects providing statistical information
1171          about ROHC compressor contexts and decompressor contexts."
1172     ::= { rohcGroups 6 }
1173
1174 rohcContextStatisticsGroup OBJECT-GROUP
1175     OBJECTS {
1176         rohcContextPackets,
1177         rohcContextIRs,
1178         rohcContextIRDYNs,
1179         rohcContextFeedbacks,
1180         rohcContextDecompressorFailures,
1181         rohcContextDecompressorRepairs,
1182         rohcContextAllPacketsRatio,
1183         rohcContextAllHeadersRatio,
1184         rohcContextAllPacketsMeanSize,
1185         rohcContextAllHeadersMeanSize,
1186         rohcContextLastPacketsRatio,
1187         rohcContextLastHeadersRatio,
1188         rohcContextLastPacketsMeanSize,
1189         rohcContextLastHeadersMeanSize
1190     }
1191     STATUS      current
1192     DESCRIPTION
1193         "A collection of objects providing statistical information
1194          about ROHC compressor contexts and decompressor contexts."
1195     ::= { rohcGroups 7 }
1196
1197 END