home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_n_r / draft-provan-dhcp-options-dir-serv-01.txt < prev    next >
Text File  |  1997-07-03  |  7KB  |  168 lines
  1.  
  2.                                                               don provan
  3. INTERNET DRAFT                                              Novell, Inc.
  4.                                                              2 July 1997
  5.                                                   Expires 2 January 1998
  6.  
  7.  
  8.                 DHCP Options for Novell Directory Services
  9.                   draft-provan-dhcp-options-dir-serv-01.txt
  10.  
  11.  
  12. Status of this Memo
  13.  
  14.    This document is an Internet-Draft.  Internet Drafts are working
  15.    documents of the Internet Engineering Task Force (IETF), its Areas,
  16.    and its Working Groups.  Note that other groups may also distribute
  17.    working documents as Internet-Drafts.
  18.   
  19.    Internet-Drafts are draft documents valid for a maximum of six
  20.    months, and may be updated, replaced, or obsoleted by other
  21.    documents at any time.  It is not appropriate to use Internet
  22.    Drafts as reference material, or to cite them other than as a
  23.    ``working draft'' or ``work in progress.''
  24.   
  25.    To learn the current status of any Internet-Draft, please check the
  26.    ``1id-abstracts.txt'' listing contained in the internet-drafts
  27.    Shadow Directories on ds.internic.net (US East Coast),
  28.    nic.nordu.net (Europe), ftp.isi.edu (US West Coast), or
  29.    munnari.oz.au (Pacific Rim).
  30.   
  31. Abstract
  32.  
  33.    This document defines three new DHCP options for delivering
  34.    configuration information to clients of the Novell Directory
  35.    Services. The first option carries a list of NDS servers. The
  36.    second option carries the name of the client's NDS tree. The third
  37.    carries the initial NDS context. These three options provide an NDS
  38.    client with enough information to connect to an NDS tree without
  39.    manual configuration of the client.
  40.   
  41. Changes
  42.  
  43.    The original draft of this document called for transmitting NDS's
  44.    Unicode text as 16-bit characters in network byte order. The
  45.    current version of the document changes this to have Unicode text
  46.    transformed into octets using UTF-8.
  47.   
  48. 1. Introduction
  49.  
  50.    Novell Directory Services is a distributed, replicated,
  51.    hierarchical database of objects representing network resources
  52.  
  53. Provan                 Expires 2 January 1998                   [Page 1]
  54.  
  55. INTERNET-DRAFT         DHCP Options for NDS                  2 July 1997
  56.  
  57.    such as nodes, services, users, and applications. An NDS client
  58.    must be able to locate an NDS server in order to authenticate
  59.    itself to the network and gain access to the database. In addition,
  60.    the node's user is better served if the NDS client's attention is
  61.    focused on the area of the NDS database likely to be of the most
  62.    interest to the user.
  63.   
  64.    This specification describes DHCP options [1] that carry NDS
  65.    information to TCP/IP clients of NDS. The first option, the NDS
  66.    Servers Option, carries a list of NDS servers. The other two
  67.    options, the NDS Tree Name Option and the NDS Context Option,
  68.    provide the client with a default context within the NDS database.
  69.   
  70.    The NDS Tree Name Option and the NDS Context Option carry 16-bit
  71.    Unicode text encoded into an octet stream using UTF-8 [3]. A
  72.    complete DHCP implementation can represent of the entire Unicode
  73.    character set supported by NDS. At the same time, 7-bit ASCII text
  74.    is unchanged by the UTF-8 transformation. In environments where the
  75.    NDS tree name and context are restricted to the range of 7-bit
  76.    ASCII characters, ASCII-only DHCP clients and servers can support
  77.    these options by using the ASCII text as the UTF-8 encoded data.
  78.   
  79. 2. NDS Servers Option
  80.  
  81.    This option specifies one or more NDS servers for the client to
  82.    contact for access to the NDS database. Servers SHOULD be listed in
  83.    order of preference.
  84.   
  85.    The code for this option is 85. The minimum length of this option
  86.    is 4 octets, and the length MUST be a multiple of 4.
  87.   
  88.       Code   Len        Address 1               Address 2
  89.      +-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+--
  90.      | 85  |  n  |  a1 |  a2 | a3  |  a4 |  a1 |  a2 |  a3 |  a4 |  ...
  91.      +-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+--
  92.  
  93. 3. NDS Tree Name Option
  94.  
  95.    This option specifies the name of the NDS tree the client will be
  96.    contacting. NDS tree names are 16-bit Unicode strings. For
  97.    transmission in the NDS Tree Name Option, an NDS tree name is
  98.    transformed into octets using UTF-8. The string should NOT be zero
  99.    terminated.
  100.   
  101.    The code for this option is 86. The maximum possible length for
  102.    this option is 255 bytes.
  103.   
  104.        Code Len  NDS Tree Name
  105.       +----+----+----+----+----+----+--
  106.       | 86 | n  | c1 | c2 | c3 | c4 |  ...
  107.       +----+----+----+----+----+----+--
  108.  
  109. Provan                 Expires 2 January 1998                   [Page 2]
  110.  
  111. INTERNET-DRAFT         DHCP Options for NDS                  2 July 1997
  112.  
  113. 4. NDS Context Option
  114.  
  115.    This option specifies the initial NDS context the client should
  116.    use. NDS contexts are 16-bit Unicode strings. For transmission in
  117.    the NDS Context Option, an NDS context is transformed into octets
  118.    using UTF-8. The string should NOT be zero terminated.
  119.   
  120.    A single DHCP option can only contain 255 octets. Since an NDS
  121.    context name can be longer than that, this option can appear more
  122.    than once in the DHCP packet. The contents of all NDS Context
  123.    options in the packet should be concatenated as suggested in the
  124.    DHCP specification [2, page 24] to get the complete NDS context. Be
  125.    aware that a single UTF-8 encoded character could be split between
  126.    two NDS Context Options.
  127.   
  128.    The code for this option is 87. The maximum length for each
  129.    instance of this option is 255, but, as just described, the option
  130.    may appear more than once if the desired NDS context takes up more
  131.    than 255 octets. Implementations are discouraged from enforcing any
  132.    specific maximum to the final concatenated NDS context.
  133.   
  134.        Code Len  Initial NDS Context
  135.       +----+----+----+----+----+----+--
  136.       | 87 | n  | c1 | c2 | c3 | c4 |  ...
  137.       +----+----+----+----+----+----+--
  138.  
  139.  
  140. References
  141.  
  142.    [1] Alexander, S., and R. Droms, "DHCP Options and BOOTP Vendor
  143.        Extensions", RFC-2132, March 1997.
  144.  
  145.    [2] Droms, R., "Dynamic Host Configuration Protocol", RFC-2131,
  146.        March 1997.
  147.  
  148.    [3] Yergeau, F., "UTF-8, a transformation format of Unicode and
  149.        ISO 10646", RFC-2044, October 1996
  150.  
  151.  
  152. Author's Address
  153.  
  154.    Don Provan
  155.    Novell, Inc.
  156.    2180 Fortune Drive
  157.    San Jose, California, 95131
  158.  
  159.    Phone: +1 408 577 8440
  160.  
  161.    EMail: donp@Novell.Com
  162.  
  163.  
  164.  
  165. Provan                 Expires 2 January 1998                   [Page 3]
  166.  
  167.  
  168.