home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / rfc / 3 / rfc2325.txt < prev    next >
Encoding:
Text File  |  2003-06-11  |  12.4 KB  |  452 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                       M. Slavitch
  8. Request for Comments: 2325                      Loran Technologies Inc.
  9. Category: Informational                                    1 April 1998
  10.  
  11.  
  12.       Definitions of Managed Objects for Drip-Type Heated Beverage
  13.                       Hardware Devices using SMIv2
  14.  
  15. Status of this Memo
  16.  
  17.    This memo provides information for the Internet community.  It does
  18.    not specify an Internet standard of any kind.  Distribution of this
  19.    memo is unlimited.
  20.  
  21. Copyright Notice
  22.  
  23.    Copyright (C) The Internet Society (1998).  All Rights Reserved.
  24.  
  25. Table of Contents
  26.  
  27.    1. Introduction ...............................................    1
  28.    2. The SNMPv2 Network Management Framework ....................    1
  29.    2.1 Object Definitions ........................................    2
  30.    3. Overview ...................................................    2
  31.    3.1 Relationship to Interface MIB .............................    2
  32.    4. Definitions ................................................    3
  33.    5. Acknowledgements ...........................................    6
  34.    6. References .................................................    6
  35.    7. Security Considerations ....................................    6
  36.    8. Author's Address ...........................................    7
  37.    9. Full Copyright Statement ...................................    8
  38.  
  39. 1.  Introduction
  40.  
  41.    This memo defines an extension to the Management Information Base
  42.    (MIB) for use with network management protocols in the Internet
  43.    community.  In particular, it defines objects for the management of
  44.    coffee-brewing and maintenance devices.
  45.  
  46. 2.  The SNMPv2 Network Management Framework
  47.  
  48.    The SNMPv2 Network Management Framework consists of four major
  49.    components.  They are:
  50.  
  51.       o    RFC 1442 [1] which defines the SMI, the mechanisms used for
  52.            describing and naming objects for the purpose of management.
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Slavitch                     Informational                      [Page 1]
  59.  
  60. RFC 2325                         CP MIB                     1 April 1998
  61.  
  62.  
  63.       o    STD 17, RFC 1213 [2] defines MIB-II, the core set of managed
  64.            objects for the Internet suite of protocols.
  65.  
  66.       o    RFC 1445 [3] which defines the administrative and other
  67.            architectural aspects of the framework.
  68.  
  69.       o    RFC 1448 [4] which defines the protocol used for network
  70.            access to managed objects.
  71.  
  72.    The Framework permits new objects to be defined for the purpose of
  73.    experimentation and evaluation.
  74.  
  75. 2.1.  Object Definitions
  76.  
  77.    Managed objects are accessed via a virtual information store, termed
  78.    the Management Information Base or MIB.  Objects in the MIB are
  79.    defined using the subset of Abstract Syntax Notation One (ASN.1)
  80.    defined in the SMI.  In particular, each object object type is named
  81.    by an OBJECT IDENTIFIER, an administratively assigned name.  The
  82.    object type together with an object instance serves to uniquely
  83.    identify a specific instantiation of the object.  For human
  84.    convenience, we often use a textual string, termed the descriptor, to
  85.    refer to the object type.
  86.  
  87. 3.  Overview
  88.  
  89.    The COFFEE POT MIB applies to managed devices that brew, store, and
  90.    deliver heated coffee beverages. The COFFEE POT MIB is mandatory for
  91.    all systems that have such a hardware port supporting services
  92.    managed through some other MIB.
  93.  
  94.    The MIB contains objects that relate to physical connections,
  95.    configuration, storage levels, availabilty, quality of service, and
  96.    availability.
  97.  
  98. 3.1.  Relationship to Interface MIB
  99.  
  100.    The COFFEE-POT-MIB is one of many MIBs designed for layered use as
  101.    described in the Interface MIB [5].  In most implementations where it
  102.    is present, it will be in the lowest interface sublayer, that is, the
  103.    COFFEE-POT-MIB represents the physical layer, providing service to
  104.    higher layers such as the Character MIB [6].
  105.  
  106.    Although it is unlikely that a coffee port will actually be used as a
  107.    network interface, which is the intent of the Interface MIB, the
  108.    COFFEE-POT-MIB is closely connected to the Character MIB, which can
  109.    share hardware interfaces with network operation, and relate to the
  110.    RS-232 MIB [7].
  111.  
  112.  
  113.  
  114. Slavitch                     Informational                      [Page 2]
  115.  
  116. RFC 2325                         CP MIB                     1 April 1998
  117.  
  118.  
  119.    The Interface MIB's ifTestTable and ifRcvAddressTable are not
  120.    relevant to the COFFEE-POT-MIB.
  121.  
  122.    The COFFEE-POT-MIB is relevant for ifType values sip(31), and perhaps
  123.    others.
  124.  
  125.    The COFFEE-POT-MIB requires the conformance groups ifGeneralGroup,
  126.    and ifFixedLengthGroup.
  127.  
  128.    Usefulness of error counters in this MIB depends on the octet
  129.    counters in ifFixedLengthGroup.
  130.  
  131. 4.  Definitions
  132.  
  133.    COFFEE-POT-MIB DEFINITIONS ::= BEGIN
  134.  
  135.    IMPORTS
  136.        MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
  137.        TimeStamp, TimeInterval,
  138.        Counter32, Integer32
  139.            FROM SNMPv2-SMI
  140.        InterfaceIndex
  141.            FROM IF-MIB
  142.        transmission
  143.            FROM RFC1213-MIB
  144.        MODULE-COMPLIANCE, OBJECT-GROUP
  145.            FROM SNMPv2-CONF;
  146.  
  147.    coffee MODULE-IDENTITY
  148.         LAST-UPDATED "9803231700Z"
  149.         ORGANIZATION "Networked Appliance Management Working Group"
  150.  
  151.         CONTACT-INFO
  152.                "        Michael Slavitch
  153.                         Loran Technologies,
  154.                         955 Green Valley Crescent
  155.                         Ottawa, Ontario Canada K2A 0B6
  156.  
  157.                    Tel: 613-723-7505
  158.                    Fax: 613-723-7209
  159.                 E-mail: slavitch@loran.com"
  160.         DESCRIPTION
  161.                "The MIB Module for coffee vending devices."
  162.        ::= { transmission 132 }
  163.  
  164.    potName OBJECT-TYPE
  165.         SYNTAX     DisplayString (SIZE (0..255))
  166.         MAX-ACCESS read-only
  167.  
  168.  
  169.  
  170. Slavitch                     Informational                      [Page 3]
  171.  
  172. RFC 2325                         CP MIB                     1 April 1998
  173.  
  174.  
  175.         STATUS current
  176.         DESCRIPTION
  177.                 "The vendor description of the pot under management"
  178.         ::= { coffee 1 }
  179.  
  180.  
  181.    potCapacity OBJECT-TYPE
  182.         SYNTAX Integer32
  183.         MAX-ACCESS read-only
  184.         STATUS current
  185.         DESCRIPTION
  186.            "The number of units of beverage supported by this device
  187.             (regardless of its current state) ."
  188.        ::= { coffee 2 }
  189.  
  190.  
  191.    potType OBJECT-TYPE
  192.         SYNTAX     INTEGER {
  193.            automatic-drip(1),
  194.            percolator(2),
  195.            french-press(3),
  196.            espresso(4),
  197.            }
  198.         MAX-ACCESS read-write
  199.         STATUS current
  200.         DESCRIPTION
  201.                 "The brew type of the coffee pot."
  202.         ::= { coffee 3 }
  203.  
  204.    potLocation OBJECT-TYPE {
  205.         SYNTAX     DisplayString (SIZE (0..255))
  206.         MAX-ACCESS read-write
  207.         STATUS current
  208.         DESCRIPTION
  209.                 "The physical location of the pot in question"
  210.         ::= { coffee 4 }
  211.  
  212.  
  213.    potMonitor            OBJECT IDENTIFIER ::= { coffee 6 }
  214.  
  215.  
  216.    potOperStatus
  217.         SYNTAX     Integer {
  218.                         off(1),
  219.                         brewing(2),
  220.                         holding(3),
  221.                         other(4),
  222.                         waiting(5)
  223.  
  224.  
  225.  
  226. Slavitch                     Informational                      [Page 4]
  227.  
  228. RFC 2325                         CP MIB                     1 April 1998
  229.  
  230.  
  231.                         }
  232.         MAX-ACCESS read-only
  233.         STATUS current
  234.         DESCRIPTION
  235.                 "The operating status of the pot in question. Note
  236.                  that this is a read-only feature. Current hardware
  237.                  prevents us from changing the port state via SNMP."
  238.         ::= { potMonitor 1 }
  239.  
  240.     potLevel OBJECT-TYPE
  241.         SYNTAX     Integer32
  242.         MAX-ACCESS read-only
  243.         STATUS current
  244.         DESCRIPTION
  245.                 "The number of units of coffee under management. The
  246.                  units of level are defined in potMetric below."
  247.         ::= { potMonitor 2 }
  248.  
  249.     potMetric  OBJECT-TYPE
  250.         SYNTAX     Integer {
  251.                     espresso(1),
  252.                     demi-tasse(2),
  253.                     cup(3),
  254.                     mug(4),
  255.                     bucket(5)
  256.                     }
  257.         MAX-ACCESS read-only
  258.         STATUS current
  259.         DESCRIPTION
  260.                 "The vendor description of the pot under management"
  261.         ::= { potMonitor 3 }
  262.  
  263.  
  264.    potStartTime OBJECT-TYPE
  265.        SYNTAX     Integer64
  266.        MAX-ACCESS read-write
  267.        STATUS     current
  268.        DESCRIPTION
  269.                "The time in seconds since Jan 1 1970 to start the pot
  270.                 if and only if potOperStatus is waiting(5)"
  271.        ::= { potMonitor 4 }
  272.  
  273.  
  274.     lastStartTime OBJECT-TYPE
  275.        SYNTAX     TimeInterval
  276.        MAX-ACCESS read-only
  277.        STATUS     current
  278.        DESCRIPTION
  279.  
  280.  
  281.  
  282. Slavitch                     Informational                      [Page 5]
  283.  
  284. RFC 2325                         CP MIB                     1 April 1998
  285.  
  286.  
  287.                "The amount of time, in TimeTicks, since the coffee
  288.                making process was initiated."
  289.        ::= { potMonitor 5 }
  290.  
  291.  
  292.     potTemperature OBJECT-TYPE
  293.        SYNTAX     Integer32
  294.        UNITS      "degrees Centigrade"
  295.        MAX-ACCESS read-only
  296.        STATUS     current
  297.        DESCRIPTION
  298.                "The ambient temperature of the coffee within the pot"
  299.  
  300.       ::= { potMonitor 6 }
  301.  
  302.    END
  303.  
  304. 5.  Acknowledgements
  305.  
  306.    Networked Appliance Management Working Group (not) of the IETF.
  307.  
  308. 6.  References
  309.  
  310.    [1] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure
  311.        of Management Information for version 2 of the Simple Network
  312.        Management Protocol (SNMPv2)", RFC 1442, April 1993.
  313.  
  314.    [2] McCloghrie, K., and M. Rose, Editors, "Management Information
  315.        Base for Network Management of TCP/IP-based internets: MIB-II",
  316.        STD 17, RFC 1213, March 1991.
  317.  
  318.    [3] Galvin, J., and K. McCloghrie, "Administrative Model for version
  319.        2 of the Simple Network Management Protocol (SNMPv2)", RFC 1445,
  320.        April 1993.
  321.  
  322.    [4] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol
  323.        Operations for version 2 of the Simple Network Management
  324.        Protocol (SNMPv2)", RFC 1448, April 1993.
  325.  
  326.    [5] McCloghrie, K., and F. Kastenholz, "Evolution of the Interfaces
  327.        Group of MIB-II", RFC 1573, January 1994.
  328.  
  329.    [6] Valdez, Juan, "Definitions of Columbian Objects for Coffee Pot
  330.        Devices using SMIv2", Columbia, Inc., March 1998.
  331.  
  332. 7.  Security Considerations
  333.  
  334.    Security issues are not discussed in this memo.
  335.  
  336.  
  337.  
  338. Slavitch                     Informational                      [Page 6]
  339.  
  340. RFC 2325                         CP MIB                     1 April 1998
  341.  
  342.  
  343. 8.  Author's Address
  344.  
  345.    Michael Slavitch
  346.    Loran Technologies
  347.    955 Green Valley Crescent
  348.    Ottawa, Ontario Canada K2C 3V4
  349.  
  350.    Phone: 613 723 7505
  351.    EMail: slavitch@loran.com
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394. Slavitch                     Informational                      [Page 7]
  395.  
  396. RFC 2325                         CP MIB                     1 April 1998
  397.  
  398.  
  399. 9.  Full Copyright Statement
  400.  
  401.    Copyright (C) The Internet Society (1998).  All Rights Reserved.
  402.  
  403.    This document and translations of it may be copied and furnished to
  404.    others, and derivative works that comment on or otherwise explain it
  405.    or assist in its implementation may be prepared, copied, published
  406.    and distributed, in whole or in part, without restriction of any
  407.    kind, provided that the above copyright notice and this paragraph are
  408.    included on all such copies and derivative works.  However, this
  409.    document itself may not be modified in any way, such as by removing
  410.    the copyright notice or references to the Internet Society or other
  411.    Internet organizations, except as needed for the purpose of
  412.    developing Internet standards in which case the procedures for
  413.    copyrights defined in the Internet Standards process must be
  414.    followed, or as required to translate it into languages other than
  415.    English.
  416.  
  417.    The limited permissions granted above are perpetual and will not be
  418.    revoked by the Internet Society or its successors or assigns.
  419.  
  420.    This document and the information contained herein is provided on an
  421.    "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
  422.    TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
  423.    BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
  424.    HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
  425.    MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450. Slavitch                     Informational                      [Page 8]
  451.  
  452.