rfc1024.txt

来自「中、英文RFC文档大全打包下载完全版 .」· 文本 代码 · 共 2,101 行 · 第 1/5 页

       that limit.

   OBJECT:  pktOctets

   Type:  INTEGER

   Definition:  The maximum number of octets that can be buffered in the
       entity at any one time.

   Object Status:  Required if the entity has a maximum number of octets
       it can buffer.  Note that most entities do have a limit and
       should return that limit.


   OBJECT:  pktBuffersFree

   Type:  INTEGER

   Definition:  The number of packet buffers currently available.
       Subtracting pktBuffersFree from pktBuffers should give the
       number of buffers in use.

   Object Status:  Required if there is a limit on the number of
       buffers.


   OBJECT: pktOctetsFree

   Type: INTEGER

   Definition:  The number of octets currently available including those
       not used in allocated buffers.  Subtracting this value from
       pktOctets should give the number of octets in use.

       This object can be used to track how well the entity buffers its
       data.

       Object Status:  Required if there is a limit on the number of
       octets that can be buffered.


   OBJECT:  systemID

   Type:  IA5STRING

   Definition:  The text identification of the entity.  This value
       should include the full name of the vendor, the type of system,



Partridge & Trewitt                                            [Page 16]

RFC 1024                    HEMS Definitions                October 1987


       and the version number of the hardware and software running on
       the entity.


The EventControls Dictionary

    The EventControls dictionary contains objects to control and
    monitor the delivery of event messages to operations centers.
    The format of this dictionary is shown below.


       EventControls ::= [APPLICATION 34] IMPLICIT SET OPTIONAL {
           lastEvent      [0] IMPLICIT OCTETSTRING OPTIONAL,
           eventMessageID [1] IMPLICIT Counter,
           eventCenters   [2] IMPLICIT SET of IpAddress,
           eventList      [3] IMPLICIT SET of eventEntry,
       }


    OBJECT: eventControls

    Type: SET

    Definition: See above.

    Object Status:  This object will be required in entities which
        support events, after the event definitions have been
        properly specified.  See discussion of the event formats
        at the end of this memo.

    A description of the fields in this dictionary are given below.


    OBJECT:  lastEvent

    Type:  OCTETSTRING

    Definition:  The last event message sent.

    Object Status: Implementation of this object is encouraged if the
        transport protocol used for events is unreliable (e.g., UDP).


    OBJECT:  eventMessageID


    Type:  Counter




Partridge & Trewitt                                            [Page 17]

RFC 1024                    HEMS Definitions                October 1987


    Definition:  The HEMP MessageId to be used in the next event
        message.  Equals the number of events sent.

    OBJECT:  eventCenters

    Type:  SET of IpAddress

    Definition:  The list of IP addresses to which events are sent.
        This list receives all events.  For more selective event
        monitoring, centers should list themselves under the
        particular events of interest.

    Note:  If the SET operator is defined then use of some form of
        access control is recommended.

    Operations on Object: The defaults except as listed below.

        CREATE:  Adds an address to the list.  The new address may
            not be a broadcast address (it may be a multicast
            address).

        DELETE:  Deletes an address from the list.

        SET-MATCH:  Defined on the IP address.  Replaces the
            address with a new value.

        EMIT-MATCH:  Defined on the IP address.


    OBJECT:  eventList

    Type: SET of eventEntry

    Definition: An array of entries which contain objects which allow
        management centers to control how and when events are sent.
        (The contents of the eventEntry structure are explained below.)

The eventControls Dictionary:  eventList/eventEntry

    The eventEntry provides the necessary control objects to manage how
    a particular event is sent.  The format of the eventEntry is shown
    below.

            eventEntry ::= [0] IMPLICIT SET {
                eventID        [0] IMPLICIT INTEGER,
                eventMode      [1] IMPLICIT INTEGER,
                eventCount     [2] IMPLICIT Counter,
                threshold      [3] IMPLICIT Counter,



Partridge & Trewitt                                            [Page 18]

RFC 1024                    HEMS Definitions                October 1987


                thresholdIncr  [4] IMPLICIT INTEGER,
                eventExecution [5] IMPLICIT InstructionGroup OPTIONAL,
                eventCenters   [6] IMPLICIT SET of IpAddress
            }

    OBJECT:  eventEntry

    Type:  SET

    Definition:  See Above.


    OBJECT:  eventID

    Type:  INTEGER

    Definition:  The particular event ID.


    OBJECT:  eventMode

    Type:  INTEGER

    Definition:  A control object which determines how and whether this
        event is sent.  The three modes are:

           0 -- unused.

           1 -- off.  The event is not sent.

           2 -- on.   The event is sent every time it occurs.

           3 -- threshold.  The event is sent every time the
                event count reaches the threshold.


    OBJECT:  eventCount

    Type:  Counter

    Definition:  The number of times this event has occurred.


    OBJECT:  threshold

    Type:  Counter





Partridge & Trewitt                                            [Page 19]

RFC 1024                    HEMS Definitions                October 1987


    Definition: The event threshold.  If the eventMode is "threshold"
        then a event is sent every time the eventCount equals this
        value.

    Operations on Object:  The defaults except as noted below.

            SET:  Changes the threshold.

    OBJECT:  thresholdIncr

    Type:  INTEGER

    Definition:  The threshold increment.  Every time a event threshold
        is reached, the threshold value is incremented by this value
        (modulo the precision of the Counter) to find the new
        threshold.

    Operations on Object:  The defaults except as noted below.

            SET:  Changes the increment.


    OBJECT:  eventExecution

    Type:  InstructionGroup

    Definition:  A query to be executed whenever the event is actually
        sent.  Any data retrieved by this query is appended to the
        event message.

    Object Status:  Encouraged.

    Operations on Object:  The defaults except as noted below.

            SET:  Changes the buffer.


    OBJECT:  eventCenters

    Type:  SET

    Definition:  The IP addresses of the monitoring centers which wish
        to listen to this particular event.  Note that events should be
        sent to both these centers and the global list of event centers.

    Operations on Object:  The defaults except as noted below.

            CREATE:  Adds an address to the list of centers.



Partridge & Trewitt                                            [Page 20]

RFC 1024                    HEMS Definitions                October 1987


            DELETE:  Deletes an address from the list.

            SET-MATCH:  Defined on the IP address.  Replaces the
                entry with a new value.

            EMIT-MATCH:  Defined on the IP address.


The Interfaces Dictionary

    The Interfaces dictionary a list of per-interface objects.  Since
    one of the fundamental goals of HEMS is to use generic interfaces
    across differing hardwares, all hardware interfaces are described by
    the same data structure, the InterfaceData.

         Interfaces ::= [APPLICATION 35] IMPLICIT SET OF InterfaceData

    OBJECT:  Interfaces

    Type:  SET

    Definition:  see above.


The Interfaces Dictionary: The InterfaceData structure.

    The InterfaceData structure contains all information on a particular
    interface.  The form of the structure is shown below.

            InterfaceData ::= [0] IMPLICIT SET {
                addresses         [0] IMPLICIT SET of IpAddress,
                mtu               [1] IMPLICIT INTEGER,
                netMask           [2] IMPLICIT IpAddress,
                pktsIn            [3] IMPLICIT Counter,
                pktsOut           [4] IMPLICIT Counter,
                inputPktsDropped  [5] IMPLICIT Counter,
                outputPktsDropped [6] IMPLICIT Counter,
                bcastPktsIn       [7] IMPLICIT Counter OPTIONAL,
                bcastPktsOut      [8] IMPLICIT Counter OPTIONAL,
                mcastPktsIn       [9] IMPLICIT Counter OPTIONAL,
                mcastPktsOut     [10] IMPLICIT Counter OPTIONAL,
                inputErrors      [11] IMPLICIT Counter,
                outputErrors     [12] IMPLICIT Counter,
                outputQLen       [13] IMPLICIT INTEGER,
                name             [14] IMPLICIT IA5String,
                status           [15] IMPLICIT INTEGER,
                ifType           [16] IMPLICIT INTEGER,
                mediaErrors      [17] IMPLICIT Counter OPTIONAL,



Partridge & Trewitt                                            [Page 21]

RFC 1024                    HEMS Definitions                October 1987


                upTime           [18] IMPLICIT TimeStamp,
                broadcast        [19] IMPLICIT BITSTRING
                multicast        [20] IMPLICIT SET of BITSTRING,
                addressList      [21] IMPLICIT SET OPTIONAL,
            }

    OBJECT:  InterfaceData

    Type:  SET

    Definition:  see above.

    Operations on Object:  The defaults except as noted below.

        SET-MATCH:  This operation is optionally defined on the
            address field of the structure.  Only certain fields
            in this structure may be changed.  The fields which
            may be SET are indicated in the descriptions below.

        GET-MATCH:  Defined to emit information on the interface
            which matches the address given.

    The fields in the structure are defined below.


    OBJECT:  addresses

    Type:  SET of IpAddress

    Definition:  The IP addresses that the interface accepts.  Note that
        additional information on multicast addresses may be found in
        the IgmpValues dictionary.


    OBJECT:  mtu

    Type:  INTEGER

    Definition:  The maximum transmission unit of the device.


    OBJECT:  netMask

    Type:  IpAddress

    Definition:  The subnet mask, which is an address with all the
        network bits set to 1 and all the hosts bits set to 0.  Used to
        identify subnets.



Partridge & Trewitt                                            [Page 22]

RFC 1024                    HEMS Definitions                October 1987


    OBJECT:  pktsIn

    Type:  Counter

    Definition:  The total number of packets received on this interface
        including those in error.


    OBJECT:  pktsOut

    Type:  Counter

    Definition:  The total number of packets that higher levels have
        attempted to send, including those that were not sent.


    OBJECT:  inputPktsDropped

    Type:  Counter

    Definition:  The number of good inbound packets dropped (presumably
        to free up buffer space).

    OBJECT:  outputPktsDropped

    Type:  Counter

    Definition:  The number of good outbound packets dropped (presumably
        to free up buffer space).