1908 lines
62 KiB
Plaintext
1908 lines
62 KiB
Plaintext
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Network Working Group S. Alexander
|
|||
|
Request for Comments: 2132 Silicon Graphics, Inc.
|
|||
|
Obsoletes: 1533 R. Droms
|
|||
|
Category: Standards Track Bucknell University
|
|||
|
March 1997
|
|||
|
|
|||
|
DHCP Options and BOOTP Vendor Extensions
|
|||
|
|
|||
|
Status of this memo
|
|||
|
|
|||
|
This document specifies an Internet standards track protocol for the
|
|||
|
Internet community, and requests discussion and suggestions for
|
|||
|
improvements. Please refer to the current edition of the "Internet
|
|||
|
Official Protocol Standards" (STD 1) for the standardization state
|
|||
|
and status of this protocol. Distribution of this memo is unlimited.
|
|||
|
|
|||
|
Abstract
|
|||
|
|
|||
|
The Dynamic Host Configuration Protocol (DHCP) [1] provides a
|
|||
|
framework for passing configuration information to hosts on a TCP/IP
|
|||
|
network. Configuration parameters and other control information are
|
|||
|
carried in tagged data items that are stored in the 'options' field
|
|||
|
of the DHCP message. The data items themselves are also called
|
|||
|
"options."
|
|||
|
|
|||
|
This document specifies the current set of DHCP options. Future
|
|||
|
options will be specified in separate RFCs. The current list of
|
|||
|
valid options is also available in ftp://ftp.isi.edu/in-
|
|||
|
notes/iana/assignments [22].
|
|||
|
|
|||
|
All of the vendor information extensions defined in RFC 1497 [2] may
|
|||
|
be used as DHCP options. The definitions given in RFC 1497 are
|
|||
|
included in this document, which supersedes RFC 1497. All of the
|
|||
|
DHCP options defined in this document, except for those specific to
|
|||
|
DHCP as defined in section 9, may be used as BOOTP vendor information
|
|||
|
extensions.
|
|||
|
|
|||
|
Table of Contents
|
|||
|
|
|||
|
1. Introduction .............................................. 2
|
|||
|
2. BOOTP Extension/DHCP Option Field Format .................. 4
|
|||
|
3. RFC 1497 Vendor Extensions ................................ 5
|
|||
|
4. IP Layer Parameters per Host .............................. 11
|
|||
|
5. IP Layer Parameters per Interface ........................ 13
|
|||
|
6. Link Layer Parameters per Interface ....................... 16
|
|||
|
7. TCP Parameters ............................................ 17
|
|||
|
8. Application and Service Parameters ........................ 18
|
|||
|
9. DHCP Extensions ........................................... 25
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 1]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
10. Defining new extensions ................................... 31
|
|||
|
11. Acknowledgements .......................................... 31
|
|||
|
12. References ................................................ 32
|
|||
|
13. Security Considerations ................................... 33
|
|||
|
14. Authors' Addresses ........................................ 34
|
|||
|
|
|||
|
1. Introduction
|
|||
|
|
|||
|
This document specifies options for use with both the Dynamic Host
|
|||
|
Configuration Protocol and the Bootstrap Protocol.
|
|||
|
|
|||
|
The full description of DHCP packet formats may be found in the DHCP
|
|||
|
specification document [1], and the full description of BOOTP packet
|
|||
|
formats may be found in the BOOTP specification document [3]. This
|
|||
|
document defines the format of information in the last field of DHCP
|
|||
|
packets ('options') and of BOOTP packets ('vend'). The remainder of
|
|||
|
this section defines a generalized use of this area for giving
|
|||
|
information useful to a wide class of machines, operating systems and
|
|||
|
configurations. Sites with a single DHCP or BOOTP server that is
|
|||
|
shared among heterogeneous clients may choose to define other, site-
|
|||
|
specific formats for the use of the 'options' field.
|
|||
|
|
|||
|
Section 2 of this memo describes the formats of DHCP options and
|
|||
|
BOOTP vendor extensions. Section 3 describes options defined in
|
|||
|
previous documents for use with BOOTP (all may also be used with
|
|||
|
DHCP). Sections 4-8 define new options intended for use with both
|
|||
|
DHCP and BOOTP. Section 9 defines options used only in DHCP.
|
|||
|
|
|||
|
References further describing most of the options defined in sections
|
|||
|
2-6 can be found in section 12. The use of the options defined in
|
|||
|
section 9 is described in the DHCP specification [1].
|
|||
|
|
|||
|
Information on registering new options is contained in section 10.
|
|||
|
|
|||
|
This document updates the definition of DHCP/BOOTP options that
|
|||
|
appears in RFC1533. The classing mechanism has been extended to
|
|||
|
include vendor classes as described in section 8.4 and 9.13. The new
|
|||
|
procedure for defining new DHCP/BOOTP options in described in section
|
|||
|
10. Several new options, including NIS+ domain and servers, Mobile
|
|||
|
IP home agent, SMTP server, TFTP server and Bootfile server, have
|
|||
|
been added. Text giving definitions used throughout the document has
|
|||
|
been added in section 1.1. Text emphasizing the need for uniqueness
|
|||
|
of client-identifiers has been added to section 9.14.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 2]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
1.1 Requirements
|
|||
|
|
|||
|
Throughout this document, the words that are used to define the
|
|||
|
significance of particular requirements are capitalized. These words
|
|||
|
are:
|
|||
|
|
|||
|
o "MUST"
|
|||
|
|
|||
|
This word or the adjective "REQUIRED" means that the item is an
|
|||
|
absolute requirement of this specification.
|
|||
|
|
|||
|
o "MUST NOT"
|
|||
|
|
|||
|
This phrase means that the item is an absolute prohibition of
|
|||
|
this specification.
|
|||
|
|
|||
|
o "SHOULD"
|
|||
|
|
|||
|
This word or the adjective "RECOMMENDED" means that there may
|
|||
|
exist valid reasons in particular circumstances to ignore this
|
|||
|
item, but the full implications should be understood and the case
|
|||
|
carefully weighed before choosing a different course.
|
|||
|
|
|||
|
o "SHOULD NOT"
|
|||
|
|
|||
|
This phrase means that there may exist valid reasons in
|
|||
|
particular circumstances when the listed behavior is acceptable
|
|||
|
or even useful, but the full implications should be understood
|
|||
|
and the case carefully weighed before implementing any behavior
|
|||
|
described with this label.
|
|||
|
|
|||
|
o "MAY"
|
|||
|
|
|||
|
This word or the adjective "OPTIONAL" means that this item is
|
|||
|
truly optional. One vendor may choose to include the item
|
|||
|
because a particular marketplace requires it or because it
|
|||
|
enhances the product, for example; another vendor may omit the
|
|||
|
same item.
|
|||
|
|
|||
|
1.2 Terminology
|
|||
|
|
|||
|
This document uses the following terms:
|
|||
|
|
|||
|
o "DHCP client"
|
|||
|
|
|||
|
A DHCP client or "client" is an Internet host using DHCP to
|
|||
|
obtain configuration parameters such as a network address.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 3]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
o "DHCP server"
|
|||
|
|
|||
|
A DHCP server of "server"is an Internet host that returns
|
|||
|
configuration parameters to DHCP clients.
|
|||
|
|
|||
|
o "binding"
|
|||
|
|
|||
|
A binding is a collection of configuration parameters, including
|
|||
|
at least an IP address, associated with or "bound to" a DHCP
|
|||
|
client. Bindings are managed by DHCP servers.
|
|||
|
|
|||
|
2. BOOTP Extension/DHCP Option Field Format
|
|||
|
|
|||
|
|
|||
|
DHCP options have the same format as the BOOTP 'vendor extensions'
|
|||
|
defined in RFC 1497 [2]. Options may be fixed length or variable
|
|||
|
length. All options begin with a tag octet, which uniquely
|
|||
|
identifies the option. Fixed-length options without data consist of
|
|||
|
only a tag octet. Only options 0 and 255 are fixed length. All
|
|||
|
other options are variable-length with a length octet following the
|
|||
|
tag octet. The value of the length octet does not include the two
|
|||
|
octets specifying the tag and length. The length octet is followed
|
|||
|
by "length" octets of data. Options containing NVT ASCII data SHOULD
|
|||
|
NOT include a trailing NULL; however, the receiver of such options
|
|||
|
MUST be prepared to delete trailing nulls if they exist. The
|
|||
|
receiver MUST NOT require that a trailing null be included in the
|
|||
|
data. In the case of some variable-length options the length field
|
|||
|
is a constant but must still be specified.
|
|||
|
|
|||
|
Any options defined subsequent to this document MUST contain a length
|
|||
|
octet even if the length is fixed or zero.
|
|||
|
|
|||
|
All multi-octet quantities are in network byte-order.
|
|||
|
|
|||
|
When used with BOOTP, the first four octets of the vendor information
|
|||
|
field have been assigned to the "magic cookie" (as suggested in RFC
|
|||
|
951). This field identifies the mode in which the succeeding data is
|
|||
|
to be interpreted. The value of the magic cookie is the 4 octet
|
|||
|
dotted decimal 99.130.83.99 (or hexadecimal number 63.82.53.63) in
|
|||
|
network byte order.
|
|||
|
|
|||
|
All of the "vendor extensions" defined in RFC 1497 are also DHCP
|
|||
|
options.
|
|||
|
|
|||
|
Option codes 128 to 254 (decimal) are reserved for site-specific
|
|||
|
options.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 4]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
Except for the options in section 9, all options may be used with
|
|||
|
either DHCP or BOOTP.
|
|||
|
|
|||
|
Many of these options have their default values specified in other
|
|||
|
documents. In particular, RFC 1122 [4] specifies default values for
|
|||
|
most IP and TCP configuration parameters.
|
|||
|
|
|||
|
Many options supply one or more 32-bit IP address. Use of IP
|
|||
|
addresses rather than fully-qualified Domain Names (FQDNs) may make
|
|||
|
future renumbering of IP hosts more difficult. Use of these
|
|||
|
addresses is discouraged at sites that may require renumbering.
|
|||
|
|
|||
|
3. RFC 1497 Vendor Extensions
|
|||
|
|
|||
|
This section lists the vendor extensions as defined in RFC 1497.
|
|||
|
They are defined here for completeness.
|
|||
|
|
|||
|
3.1. Pad Option
|
|||
|
|
|||
|
The pad option can be used to cause subsequent fields to align on
|
|||
|
word boundaries.
|
|||
|
|
|||
|
The code for the pad option is 0, and its length is 1 octet.
|
|||
|
|
|||
|
Code
|
|||
|
+-----+
|
|||
|
| 0 |
|
|||
|
+-----+
|
|||
|
|
|||
|
3.2. End Option
|
|||
|
|
|||
|
The end option marks the end of valid information in the vendor
|
|||
|
field. Subsequent octets should be filled with pad options.
|
|||
|
|
|||
|
The code for the end option is 255, and its length is 1 octet.
|
|||
|
|
|||
|
Code
|
|||
|
+-----+
|
|||
|
| 255 |
|
|||
|
+-----+
|
|||
|
|
|||
|
3.3. Subnet Mask
|
|||
|
|
|||
|
The subnet mask option specifies the client's subnet mask as per RFC
|
|||
|
950 [5].
|
|||
|
|
|||
|
If both the subnet mask and the router option are specified in a DHCP
|
|||
|
reply, the subnet mask option MUST be first.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 5]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
The code for the subnet mask option is 1, and its length is 4 octets.
|
|||
|
|
|||
|
Code Len Subnet Mask
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
| 1 | 4 | m1 | m2 | m3 | m4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
3.4. Time Offset
|
|||
|
|
|||
|
The time offset field specifies the offset of the client's subnet in
|
|||
|
seconds from Coordinated Universal Time (UTC). The offset is
|
|||
|
expressed as a two's complement 32-bit integer. A positive offset
|
|||
|
indicates a location east of the zero meridian and a negative offset
|
|||
|
indicates a location west of the zero meridian.
|
|||
|
|
|||
|
The code for the time offset option is 2, and its length is 4 octets.
|
|||
|
|
|||
|
Code Len Time Offset
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
| 2 | 4 | n1 | n2 | n3 | n4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
3.5. Router Option
|
|||
|
|
|||
|
The router option specifies a list of IP addresses for routers on the
|
|||
|
client's subnet. Routers SHOULD be listed in order of preference.
|
|||
|
|
|||
|
The code for the router option is 3. The minimum length for the
|
|||
|
router option is 4 octets, and the length MUST always be a multiple
|
|||
|
of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 3 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
3.6. Time Server Option
|
|||
|
|
|||
|
The time server option specifies a list of RFC 868 [6] time servers
|
|||
|
available to the client. Servers SHOULD be listed in order of
|
|||
|
preference.
|
|||
|
|
|||
|
The code for the time server option is 4. The minimum length for
|
|||
|
this option is 4 octets, and the length MUST always be a multiple of
|
|||
|
4.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 6]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 4 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
3.7. Name Server Option
|
|||
|
|
|||
|
The name server option specifies a list of IEN 116 [7] name servers
|
|||
|
available to the client. Servers SHOULD be listed in order of
|
|||
|
preference.
|
|||
|
|
|||
|
The code for the name server option is 5. The minimum length for
|
|||
|
this option is 4 octets, and the length MUST always be a multiple of
|
|||
|
4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 5 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
3.8. Domain Name Server Option
|
|||
|
|
|||
|
The domain name server option specifies a list of Domain Name System
|
|||
|
(STD 13, RFC 1035 [8]) name servers available to the client. Servers
|
|||
|
SHOULD be listed in order of preference.
|
|||
|
|
|||
|
The code for the domain name server option is 6. The minimum length
|
|||
|
for this option is 4 octets, and the length MUST always be a multiple
|
|||
|
of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 6 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
3.9. Log Server Option
|
|||
|
|
|||
|
The log server option specifies a list of MIT-LCS UDP log servers
|
|||
|
available to the client. Servers SHOULD be listed in order of
|
|||
|
preference.
|
|||
|
|
|||
|
The code for the log server option is 7. The minimum length for this
|
|||
|
option is 4 octets, and the length MUST always be a multiple of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 7 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 7]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
3.10. Cookie Server Option
|
|||
|
|
|||
|
The cookie server option specifies a list of RFC 865 [9] cookie
|
|||
|
servers available to the client. Servers SHOULD be listed in order
|
|||
|
of preference.
|
|||
|
|
|||
|
The code for the log server option is 8. The minimum length for this
|
|||
|
option is 4 octets, and the length MUST always be a multiple of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 8 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
3.11. LPR Server Option
|
|||
|
|
|||
|
The LPR server option specifies a list of RFC 1179 [10] line printer
|
|||
|
servers available to the client. Servers SHOULD be listed in order
|
|||
|
of preference.
|
|||
|
|
|||
|
The code for the LPR server option is 9. The minimum length for this
|
|||
|
option is 4 octets, and the length MUST always be a multiple of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 9 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
3.12. Impress Server Option
|
|||
|
|
|||
|
The Impress server option specifies a list of Imagen Impress servers
|
|||
|
available to the client. Servers SHOULD be listed in order of
|
|||
|
preference.
|
|||
|
|
|||
|
The code for the Impress server option is 10. The minimum length for
|
|||
|
this option is 4 octets, and the length MUST always be a multiple of
|
|||
|
4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 10 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
3.13. Resource Location Server Option
|
|||
|
|
|||
|
This option specifies a list of RFC 887 [11] Resource Location
|
|||
|
servers available to the client. Servers SHOULD be listed in order
|
|||
|
of preference.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 8]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
The code for this option is 11. The minimum length for this option
|
|||
|
is 4 octets, and the length MUST always be a multiple of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 11 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
3.14. Host Name Option
|
|||
|
|
|||
|
This option specifies the name of the client. The name may or may
|
|||
|
not be qualified with the local domain name (see section 3.17 for the
|
|||
|
preferred way to retrieve the domain name). See RFC 1035 for
|
|||
|
character set restrictions.
|
|||
|
|
|||
|
The code for this option is 12, and its minimum length is 1.
|
|||
|
|
|||
|
Code Len Host Name
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 12 | n | h1 | h2 | h3 | h4 | h5 | h6 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
3.15. Boot File Size Option
|
|||
|
|
|||
|
This option specifies the length in 512-octet blocks of the default
|
|||
|
boot image for the client. The file length is specified as an
|
|||
|
unsigned 16-bit integer.
|
|||
|
|
|||
|
The code for this option is 13, and its length is 2.
|
|||
|
|
|||
|
Code Len File Size
|
|||
|
+-----+-----+-----+-----+
|
|||
|
| 13 | 2 | l1 | l2 |
|
|||
|
+-----+-----+-----+-----+
|
|||
|
|
|||
|
3.16. Merit Dump File
|
|||
|
|
|||
|
This option specifies the path-name of a file to which the client's
|
|||
|
core image should be dumped in the event the client crashes. The
|
|||
|
path is formatted as a character string consisting of characters from
|
|||
|
the NVT ASCII character set.
|
|||
|
|
|||
|
The code for this option is 14. Its minimum length is 1.
|
|||
|
|
|||
|
Code Len Dump File Pathname
|
|||
|
+-----+-----+-----+-----+-----+-----+---
|
|||
|
| 14 | n | n1 | n2 | n3 | n4 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+---
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 9]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
3.17. Domain Name
|
|||
|
|
|||
|
This option specifies the domain name that client should use when
|
|||
|
resolving hostnames via the Domain Name System.
|
|||
|
|
|||
|
The code for this option is 15. Its minimum length is 1.
|
|||
|
|
|||
|
Code Len Domain Name
|
|||
|
+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 15 | n | d1 | d2 | d3 | d4 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
3.18. Swap Server
|
|||
|
|
|||
|
This specifies the IP address of the client's swap server.
|
|||
|
|
|||
|
The code for this option is 16 and its length is 4.
|
|||
|
|
|||
|
Code Len Swap Server Address
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
| 16 | n | a1 | a2 | a3 | a4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
3.19. Root Path
|
|||
|
|
|||
|
This option specifies the path-name that contains the client's root
|
|||
|
disk. The path is formatted as a character string consisting of
|
|||
|
characters from the NVT ASCII character set.
|
|||
|
|
|||
|
The code for this option is 17. Its minimum length is 1.
|
|||
|
|
|||
|
Code Len Root Disk Pathname
|
|||
|
+-----+-----+-----+-----+-----+-----+---
|
|||
|
| 17 | n | n1 | n2 | n3 | n4 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+---
|
|||
|
|
|||
|
3.20. Extensions Path
|
|||
|
|
|||
|
A string to specify a file, retrievable via TFTP, which contains
|
|||
|
information which can be interpreted in the same way as the 64-octet
|
|||
|
vendor-extension field within the BOOTP response, with the following
|
|||
|
exceptions:
|
|||
|
|
|||
|
- the length of the file is unconstrained;
|
|||
|
- all references to Tag 18 (i.e., instances of the
|
|||
|
BOOTP Extensions Path field) within the file are
|
|||
|
ignored.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 10]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
The code for this option is 18. Its minimum length is 1.
|
|||
|
|
|||
|
Code Len Extensions Pathname
|
|||
|
+-----+-----+-----+-----+-----+-----+---
|
|||
|
| 18 | n | n1 | n2 | n3 | n4 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+---
|
|||
|
|
|||
|
4. IP Layer Parameters per Host
|
|||
|
|
|||
|
This section details the options that affect the operation of the IP
|
|||
|
layer on a per-host basis.
|
|||
|
|
|||
|
4.1. IP Forwarding Enable/Disable Option
|
|||
|
|
|||
|
This option specifies whether the client should configure its IP
|
|||
|
layer for packet forwarding. A value of 0 means disable IP
|
|||
|
forwarding, and a value of 1 means enable IP forwarding.
|
|||
|
|
|||
|
The code for this option is 19, and its length is 1.
|
|||
|
|
|||
|
Code Len Value
|
|||
|
+-----+-----+-----+
|
|||
|
| 19 | 1 | 0/1 |
|
|||
|
+-----+-----+-----+
|
|||
|
|
|||
|
4.2. Non-Local Source Routing Enable/Disable Option
|
|||
|
|
|||
|
This option specifies whether the client should configure its IP
|
|||
|
layer to allow forwarding of datagrams with non-local source routes
|
|||
|
(see Section 3.3.5 of [4] for a discussion of this topic). A value
|
|||
|
of 0 means disallow forwarding of such datagrams, and a value of 1
|
|||
|
means allow forwarding.
|
|||
|
|
|||
|
The code for this option is 20, and its length is 1.
|
|||
|
|
|||
|
Code Len Value
|
|||
|
+-----+-----+-----+
|
|||
|
| 20 | 1 | 0/1 |
|
|||
|
+-----+-----+-----+
|
|||
|
|
|||
|
4.3. Policy Filter Option
|
|||
|
|
|||
|
This option specifies policy filters for non-local source routing.
|
|||
|
The filters consist of a list of IP addresses and masks which specify
|
|||
|
destination/mask pairs with which to filter incoming source routes.
|
|||
|
|
|||
|
Any source routed datagram whose next-hop address does not match one
|
|||
|
of the filters should be discarded by the client.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 11]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
See [4] for further information.
|
|||
|
|
|||
|
The code for this option is 21. The minimum length of this option is
|
|||
|
8, and the length MUST be a multiple of 8.
|
|||
|
|
|||
|
Code Len Address 1 Mask 1
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|||
|
| 21 | n | a1 | a2 | a3 | a4 | m1 | m2 | m3 | m4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|||
|
Address 2 Mask 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+---
|
|||
|
| a1 | a2 | a3 | a4 | m1 | m2 | m3 | m4 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+---
|
|||
|
|
|||
|
4.4. Maximum Datagram Reassembly Size
|
|||
|
|
|||
|
This option specifies the maximum size datagram that the client
|
|||
|
should be prepared to reassemble. The size is specified as a 16-bit
|
|||
|
unsigned integer. The minimum value legal value is 576.
|
|||
|
|
|||
|
The code for this option is 22, and its length is 2.
|
|||
|
|
|||
|
Code Len Size
|
|||
|
+-----+-----+-----+-----+
|
|||
|
| 22 | 2 | s1 | s2 |
|
|||
|
+-----+-----+-----+-----+
|
|||
|
|
|||
|
4.5. Default IP Time-to-live
|
|||
|
|
|||
|
This option specifies the default time-to-live that the client should
|
|||
|
use on outgoing datagrams. The TTL is specified as an octet with a
|
|||
|
value between 1 and 255.
|
|||
|
|
|||
|
The code for this option is 23, and its length is 1.
|
|||
|
|
|||
|
Code Len TTL
|
|||
|
+-----+-----+-----+
|
|||
|
| 23 | 1 | ttl |
|
|||
|
+-----+-----+-----+
|
|||
|
|
|||
|
4.6. Path MTU Aging Timeout Option
|
|||
|
|
|||
|
This option specifies the timeout (in seconds) to use when aging Path
|
|||
|
MTU values discovered by the mechanism defined in RFC 1191 [12]. The
|
|||
|
timeout is specified as a 32-bit unsigned integer.
|
|||
|
|
|||
|
The code for this option is 24, and its length is 4.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 12]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
Code Len Timeout
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
| 24 | 4 | t1 | t2 | t3 | t4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
4.7. Path MTU Plateau Table Option
|
|||
|
|
|||
|
This option specifies a table of MTU sizes to use when performing
|
|||
|
Path MTU Discovery as defined in RFC 1191. The table is formatted as
|
|||
|
a list of 16-bit unsigned integers, ordered from smallest to largest.
|
|||
|
The minimum MTU value cannot be smaller than 68.
|
|||
|
|
|||
|
The code for this option is 25. Its minimum length is 2, and the
|
|||
|
length MUST be a multiple of 2.
|
|||
|
|
|||
|
Code Len Size 1 Size 2
|
|||
|
+-----+-----+-----+-----+-----+-----+---
|
|||
|
| 25 | n | s1 | s2 | s1 | s2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+---
|
|||
|
|
|||
|
5. IP Layer Parameters per Interface
|
|||
|
|
|||
|
This section details the options that affect the operation of the IP
|
|||
|
layer on a per-interface basis. It is expected that a client can
|
|||
|
issue multiple requests, one per interface, in order to configure
|
|||
|
interfaces with their specific parameters.
|
|||
|
|
|||
|
5.1. Interface MTU Option
|
|||
|
|
|||
|
This option specifies the MTU to use on this interface. The MTU is
|
|||
|
specified as a 16-bit unsigned integer. The minimum legal value for
|
|||
|
the MTU is 68.
|
|||
|
|
|||
|
The code for this option is 26, and its length is 2.
|
|||
|
|
|||
|
Code Len MTU
|
|||
|
+-----+-----+-----+-----+
|
|||
|
| 26 | 2 | m1 | m2 |
|
|||
|
+-----+-----+-----+-----+
|
|||
|
|
|||
|
5.2. All Subnets are Local Option
|
|||
|
|
|||
|
This option specifies whether or not the client may assume that all
|
|||
|
subnets of the IP network to which the client is connected use the
|
|||
|
same MTU as the subnet of that network to which the client is
|
|||
|
directly connected. A value of 1 indicates that all subnets share
|
|||
|
the same MTU. A value of 0 means that the client should assume that
|
|||
|
some subnets of the directly connected network may have smaller MTUs.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 13]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
The code for this option is 27, and its length is 1.
|
|||
|
|
|||
|
Code Len Value
|
|||
|
+-----+-----+-----+
|
|||
|
| 27 | 1 | 0/1 |
|
|||
|
+-----+-----+-----+
|
|||
|
|
|||
|
5.3. Broadcast Address Option
|
|||
|
|
|||
|
This option specifies the broadcast address in use on the client's
|
|||
|
subnet. Legal values for broadcast addresses are specified in
|
|||
|
section 3.2.1.3 of [4].
|
|||
|
|
|||
|
The code for this option is 28, and its length is 4.
|
|||
|
|
|||
|
Code Len Broadcast Address
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
| 28 | 4 | b1 | b2 | b3 | b4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
5.4. Perform Mask Discovery Option
|
|||
|
|
|||
|
This option specifies whether or not the client should perform subnet
|
|||
|
mask discovery using ICMP. A value of 0 indicates that the client
|
|||
|
should not perform mask discovery. A value of 1 means that the
|
|||
|
client should perform mask discovery.
|
|||
|
|
|||
|
The code for this option is 29, and its length is 1.
|
|||
|
|
|||
|
Code Len Value
|
|||
|
+-----+-----+-----+
|
|||
|
| 29 | 1 | 0/1 |
|
|||
|
+-----+-----+-----+
|
|||
|
|
|||
|
5.5. Mask Supplier Option
|
|||
|
|
|||
|
This option specifies whether or not the client should respond to
|
|||
|
subnet mask requests using ICMP. A value of 0 indicates that the
|
|||
|
client should not respond. A value of 1 means that the client should
|
|||
|
respond.
|
|||
|
|
|||
|
The code for this option is 30, and its length is 1.
|
|||
|
|
|||
|
Code Len Value
|
|||
|
+-----+-----+-----+
|
|||
|
| 30 | 1 | 0/1 |
|
|||
|
+-----+-----+-----+
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 14]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
5.6. Perform Router Discovery Option
|
|||
|
|
|||
|
This option specifies whether or not the client should solicit
|
|||
|
routers using the Router Discovery mechanism defined in RFC 1256
|
|||
|
[13]. A value of 0 indicates that the client should not perform
|
|||
|
router discovery. A value of 1 means that the client should perform
|
|||
|
router discovery.
|
|||
|
|
|||
|
The code for this option is 31, and its length is 1.
|
|||
|
|
|||
|
Code Len Value
|
|||
|
+-----+-----+-----+
|
|||
|
| 31 | 1 | 0/1 |
|
|||
|
+-----+-----+-----+
|
|||
|
|
|||
|
5.7. Router Solicitation Address Option
|
|||
|
|
|||
|
This option specifies the address to which the client should transmit
|
|||
|
router solicitation requests.
|
|||
|
|
|||
|
The code for this option is 32, and its length is 4.
|
|||
|
|
|||
|
Code Len Address
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
| 32 | 4 | a1 | a2 | a3 | a4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
5.8. Static Route Option
|
|||
|
|
|||
|
This option specifies a list of static routes that the client should
|
|||
|
install in its routing cache. If multiple routes to the same
|
|||
|
destination are specified, they are listed in descending order of
|
|||
|
priority.
|
|||
|
|
|||
|
The routes consist of a list of IP address pairs. The first address
|
|||
|
is the destination address, and the second address is the router for
|
|||
|
the destination.
|
|||
|
|
|||
|
The default route (0.0.0.0) is an illegal destination for a static
|
|||
|
route. See section 3.5 for information about the router option.
|
|||
|
|
|||
|
The code for this option is 33. The minimum length of this option is
|
|||
|
8, and the length MUST be a multiple of 8.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 15]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
Code Len Destination 1 Router 1
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|||
|
| 33 | n | d1 | d2 | d3 | d4 | r1 | r2 | r3 | r4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|||
|
Destination 2 Router 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+---
|
|||
|
| d1 | d2 | d3 | d4 | r1 | r2 | r3 | r4 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+---
|
|||
|
|
|||
|
6. Link Layer Parameters per Interface
|
|||
|
|
|||
|
This section lists the options that affect the operation of the data
|
|||
|
link layer on a per-interface basis.
|
|||
|
|
|||
|
6.1. Trailer Encapsulation Option
|
|||
|
|
|||
|
This option specifies whether or not the client should negotiate the
|
|||
|
use of trailers (RFC 893 [14]) when using the ARP protocol. A value
|
|||
|
of 0 indicates that the client should not attempt to use trailers. A
|
|||
|
value of 1 means that the client should attempt to use trailers.
|
|||
|
|
|||
|
The code for this option is 34, and its length is 1.
|
|||
|
|
|||
|
Code Len Value
|
|||
|
+-----+-----+-----+
|
|||
|
| 34 | 1 | 0/1 |
|
|||
|
+-----+-----+-----+
|
|||
|
|
|||
|
6.2. ARP Cache Timeout Option
|
|||
|
|
|||
|
This option specifies the timeout in seconds for ARP cache entries.
|
|||
|
The time is specified as a 32-bit unsigned integer.
|
|||
|
|
|||
|
The code for this option is 35, and its length is 4.
|
|||
|
|
|||
|
Code Len Time
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
| 35 | 4 | t1 | t2 | t3 | t4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
6.3. Ethernet Encapsulation Option
|
|||
|
|
|||
|
This option specifies whether or not the client should use Ethernet
|
|||
|
Version 2 (RFC 894 [15]) or IEEE 802.3 (RFC 1042 [16]) encapsulation
|
|||
|
if the interface is an Ethernet. A value of 0 indicates that the
|
|||
|
client should use RFC 894 encapsulation. A value of 1 means that the
|
|||
|
client should use RFC 1042 encapsulation.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 16]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
The code for this option is 36, and its length is 1.
|
|||
|
|
|||
|
Code Len Value
|
|||
|
+-----+-----+-----+
|
|||
|
| 36 | 1 | 0/1 |
|
|||
|
+-----+-----+-----+
|
|||
|
|
|||
|
7. TCP Parameters
|
|||
|
|
|||
|
This section lists the options that affect the operation of the TCP
|
|||
|
layer on a per-interface basis.
|
|||
|
|
|||
|
7.1. TCP Default TTL Option
|
|||
|
|
|||
|
This option specifies the default TTL that the client should use when
|
|||
|
sending TCP segments. The value is represented as an 8-bit unsigned
|
|||
|
integer. The minimum value is 1.
|
|||
|
|
|||
|
The code for this option is 37, and its length is 1.
|
|||
|
|
|||
|
Code Len TTL
|
|||
|
+-----+-----+-----+
|
|||
|
| 37 | 1 | n |
|
|||
|
+-----+-----+-----+
|
|||
|
|
|||
|
7.2. TCP Keepalive Interval Option
|
|||
|
|
|||
|
This option specifies the interval (in seconds) that the client TCP
|
|||
|
should wait before sending a keepalive message on a TCP connection.
|
|||
|
The time is specified as a 32-bit unsigned integer. A value of zero
|
|||
|
indicates that the client should not generate keepalive messages on
|
|||
|
connections unless specifically requested by an application.
|
|||
|
|
|||
|
The code for this option is 38, and its length is 4.
|
|||
|
|
|||
|
Code Len Time
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
| 38 | 4 | t1 | t2 | t3 | t4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
7.3. TCP Keepalive Garbage Option
|
|||
|
|
|||
|
This option specifies the whether or not the client should send TCP
|
|||
|
keepalive messages with a octet of garbage for compatibility with
|
|||
|
older implementations. A value of 0 indicates that a garbage octet
|
|||
|
should not be sent. A value of 1 indicates that a garbage octet
|
|||
|
should be sent.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 17]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
The code for this option is 39, and its length is 1.
|
|||
|
|
|||
|
Code Len Value
|
|||
|
+-----+-----+-----+
|
|||
|
| 39 | 1 | 0/1 |
|
|||
|
+-----+-----+-----+
|
|||
|
|
|||
|
8. Application and Service Parameters
|
|||
|
|
|||
|
This section details some miscellaneous options used to configure
|
|||
|
miscellaneous applications and services.
|
|||
|
|
|||
|
8.1. Network Information Service Domain Option
|
|||
|
|
|||
|
This option specifies the name of the client's NIS [17] domain. The
|
|||
|
domain is formatted as a character string consisting of characters
|
|||
|
from the NVT ASCII character set.
|
|||
|
|
|||
|
The code for this option is 40. Its minimum length is 1.
|
|||
|
|
|||
|
Code Len NIS Domain Name
|
|||
|
+-----+-----+-----+-----+-----+-----+---
|
|||
|
| 40 | n | n1 | n2 | n3 | n4 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+---
|
|||
|
|
|||
|
8.2. Network Information Servers Option
|
|||
|
|
|||
|
This option specifies a list of IP addresses indicating NIS servers
|
|||
|
available to the client. Servers SHOULD be listed in order of
|
|||
|
preference.
|
|||
|
|
|||
|
The code for this option is 41. Its minimum length is 4, and the
|
|||
|
length MUST be a multiple of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 41 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
8.3. Network Time Protocol Servers Option
|
|||
|
|
|||
|
This option specifies a list of IP addresses indicating NTP [18]
|
|||
|
servers available to the client. Servers SHOULD be listed in order
|
|||
|
of preference.
|
|||
|
|
|||
|
The code for this option is 42. Its minimum length is 4, and the
|
|||
|
length MUST be a multiple of 4.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 18]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 42 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
8.4. Vendor Specific Information
|
|||
|
|
|||
|
This option is used by clients and servers to exchange vendor-
|
|||
|
specific information. The information is an opaque object of n
|
|||
|
octets, presumably interpreted by vendor-specific code on the clients
|
|||
|
and servers. The definition of this information is vendor specific.
|
|||
|
The vendor is indicated in the vendor class identifier option.
|
|||
|
Servers not equipped to interpret the vendor-specific information
|
|||
|
sent by a client MUST ignore it (although it may be reported).
|
|||
|
Clients which do not receive desired vendor-specific information
|
|||
|
SHOULD make an attempt to operate without it, although they may do so
|
|||
|
(and announce they are doing so) in a degraded mode.
|
|||
|
|
|||
|
If a vendor potentially encodes more than one item of information in
|
|||
|
this option, then the vendor SHOULD encode the option using
|
|||
|
"Encapsulated vendor-specific options" as described below:
|
|||
|
|
|||
|
The Encapsulated vendor-specific options field SHOULD be encoded as a
|
|||
|
sequence of code/length/value fields of identical syntax to the DHCP
|
|||
|
options field with the following exceptions:
|
|||
|
|
|||
|
1) There SHOULD NOT be a "magic cookie" field in the encapsulated
|
|||
|
vendor-specific extensions field.
|
|||
|
|
|||
|
2) Codes other than 0 or 255 MAY be redefined by the vendor within
|
|||
|
the encapsulated vendor-specific extensions field, but SHOULD
|
|||
|
conform to the tag-length-value syntax defined in section 2.
|
|||
|
|
|||
|
3) Code 255 (END), if present, signifies the end of the
|
|||
|
encapsulated vendor extensions, not the end of the vendor
|
|||
|
extensions field. If no code 255 is present, then the end of
|
|||
|
the enclosing vendor-specific information field is taken as the
|
|||
|
end of the encapsulated vendor-specific extensions field.
|
|||
|
|
|||
|
The code for this option is 43 and its minimum length is 1.
|
|||
|
|
|||
|
Code Len Vendor-specific information
|
|||
|
+-----+-----+-----+-----+---
|
|||
|
| 43 | n | i1 | i2 | ...
|
|||
|
+-----+-----+-----+-----+---
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 19]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
When encapsulated vendor-specific extensions are used, the
|
|||
|
information bytes 1-n have the following format:
|
|||
|
|
|||
|
Code Len Data item Code Len Data item Code
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|||
|
| T1 | n | d1 | d2 | ... | T2 | n | D1 | D2 | ... | ... |
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
8.5. NetBIOS over TCP/IP Name Server Option
|
|||
|
|
|||
|
The NetBIOS name server (NBNS) option specifies a list of RFC
|
|||
|
1001/1002 [19] [20] NBNS name servers listed in order of preference.
|
|||
|
|
|||
|
The code for this option is 44. The minimum length of the option is
|
|||
|
4 octets, and the length must always be a multiple of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+----
|
|||
|
| 44 | n | a1 | a2 | a3 | a4 | b1 | b2 | b3 | b4 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+----
|
|||
|
|
|||
|
8.6. NetBIOS over TCP/IP Datagram Distribution Server Option
|
|||
|
|
|||
|
The NetBIOS datagram distribution server (NBDD) option specifies a
|
|||
|
list of RFC 1001/1002 NBDD servers listed in order of preference. The
|
|||
|
code for this option is 45. The minimum length of the option is 4
|
|||
|
octets, and the length must always be a multiple of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+----
|
|||
|
| 45 | n | a1 | a2 | a3 | a4 | b1 | b2 | b3 | b4 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+----
|
|||
|
|
|||
|
8.7. NetBIOS over TCP/IP Node Type Option
|
|||
|
|
|||
|
The NetBIOS node type option allows NetBIOS over TCP/IP clients which
|
|||
|
are configurable to be configured as described in RFC 1001/1002. The
|
|||
|
value is specified as a single octet which identifies the client type
|
|||
|
as follows:
|
|||
|
|
|||
|
Value Node Type
|
|||
|
----- ---------
|
|||
|
0x1 B-node
|
|||
|
0x2 P-node
|
|||
|
0x4 M-node
|
|||
|
0x8 H-node
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 20]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
In the above chart, the notation '0x' indicates a number in base-16
|
|||
|
(hexadecimal).
|
|||
|
|
|||
|
The code for this option is 46. The length of this option is always
|
|||
|
1.
|
|||
|
|
|||
|
Code Len Node Type
|
|||
|
+-----+-----+-----------+
|
|||
|
| 46 | 1 | see above |
|
|||
|
+-----+-----+-----------+
|
|||
|
|
|||
|
8.8. NetBIOS over TCP/IP Scope Option
|
|||
|
|
|||
|
The NetBIOS scope option specifies the NetBIOS over TCP/IP scope
|
|||
|
parameter for the client as specified in RFC 1001/1002. See [19],
|
|||
|
[20], and [8] for character-set restrictions.
|
|||
|
|
|||
|
The code for this option is 47. The minimum length of this option is
|
|||
|
1.
|
|||
|
|
|||
|
Code Len NetBIOS Scope
|
|||
|
+-----+-----+-----+-----+-----+-----+----
|
|||
|
| 47 | n | s1 | s2 | s3 | s4 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+----
|
|||
|
|
|||
|
8.9. X Window System Font Server Option
|
|||
|
|
|||
|
This option specifies a list of X Window System [21] Font servers
|
|||
|
available to the client. Servers SHOULD be listed in order of
|
|||
|
preference.
|
|||
|
|
|||
|
The code for this option is 48. The minimum length of this option is
|
|||
|
4 octets, and the length MUST be a multiple of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+---
|
|||
|
| 48 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+---
|
|||
|
|
|||
|
8.10. X Window System Display Manager Option
|
|||
|
|
|||
|
This option specifies a list of IP addresses of systems that are
|
|||
|
running the X Window System Display Manager and are available to the
|
|||
|
client.
|
|||
|
|
|||
|
Addresses SHOULD be listed in order of preference.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 21]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
The code for the this option is 49. The minimum length of this option
|
|||
|
is 4, and the length MUST be a multiple of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+---
|
|||
|
| 49 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+---
|
|||
|
|
|||
|
8.11. Network Information Service+ Domain Option
|
|||
|
|
|||
|
This option specifies the name of the client's NIS+ [17] domain. The
|
|||
|
domain is formatted as a character string consisting of characters
|
|||
|
from the NVT ASCII character set.
|
|||
|
|
|||
|
The code for this option is 64. Its minimum length is 1.
|
|||
|
|
|||
|
Code Len NIS Client Domain Name
|
|||
|
+-----+-----+-----+-----+-----+-----+---
|
|||
|
| 64 | n | n1 | n2 | n3 | n4 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+---
|
|||
|
|
|||
|
8.12. Network Information Service+ Servers Option
|
|||
|
|
|||
|
This option specifies a list of IP addresses indicating NIS+ servers
|
|||
|
available to the client. Servers SHOULD be listed in order of
|
|||
|
preference.
|
|||
|
|
|||
|
The code for this option is 65. Its minimum length is 4, and the
|
|||
|
length MUST be a multiple of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 65 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
8.13. Mobile IP Home Agent option
|
|||
|
|
|||
|
This option specifies a list of IP addresses indicating mobile IP
|
|||
|
home agents available to the client. Agents SHOULD be listed in
|
|||
|
order of preference.
|
|||
|
|
|||
|
The code for this option is 68. Its minimum length is 0 (indicating
|
|||
|
no home agents are available) and the length MUST be a multiple of 4.
|
|||
|
It is expected that the usual length will be four octets, containing
|
|||
|
a single home agent's address.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 22]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
Code Len Home Agent Addresses (zero or more)
|
|||
|
+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 68 | n | a1 | a2 | a3 | a4 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
8.14. Simple Mail Transport Protocol (SMTP) Server Option
|
|||
|
|
|||
|
The SMTP server option specifies a list of SMTP servers available to
|
|||
|
the client. Servers SHOULD be listed in order of preference.
|
|||
|
|
|||
|
The code for the SMTP server option is 69. The minimum length for
|
|||
|
this option is 4 octets, and the length MUST always be a multiple of
|
|||
|
4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 69 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
8.15. Post Office Protocol (POP3) Server Option
|
|||
|
|
|||
|
The POP3 server option specifies a list of POP3 available to the
|
|||
|
client. Servers SHOULD be listed in order of preference.
|
|||
|
|
|||
|
The code for the POP3 server option is 70. The minimum length for
|
|||
|
this option is 4 octets, and the length MUST always be a multiple of
|
|||
|
4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 70 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
8.16. Network News Transport Protocol (NNTP) Server Option
|
|||
|
|
|||
|
The NNTP server option specifies a list of NNTP available to the
|
|||
|
client. Servers SHOULD be listed in order of preference.
|
|||
|
|
|||
|
The code for the NNTP server option is 71. The minimum length for
|
|||
|
this option is 4 octets, and the length MUST always be a multiple of
|
|||
|
4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 71 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 23]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
8.17. Default World Wide Web (WWW) Server Option
|
|||
|
|
|||
|
The WWW server option specifies a list of WWW available to the
|
|||
|
client. Servers SHOULD be listed in order of preference.
|
|||
|
|
|||
|
The code for the WWW server option is 72. The minimum length for
|
|||
|
this option is 4 octets, and the length MUST always be a multiple of
|
|||
|
4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 72 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
8.18. Default Finger Server Option
|
|||
|
|
|||
|
The Finger server option specifies a list of Finger available to the
|
|||
|
client. Servers SHOULD be listed in order of preference.
|
|||
|
|
|||
|
The code for the Finger server option is 73. The minimum length for
|
|||
|
this option is 4 octets, and the length MUST always be a multiple of
|
|||
|
4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 73 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
8.19. Default Internet Relay Chat (IRC) Server Option
|
|||
|
|
|||
|
The IRC server option specifies a list of IRC available to the
|
|||
|
client. Servers SHOULD be listed in order of preference.
|
|||
|
|
|||
|
The code for the IRC server option is 74. The minimum length for
|
|||
|
this option is 4 octets, and the length MUST always be a multiple of
|
|||
|
4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 74 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
8.20. StreetTalk Server Option
|
|||
|
|
|||
|
The StreetTalk server option specifies a list of StreetTalk servers
|
|||
|
available to the client. Servers SHOULD be listed in order of
|
|||
|
preference.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 24]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
The code for the StreetTalk server option is 75. The minimum length
|
|||
|
for this option is 4 octets, and the length MUST always be a multiple
|
|||
|
of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 75 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
8.21. StreetTalk Directory Assistance (STDA) Server Option
|
|||
|
|
|||
|
The StreetTalk Directory Assistance (STDA) server option specifies a
|
|||
|
list of STDA servers available to the client. Servers SHOULD be
|
|||
|
listed in order of preference.
|
|||
|
|
|||
|
The code for the StreetTalk Directory Assistance server option is 76.
|
|||
|
The minimum length for this option is 4 octets, and the length MUST
|
|||
|
always be a multiple of 4.
|
|||
|
|
|||
|
Code Len Address 1 Address 2
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
| 76 | n | a1 | a2 | a3 | a4 | a1 | a2 | ...
|
|||
|
+-----+-----+-----+-----+-----+-----+-----+-----+--
|
|||
|
|
|||
|
9. DHCP Extensions
|
|||
|
|
|||
|
This section details the options that are specific to DHCP.
|
|||
|
|
|||
|
9.1. Requested IP Address
|
|||
|
|
|||
|
This option is used in a client request (DHCPDISCOVER) to allow the
|
|||
|
client to request that a particular IP address be assigned.
|
|||
|
|
|||
|
The code for this option is 50, and its length is 4.
|
|||
|
|
|||
|
Code Len Address
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
| 50 | 4 | a1 | a2 | a3 | a4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
9.2. IP Address Lease Time
|
|||
|
|
|||
|
This option is used in a client request (DHCPDISCOVER or DHCPREQUEST)
|
|||
|
to allow the client to request a lease time for the IP address. In a
|
|||
|
server reply (DHCPOFFER), a DHCP server uses this option to specify
|
|||
|
the lease time it is willing to offer.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 25]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
The time is in units of seconds, and is specified as a 32-bit
|
|||
|
unsigned integer.
|
|||
|
|
|||
|
The code for this option is 51, and its length is 4.
|
|||
|
|
|||
|
Code Len Lease Time
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
| 51 | 4 | t1 | t2 | t3 | t4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
9.3. Option Overload
|
|||
|
|
|||
|
This option is used to indicate that the DHCP 'sname' or 'file'
|
|||
|
fields are being overloaded by using them to carry DHCP options. A
|
|||
|
DHCP server inserts this option if the returned parameters will
|
|||
|
exceed the usual space allotted for options.
|
|||
|
|
|||
|
If this option is present, the client interprets the specified
|
|||
|
additional fields after it concludes interpretation of the standard
|
|||
|
option fields.
|
|||
|
|
|||
|
The code for this option is 52, and its length is 1. Legal values
|
|||
|
for this option are:
|
|||
|
|
|||
|
Value Meaning
|
|||
|
----- --------
|
|||
|
1 the 'file' field is used to hold options
|
|||
|
2 the 'sname' field is used to hold options
|
|||
|
3 both fields are used to hold options
|
|||
|
|
|||
|
Code Len Value
|
|||
|
+-----+-----+-----+
|
|||
|
| 52 | 1 |1/2/3|
|
|||
|
+-----+-----+-----+
|
|||
|
|
|||
|
9.4 TFTP server name
|
|||
|
|
|||
|
This option is used to identify a TFTP server when the 'sname' field
|
|||
|
in the DHCP header has been used for DHCP options.
|
|||
|
|
|||
|
The code for this option is 66, and its minimum length is 1.
|
|||
|
|
|||
|
Code Len TFTP server
|
|||
|
+-----+-----+-----+-----+-----+---
|
|||
|
| 66 | n | c1 | c2 | c3 | ...
|
|||
|
+-----+-----+-----+-----+-----+---
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 26]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
9.5 Bootfile name
|
|||
|
|
|||
|
This option is used to identify a bootfile when the 'file' field in
|
|||
|
the DHCP header has been used for DHCP options.
|
|||
|
|
|||
|
The code for this option is 67, and its minimum length is 1.
|
|||
|
|
|||
|
Code Len Bootfile name
|
|||
|
+-----+-----+-----+-----+-----+---
|
|||
|
| 67 | n | c1 | c2 | c3 | ...
|
|||
|
+-----+-----+-----+-----+-----+---
|
|||
|
|
|||
|
9.6. DHCP Message Type
|
|||
|
|
|||
|
This option is used to convey the type of the DHCP message. The code
|
|||
|
for this option is 53, and its length is 1. Legal values for this
|
|||
|
option are:
|
|||
|
|
|||
|
Value Message Type
|
|||
|
----- ------------
|
|||
|
1 DHCPDISCOVER
|
|||
|
2 DHCPOFFER
|
|||
|
3 DHCPREQUEST
|
|||
|
4 DHCPDECLINE
|
|||
|
5 DHCPACK
|
|||
|
6 DHCPNAK
|
|||
|
7 DHCPRELEASE
|
|||
|
8 DHCPINFORM
|
|||
|
|
|||
|
Code Len Type
|
|||
|
+-----+-----+-----+
|
|||
|
| 53 | 1 | 1-9 |
|
|||
|
+-----+-----+-----+
|
|||
|
|
|||
|
9.7. Server Identifier
|
|||
|
|
|||
|
This option is used in DHCPOFFER and DHCPREQUEST messages, and may
|
|||
|
optionally be included in the DHCPACK and DHCPNAK messages. DHCP
|
|||
|
servers include this option in the DHCPOFFER in order to allow the
|
|||
|
client to distinguish between lease offers. DHCP clients use the
|
|||
|
contents of the 'server identifier' field as the destination address
|
|||
|
for any DHCP messages unicast to the DHCP server. DHCP clients also
|
|||
|
indicate which of several lease offers is being accepted by including
|
|||
|
this option in a DHCPREQUEST message.
|
|||
|
|
|||
|
The identifier is the IP address of the selected server.
|
|||
|
|
|||
|
The code for this option is 54, and its length is 4.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 27]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
Code Len Address
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
| 54 | 4 | a1 | a2 | a3 | a4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
9.8. Parameter Request List
|
|||
|
|
|||
|
This option is used by a DHCP client to request values for specified
|
|||
|
configuration parameters. The list of requested parameters is
|
|||
|
specified as n octets, where each octet is a valid DHCP option code
|
|||
|
as defined in this document.
|
|||
|
|
|||
|
The client MAY list the options in order of preference. The DHCP
|
|||
|
server is not required to return the options in the requested order,
|
|||
|
but MUST try to insert the requested options in the order requested
|
|||
|
by the client.
|
|||
|
|
|||
|
The code for this option is 55. Its minimum length is 1.
|
|||
|
|
|||
|
Code Len Option Codes
|
|||
|
+-----+-----+-----+-----+---
|
|||
|
| 55 | n | c1 | c2 | ...
|
|||
|
+-----+-----+-----+-----+---
|
|||
|
|
|||
|
9.9. Message
|
|||
|
|
|||
|
This option is used by a DHCP server to provide an error message to a
|
|||
|
DHCP client in a DHCPNAK message in the event of a failure. A client
|
|||
|
may use this option in a DHCPDECLINE message to indicate the why the
|
|||
|
client declined the offered parameters. The message consists of n
|
|||
|
octets of NVT ASCII text, which the client may display on an
|
|||
|
available output device.
|
|||
|
|
|||
|
The code for this option is 56 and its minimum length is 1.
|
|||
|
|
|||
|
Code Len Text
|
|||
|
+-----+-----+-----+-----+---
|
|||
|
| 56 | n | c1 | c2 | ...
|
|||
|
+-----+-----+-----+-----+---
|
|||
|
|
|||
|
9.10. Maximum DHCP Message Size
|
|||
|
|
|||
|
This option specifies the maximum length DHCP message that it is
|
|||
|
willing to accept. The length is specified as an unsigned 16-bit
|
|||
|
integer. A client may use the maximum DHCP message size option in
|
|||
|
DHCPDISCOVER or DHCPREQUEST messages, but should not use the option
|
|||
|
in DHCPDECLINE messages.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 28]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
The code for this option is 57, and its length is 2. The minimum
|
|||
|
legal value is 576 octets.
|
|||
|
|
|||
|
Code Len Length
|
|||
|
+-----+-----+-----+-----+
|
|||
|
| 57 | 2 | l1 | l2 |
|
|||
|
+-----+-----+-----+-----+
|
|||
|
|
|||
|
9.11. Renewal (T1) Time Value
|
|||
|
|
|||
|
This option specifies the time interval from address assignment until
|
|||
|
the client transitions to the RENEWING state.
|
|||
|
|
|||
|
The value is in units of seconds, and is specified as a 32-bit
|
|||
|
unsigned integer.
|
|||
|
|
|||
|
The code for this option is 58, and its length is 4.
|
|||
|
|
|||
|
Code Len T1 Interval
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
| 58 | 4 | t1 | t2 | t3 | t4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
9.12. Rebinding (T2) Time Value
|
|||
|
|
|||
|
This option specifies the time interval from address assignment until
|
|||
|
the client transitions to the REBINDING state.
|
|||
|
|
|||
|
The value is in units of seconds, and is specified as a 32-bit
|
|||
|
unsigned integer.
|
|||
|
|
|||
|
The code for this option is 59, and its length is 4.
|
|||
|
|
|||
|
Code Len T2 Interval
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
| 59 | 4 | t1 | t2 | t3 | t4 |
|
|||
|
+-----+-----+-----+-----+-----+-----+
|
|||
|
|
|||
|
9.13. Vendor class identifier
|
|||
|
|
|||
|
This option is used by DHCP clients to optionally identify the vendor
|
|||
|
type and configuration of a DHCP client. The information is a string
|
|||
|
of n octets, interpreted by servers. Vendors may choose to define
|
|||
|
specific vendor class identifiers to convey particular configuration
|
|||
|
or other identification information about a client. For example, the
|
|||
|
identifier may encode the client's hardware configuration. Servers
|
|||
|
not equipped to interpret the class-specific information sent by a
|
|||
|
client MUST ignore it (although it may be reported). Servers that
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 29]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
respond SHOULD only use option 43 to return the vendor-specific
|
|||
|
information to the client.
|
|||
|
|
|||
|
The code for this option is 60, and its minimum length is 1.
|
|||
|
|
|||
|
Code Len Vendor class Identifier
|
|||
|
+-----+-----+-----+-----+---
|
|||
|
| 60 | n | i1 | i2 | ...
|
|||
|
+-----+-----+-----+-----+---
|
|||
|
|
|||
|
9.14. Client-identifier
|
|||
|
|
|||
|
This option is used by DHCP clients to specify their unique
|
|||
|
identifier. DHCP servers use this value to index their database of
|
|||
|
address bindings. This value is expected to be unique for all
|
|||
|
clients in an administrative domain.
|
|||
|
|
|||
|
Identifiers SHOULD be treated as opaque objects by DHCP servers.
|
|||
|
|
|||
|
The client identifier MAY consist of type-value pairs similar to the
|
|||
|
'htype'/'chaddr' fields defined in [3]. For instance, it MAY consist
|
|||
|
of a hardware type and hardware address. In this case the type field
|
|||
|
SHOULD be one of the ARP hardware types defined in STD2 [22]. A
|
|||
|
hardware type of 0 (zero) should be used when the value field
|
|||
|
contains an identifier other than a hardware address (e.g. a fully
|
|||
|
qualified domain name).
|
|||
|
|
|||
|
For correct identification of clients, each client's client-
|
|||
|
identifier MUST be unique among the client-identifiers used on the
|
|||
|
subnet to which the client is attached. Vendors and system
|
|||
|
administrators are responsible for choosing client-identifiers that
|
|||
|
meet this requirement for uniqueness.
|
|||
|
|
|||
|
The code for this option is 61, and its minimum length is 2.
|
|||
|
|
|||
|
Code Len Type Client-Identifier
|
|||
|
+-----+-----+-----+-----+-----+---
|
|||
|
| 61 | n | t1 | i1 | i2 | ...
|
|||
|
+-----+-----+-----+-----+-----+---
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 30]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
10. Defining new extensions
|
|||
|
|
|||
|
The author of a new DHCP option will follow these steps to obtain
|
|||
|
acceptance of the option as a part of the DHCP Internet Standard:
|
|||
|
|
|||
|
1. The author devises the new option.
|
|||
|
2. The author requests a number for the new option from IANA by
|
|||
|
contacting:
|
|||
|
Internet Assigned Numbers Authority (IANA)
|
|||
|
USC/Information Sciences Institute
|
|||
|
4676 Admiralty Way
|
|||
|
Marina del Rey, California 90292-6695
|
|||
|
|
|||
|
or by email as: iana@iana.org
|
|||
|
|
|||
|
3. The author documents the new option, using the newly obtained
|
|||
|
option number, as an Internet Draft.
|
|||
|
4. The author submits the Internet Draft for review through the IETF
|
|||
|
standards process as defined in "Internet Official Protocol
|
|||
|
Standards" (STD 1). The new option will be submitted for eventual
|
|||
|
acceptance as an Internet Standard.
|
|||
|
5. The new option progresses through the IETF standards process; the
|
|||
|
new option will be reviewed by the Dynamic Host Configuration
|
|||
|
Working Group (if that group still exists), or as an Internet
|
|||
|
Draft not submitted by an IETF working group.
|
|||
|
6. If the new option fails to gain acceptance as an Internet
|
|||
|
Standard, the assigned option number will be returned to IANA for
|
|||
|
reassignment.
|
|||
|
|
|||
|
This procedure for defining new extensions will ensure that:
|
|||
|
|
|||
|
* allocation of new option numbers is coordinated from a single
|
|||
|
authority,
|
|||
|
* new options are reviewed for technical correctness and
|
|||
|
appropriateness, and
|
|||
|
* documentation for new options is complete and published.
|
|||
|
|
|||
|
11. Acknowledgements
|
|||
|
|
|||
|
The author thanks the many (and too numerous to mention!) members of
|
|||
|
the DHC WG for their tireless and ongoing efforts in the development
|
|||
|
of DHCP and this document.
|
|||
|
|
|||
|
The efforts of J Allard, Mike Carney, Dave Lapp, Fred Lien and John
|
|||
|
Mendonca in organizing DHCP interoperability testing sessions are
|
|||
|
gratefully acknowledged.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 31]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
The development of this document was supported in part by grants from
|
|||
|
the Corporation for National Research Initiatives (CNRI), Bucknell
|
|||
|
University and Sun Microsystems.
|
|||
|
|
|||
|
12. References
|
|||
|
|
|||
|
[1] Droms, R., "Dynamic Host Configuration Protocol", RFC 2131,
|
|||
|
Bucknell University, March 1997.
|
|||
|
|
|||
|
[2] Reynolds, J., "BOOTP Vendor Information Extensions", RFC 1497,
|
|||
|
USC/Information Sciences Institute, August 1993.
|
|||
|
|
|||
|
[3] Croft, W., and J. Gilmore, "Bootstrap Protocol", RFC 951,
|
|||
|
Stanford University and Sun Microsystems, September 1985.
|
|||
|
|
|||
|
[4] Braden, R., Editor, "Requirements for Internet Hosts -
|
|||
|
Communication Layers", STD 3, RFC 1122, USC/Information Sciences
|
|||
|
Institute, October 1989.
|
|||
|
|
|||
|
[5] Mogul, J., and J. Postel, "Internet Standard Subnetting
|
|||
|
Procedure", STD 5, RFC 950, USC/Information Sciences Institute,
|
|||
|
August 1985.
|
|||
|
|
|||
|
[6] Postel, J., and K. Harrenstien, "Time Protocol", STD 26, RFC
|
|||
|
868, USC/Information Sciences Institute, SRI, May 1983.
|
|||
|
|
|||
|
[7] Postel, J., "Name Server", IEN 116, USC/Information Sciences
|
|||
|
Institute, August 1979.
|
|||
|
|
|||
|
[8] Mockapetris, P., "Domain Names - Implementation and
|
|||
|
Specification", STD 13, RFC 1035, USC/Information Sciences
|
|||
|
Institute, November 1987.
|
|||
|
|
|||
|
[9] Postel, J., "Quote of the Day Protocol", STD 23, RFC 865,
|
|||
|
USC/Information Sciences Institute, May 1983.
|
|||
|
|
|||
|
[10] McLaughlin, L., "Line Printer Daemon Protocol", RFC 1179, The
|
|||
|
Wollongong Group, August 1990.
|
|||
|
|
|||
|
[11] Accetta, M., "Resource Location Protocol", RFC 887, CMU,
|
|||
|
December 1983.
|
|||
|
|
|||
|
[12] Mogul, J. and S. Deering, "Path MTU Discovery", RFC 1191,
|
|||
|
DECWRL, Stanford University, November 1990.
|
|||
|
|
|||
|
[13] Deering, S., "ICMP Router Discovery Messages", RFC 1256,
|
|||
|
Xerox PARC, September 1991.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 32]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
[14] Leffler, S. and M. Karels, "Trailer Encapsulations", RFC 893,
|
|||
|
U. C. Berkeley, April 1984.
|
|||
|
|
|||
|
[15] Hornig, C., "Standard for the Transmission of IP Datagrams over
|
|||
|
Ethernet Networks", RFC 894, Symbolics, April 1984.
|
|||
|
|
|||
|
[16] Postel, J. and J. Reynolds, "Standard for the Transmission of
|
|||
|
IP Datagrams Over IEEE 802 Networks", RFC 1042, USC/Information
|
|||
|
Sciences Institute, February 1988.
|
|||
|
|
|||
|
[17] Sun Microsystems, "System and Network Administration", March
|
|||
|
1990.
|
|||
|
|
|||
|
[18] Mills, D., "Internet Time Synchronization: The Network Time
|
|||
|
Protocol", RFC 1305, UDEL, March 1992.
|
|||
|
|
|||
|
[19] NetBIOS Working Group, "Protocol Standard for a NetBIOS Service
|
|||
|
on a TCP/UDP transport: Concepts and Methods", STD 19, RFC 1001,
|
|||
|
March 1987.
|
|||
|
|
|||
|
[20] NetBIOS Working Group, "Protocol Standard for a NetBIOS Service
|
|||
|
on a TCP/UDP transport: Detailed Specifications", STD 19, RFC
|
|||
|
1002, March 1987.
|
|||
|
|
|||
|
[21] Scheifler, R., "FYI On the X Window System", FYI 6, RFC 1198,
|
|||
|
MIT Laboratory for Computer Science, January 1991.
|
|||
|
|
|||
|
[22] Reynolds, J., and J. Postel, "Assigned Numbers", STD 2, RFC 1700,
|
|||
|
USC/Information Sciences Institute, July 1992.
|
|||
|
|
|||
|
13. Security Considerations
|
|||
|
|
|||
|
Security issues are not discussed in this memo.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 33]
|
|||
|
|
|||
|
RFC 2132 DHCP Options and BOOTP Vendor Extensions March 1997
|
|||
|
|
|||
|
|
|||
|
14. Authors' Addresses
|
|||
|
|
|||
|
Steve Alexander
|
|||
|
Silicon Graphics, Inc.
|
|||
|
2011 N. Shoreline Boulevard
|
|||
|
Mailstop 510
|
|||
|
Mountain View, CA 94043-1389
|
|||
|
|
|||
|
Phone: (415) 933-6172
|
|||
|
EMail: sca@engr.sgi.com
|
|||
|
|
|||
|
|
|||
|
Ralph Droms
|
|||
|
Bucknell University
|
|||
|
Lewisburg, PA 17837
|
|||
|
|
|||
|
Phone: (717) 524-1145
|
|||
|
EMail: droms@bucknell.edu
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Alexander & Droms Standards Track [Page 34]
|
|||
|
|