Blame mibs/ietf/HCNUM-TC

Packit 022b05
HCNUM-TC DEFINITIONS ::= BEGIN
Packit 022b05
Packit 022b05
IMPORTS
Packit 022b05
  MODULE-IDENTITY, mib-2, Counter64
Packit 022b05
      FROM SNMPv2-SMI
Packit 022b05
  TEXTUAL-CONVENTION
Packit 022b05
      FROM SNMPv2-TC;
Packit 022b05
Packit 022b05
hcnumTC MODULE-IDENTITY
Packit 022b05
  LAST-UPDATED "200006080000Z"
Packit 022b05
Packit 022b05
Packit 022b05
  ORGANIZATION "IETF OPS Area"
Packit 022b05
  CONTACT-INFO
Packit 022b05
        "        E-mail: mibs@ops.ietf.org
Packit 022b05
                 Subscribe: majordomo@psg.com
Packit 022b05
                   with msg body: subscribe mibs
Packit 022b05
Packit 022b05
                 Andy Bierman
Packit 022b05
                 Cisco Systems Inc.
Packit 022b05
                 170 West Tasman Drive
Packit 022b05
                 San Jose, CA 95134 USA
Packit 022b05
                 +1 408-527-3711
Packit 022b05
                 abierman@cisco.com
Packit 022b05
Packit 022b05
                 Keith McCloghrie
Packit 022b05
                 Cisco Systems Inc.
Packit 022b05
                 170 West Tasman Drive
Packit 022b05
                 San Jose, CA 95134 USA
Packit 022b05
                 +1 408-526-5260
Packit 022b05
                 kzm@cisco.com
Packit 022b05
Packit 022b05
                 Randy Presuhn
Packit 022b05
                 BMC Software, Inc.
Packit 022b05
                 Office 1-3141
Packit 022b05
                 2141 North First Street
Packit 022b05
                 San Jose,  California 95131 USA
Packit 022b05
                 +1 408 546-1006
Packit 022b05
                 rpresuhn@bmc.com"
Packit 022b05
  DESCRIPTION
Packit 022b05
        "A MIB module containing textual conventions
Packit 022b05
         for high capacity data types. This module
Packit 022b05
         addresses an immediate need for data types not directly
Packit 022b05
         supported in the SMIv2. This short-term solution
Packit 022b05
         is meant to be deprecated as a long-term solution
Packit 022b05
         is deployed."
Packit 022b05
  REVISION        "200006080000Z"
Packit 022b05
  DESCRIPTION
Packit 022b05
        "Initial Version of the High Capacity Numbers
Packit 022b05
         MIB module, published as RFC 2856."
Packit 022b05
  ::= { mib-2 78 }
Packit 022b05
Packit 022b05
CounterBasedGauge64 ::= TEXTUAL-CONVENTION
Packit 022b05
  STATUS       current
Packit 022b05
  DESCRIPTION
Packit 022b05
        "The CounterBasedGauge64 type represents a non-negative
Packit 022b05
        integer, which may increase or decrease, but shall never
Packit 022b05
        exceed a maximum value, nor fall below a minimum value. The
Packit 022b05
        maximum value can not be greater than 2^64-1
Packit 022b05
        (18446744073709551615 decimal), and the minimum value can
Packit 022b05
Packit 022b05
Packit 022b05
        not be smaller than 0.  The value of a CounterBasedGauge64
Packit 022b05
        has its maximum value whenever the information being modeled
Packit 022b05
        is greater than or equal to its maximum value, and has its
Packit 022b05
        minimum value whenever the information being modeled is
Packit 022b05
        smaller than or equal to its minimum value.  If the
Packit 022b05
        information being modeled subsequently decreases below
Packit 022b05
        (increases above) the maximum (minimum) value, the
Packit 022b05
        CounterBasedGauge64 also decreases (increases).
Packit 022b05
Packit 022b05
        Note that this TC is not strictly supported in SMIv2,
Packit 022b05
        because the 'always increasing' and 'counter wrap' semantics
Packit 022b05
        associated with the Counter64 base type are not preserved.
Packit 022b05
        It is possible that management applications which rely
Packit 022b05
        solely upon the (Counter64) ASN.1 tag to determine object
Packit 022b05
        semantics will mistakenly operate upon objects of this type
Packit 022b05
        as they would for Counter64 objects.
Packit 022b05
Packit 022b05
        This textual convention represents a limited and short-term
Packit 022b05
        solution, and may be deprecated as a long term solution is
Packit 022b05
        defined and deployed to replace it."
Packit 022b05
  SYNTAX Counter64
Packit 022b05
Packit 022b05
Packit 022b05
ZeroBasedCounter64 ::= TEXTUAL-CONVENTION
Packit 022b05
  STATUS current
Packit 022b05
  DESCRIPTION
Packit 022b05
        "This TC describes an object which counts events with the
Packit 022b05
        following semantics: objects of this type will be set to
Packit 022b05
        zero(0) on creation and will thereafter count appropriate
Packit 022b05
        events, wrapping back to zero(0) when the value 2^64 is
Packit 022b05
        reached.
Packit 022b05
Packit 022b05
        Provided that an application discovers the new object within
Packit 022b05
        the minimum time to wrap it can use the initial value as a
Packit 022b05
        delta since it last polled the table of which this object is
Packit 022b05
        part.  It is important for a management station to be aware
Packit 022b05
        of this minimum time and the actual time between polls, and
Packit 022b05
        to discard data if the actual time is too long or there is
Packit 022b05
        no defined minimum time.
Packit 022b05
Packit 022b05
        Typically this TC is used in tables where the INDEX space is
Packit 022b05
        constantly changing and/or the TimeFilter mechanism is in
Packit 022b05
        use.
Packit 022b05
Packit 022b05
        Note that this textual convention does not retain all the
Packit 022b05
        semantics of the Counter64 base type. Specifically, a
Packit 022b05
        Counter64 has an arbitrary initial value, but objects
Packit 022b05
        defined with this TC are required to start at the value
Packit 022b05
Packit 022b05
Packit 022b05
        zero.  This behavior is not likely to have any adverse
Packit 022b05
        effects on management applications which are expecting
Packit 022b05
        Counter64 semantics.
Packit 022b05
Packit 022b05
        This textual convention represents a limited and short-term
Packit 022b05
        solution, and may be deprecated as a long term solution is
Packit 022b05
        defined and deployed to replace it."
Packit 022b05
  SYNTAX Counter64
Packit 022b05
Packit 022b05
END