Blame mibs/HCNUM-TC.txt

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