home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / rfc / 3 / rfc2242.txt < prev    next >
Encoding:
Text File  |  2003-06-11  |  10.4 KB  |  340 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                           R. Droms
  8. Request for Comments: 2242                           Bucknell University
  9. Category: Standards Track                                        K. Fong
  10.                                                                   Novell
  11.                                                            November 1997
  12.  
  13.  
  14.  
  15.                  NetWare/IP Domain Name and Information
  16.  
  17.  
  18. Status of this Memo
  19.  
  20.    This document specifies an Internet standards track protocol for the
  21.    Internet community, and requests discussion and suggestions for
  22.    improvements.  Please refer to the current edition of the "Internet
  23.    Official Protocol Standards" (STD 1) for the standardization state
  24.    and status of this protocol.  Distribution of this memo is unlimited.
  25.  
  26. Copyright Notice
  27.  
  28.    Copyright (C) The Internet Society (1997).  All Rights Reserved.
  29.  
  30. 1.0 Abstract
  31.  
  32.    The Dynamic Host Configuration Protocol (DHCP) [RFC 2131] provides a
  33.    framework for passing configuration information to hosts on a TCP/IP
  34.    network. DHCP includes options for specific configuration parameters
  35.    [RFC 2132].  This document defines options that carry NetWare/IP
  36.    domain name and NetWare/IP sub-options to DHCP clients.
  37.  
  38. 1.1 Requirements
  39.  
  40.    The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
  41.    "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" and "OPTIONAL" in this
  42.    document are to be interpreted as described in RFC 2119 [RFC 2119].
  43.  
  44. 1.2 Terminology
  45.  
  46.    This document uses the following terms:
  47.  
  48.       o "DHCP client"
  49.  
  50.         A DHCP client is an Internet host using DHCP to obtain
  51.         configuration parameters such as a network address.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Droms & Fong                Standards Track                     [Page 1]
  59.  
  60. RFC 2242         NetWare/IP Domain Name and Information    November 1997
  61.  
  62.  
  63.       o "DHCP server"
  64.  
  65.         A DHCP server is an Internet host that returns configuration
  66.         parameters to DHCP clients.
  67.  
  68. 2. The NetWare/IP Domain Name option
  69.  
  70.    This option code is used to convey the NetWare/IP domain name used by
  71.    the NetWare/IP product. The NetWare/IP Domain in the option is an NVT
  72.    ASCII [RFC 854] string whose length is inferred from the option 'len'
  73.    field.
  74.  
  75.    The code for this option is 62, and its maximum length is 255.
  76.  
  77.           Code  Len    NetWare/IP Domain Name
  78.         +-----+-----+------+------+------+-----
  79.         |  62 |  n  |  c1  |  c2  |  c3  |  ...
  80.         +-----+-----+------+------+------+-----
  81.  
  82.    The 'len' field gives the length of the NetWare/IP Domain Name.
  83.  
  84. 3. The NetWare/IP Information option
  85.  
  86.    The NetWare/IP option code will be used to convey all the NetWare/IP
  87.    related information except for the NetWare/IP domain name.
  88.  
  89.    The code for this option is 63, and its maximum length is 255. A
  90.    number of NetWare/IP sub-options will be conveyed using this option
  91.    code.  The 'len' field for this option gives the length of the option
  92.    data, which includes the sub-option code, length and data fields.
  93.  
  94.    Each sub-option contains in sequential order, a one byte sub-option
  95.    code, a one byte length, and an optional multiple byte value field.
  96.    The sub-option length gives the length of the value field for the
  97.    sub-option. The example below illustrates the use of the 'len' and
  98.    sub-option length fields in this option.
  99.  
  100.    One and only one of the following four sub-options must be the first
  101.    sub-option to be present in option 63 encoding. Each of them is
  102.    simply a type length pair with length set to zero.
  103.  
  104.    Sub-options:
  105.  
  106.    NWIP_DOES_NOT_EXIST (code 1)
  107.  
  108.       The responding DHCP server does not have any NetWare/IP
  109.       information configured.
  110.  
  111.  
  112.  
  113.  
  114. Droms & Fong                Standards Track                     [Page 2]
  115.  
  116. RFC 2242         NetWare/IP Domain Name and Information    November 1997
  117.  
  118.  
  119.    NWIP_EXIST_IN_OPTIONS_AREA (code 2)
  120.  
  121.       All NetWare/IP information is present in the 'options' area of the
  122.       DHCP response packet.
  123.  
  124.    NWIP_EXIST_IN_SNAME_FILE (code 3)
  125.  
  126.       All NetWare/IP information is present in the 'sname' and, if
  127.       necessary, 'file' fields of the DHCP response packet. If used, the
  128.       following DHCP server behavior is required: within the 'options'
  129.       area, option 63 is present with its length field set to 2. The
  130.       first byte of the value field is set to NWIP_EXIST_IN_SNAME_FILE
  131.       tag and the second byte is set to zero.  Both option 62 and option
  132.       63 will be placed in the area covered by the sname and file
  133.       fields. Option 62 is encoded normally. Option 63 is encoded with
  134.       its tag, length and value. The value field does not contain any of
  135.       the first four sub-options described herein.
  136.  
  137.    NWIP_EXIST_BUT_TOO_BIG (code 4)
  138.  
  139.       Neither 'options' area nor 'sname' field can accommodate the
  140.       NetWare/IP information.
  141.  
  142.    If either NWIP_EXIST_IN_OPTIONS_AREA or NWIP_EXIST_IN_SNAME_FILE
  143.    sub-options is set, one or more of the following sub-options may be
  144.    present.
  145.  
  146.    NSQ_BROADCAST (code 5)
  147.  
  148.       Length is 1 and a value of 1 or 0.  If the value is 1, the client
  149.       SHOULD perform a NetWare Nearest Server Query to find out its
  150.       nearest NetWare/IP server.
  151.  
  152.    PREFERRED_DSS (code 6)
  153.  
  154.       Length is (n * 4) and the value is an array of n IP addresses,
  155.       each four bytes in length. The maximum number of addresses is 5
  156.       and therefore the maximum length value is 20. The list contains
  157.       the addresses of n NetWare Domain SAP/RIP Server (DSS).
  158.  
  159.    NEAREST_NWIP_SERVER (code 7)
  160.  
  161.       Length is (n * 4) and the value is an array of n IP addresses,
  162.       each four bytes in length. The maximum number of addresses is 5
  163.       and therefore the maximum length value is 20. The list contains
  164.       the addresses of n Nearest NetWare/IP servers.
  165.  
  166.  
  167.  
  168.  
  169.  
  170. Droms & Fong                Standards Track                     [Page 3]
  171.  
  172. RFC 2242         NetWare/IP Domain Name and Information    November 1997
  173.  
  174.  
  175.    AUTORETRIES (code 8)
  176.  
  177.       Length is 1 and the value is a one byte integer value indicating
  178.       the number of times a NetWare/IP client should attempt to
  179.       communicate with a given DSS server at startup.
  180.  
  181.    AUTORETRY_SECS (code 9)
  182.  
  183.       Length is 1 and the value is a one byte integer value indicating
  184.       the amount of delay in seconds in between each NetWare/IP client
  185.       attempt to communicate with a given DSS server at startup.
  186.  
  187.    NWIP_1_1 (code 10)
  188.  
  189.       Length is 1 and the value is 1 or 0.  If the value is 1, the
  190.       NetWare/IP client SHOULD support NetWare/IP Version 1.1
  191.       compatibility. A NetWare/IP client only needs this compatibility
  192.       if it will contact a NetWare/IP version 1.1 server.
  193.  
  194.    PRIMARY_DSS (code 11)
  195.  
  196.       Length of 4, and the value is a single IP address.  This field
  197.       identifies the Primary Domain SAP/RIP Service server (DSS) for
  198.       this NetWare/IP domain. NetWare/IP administration utility uses
  199.       this value as Primary DSS server when configuring a secondary DSS
  200.       server.
  201.  
  202.    An example of option 63 encoding is provided below.
  203.  
  204.     Code   Len  NetWare/IP General Info
  205.    +-----+-----+----+----+
  206.    | 63  | 11  | 2  |  0 |
  207.    +-----+-----+----+----+
  208.                 NWIP_EXIST_IN_OPTIONS_AREA (length 0)
  209.  
  210.                +----+----+----+
  211.                |  5 |  1 |  1 |
  212.                +----+----+----+
  213.                 NSQ_BROADCAST_SERVER (length 1)
  214.                 value is YES
  215.  
  216.                +----+----+------------+
  217.                |  7 |  4 | IP address |
  218.                +----+----+------------+
  219.                 NEAREST_NWIP_SERVER (length 4)
  220.                 value is IP address of server
  221.  
  222.  
  223.  
  224.  
  225.  
  226. Droms & Fong                Standards Track                     [Page 4]
  227.  
  228. RFC 2242         NetWare/IP Domain Name and Information    November 1997
  229.  
  230.  
  231. 4. References
  232.  
  233.    [RFC 854] Postel, J. and J. Reynolds, "Telnet Protocol
  234.    Specification", RFC 854, May 1983.
  235.  
  236.    [RFC 2119] Bradner, S., "Key words for use in RFCs to Indicate
  237.    Requirement Levels", RFC 2119, March 1997.
  238.  
  239.    [RFC 2131] Droms, R., "Dynamic Host Configuration Protocol", RFC
  240.    2131, March 1997.
  241.  
  242.    [RFC 2132] Alexander, S. and R. Droms, "DHCP Options and BOOTP Vendor
  243.    Extensions", RFC 2132, March 1997.
  244.  
  245. 5. Security considerations
  246.  
  247.    DHCP currently provides no authentication or security mechanisms.
  248.    Potential exposures to attack are discussed in section 7 of the DHCP
  249.    protocol specification [RFC 2131].
  250.  
  251.    The NetWare/IP options can be used by unauthorized DHCP servers to
  252.    misconfigure NetWare/IP clients with potentially disruptive
  253.    information.
  254.  
  255. 6. Authors' addresses
  256.  
  257.    Ralph Droms
  258.    Computer Science Department
  259.    323 Dana Engineering
  260.    Bucknell University
  261.    Lewisburg, PA 17837
  262.  
  263.    Phone: (717) 524-1145
  264.    EMail: droms@bucknell.edu
  265.  
  266.  
  267.    Kester Fong
  268.    Information Access Division
  269.    Novell Inc.
  270.    SJF-8-265
  271.    2010 Fortune Dr,
  272.    San Jose, CA95131
  273.  
  274.    Phone:(408)-577-8959
  275.    EMail: kfong@novell.com
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282. Droms & Fong                Standards Track                     [Page 5]
  283.  
  284. RFC 2242         NetWare/IP Domain Name and Information    November 1997
  285.  
  286.  
  287. 7.  Full Copyright Statement
  288.  
  289.    Copyright (C) The Internet Society (1997).  All Rights Reserved.
  290.  
  291.    This document and translations of it may be copied and furnished to
  292.    others, and derivative works that comment on or otherwise explain it
  293.    or assist in its implementation may be prepared, copied, published
  294.    and distributed, in whole or in part, without restriction of any
  295.    kind, provided that the above copyright notice and this paragraph are
  296.    included on all such copies and derivative works.  However, this
  297.    document itself may not be modified in any way, such as by removing
  298.    the copyright notice or references to the Internet Society or other
  299.    Internet organizations, except as needed for the purpose of
  300.    developing Internet standards in which case the procedures for
  301.    copyrights defined in the Internet Standards process must be
  302.    followed, or as required to translate it into languages other than
  303.    English.
  304.  
  305.    The limited permissions granted above are perpetual and will not be
  306.    revoked by the Internet Society or its successors or assigns.
  307.  
  308.    This document and the information contained herein is provided on an
  309.    "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
  310.    TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
  311.    BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
  312.    HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
  313.    MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338. Droms & Fong                Standards Track                     [Page 6]
  339.  
  340.