This section lists the predefined options available for use with the Microsoft Windows Server 2003 DHCP service. These options are defined according to the updated standards reference for DHCP options in RFC 2132, “DHCP Options and BOOTP Vendor Extensions.”
Use the DHCP Microsoft Management Console (MMC) snap-in to specifically configure each option value, and enable the option for assignment and distribution to DHCP clients based on server, scope, class, or client-specific levels of preference.
The following sections list the basic DHCP options originally defined in RFC 1497 and updated in RFC 2132, for use with DHCP and the Boot Protocol (BOOTP) service. The BOOTP service refers to options as vendor extensions.
The DHCP service supports configuration and distribution of any options assigned using the DHCP Manager snap-in. By default, Microsoft DHCP-enabled clients require and provide storage and interpretation for options 1 (Subnet Mask), 3 (Router), 6 (DNS Servers), and 15 (DNS Domain Name).
Pad Option
A single octet of zero (“00”) used for padding. This option differs from most DHCP options in that it does not use a length or value field. This option used to ensure that subsequent DHCP options are aligned on word boundaries the same as they appear in the DHCP packet. This option does not require configuration.
Code
Length
Value
Not used.
Structure of Pad Option
End Option
A single octet of decimal 255 (“FF”) used to indicate the end of a DHCP options area in DHCP messages. This option differs from most DHCP options because it does not use a length or value field. Typically, it is used at the end of the options field to indicate that there is no more option data in a DHCP message. It can also be used within the message, in connection with vendor-specific information (option 43), to indicate the end of an encapsulated vendor-specific options subfield. This option does not require configuration.
Code
Length
Value
Not used.
Structure of End Option
Subnet Mask
This option specifies the subnet mask of the client subnet, as described in RFC 950. The value for this option is taken from the Subnet Mask field, as defined in the DHCP ScopeProperties dialog box in DHCP Manager. A DHCP client running Windows XP or Windows Server 2003 requests this option.
Code
Length
Value
Unsigned 32-bit (4 octet) integer representing the subnet mask for an IP address provided in a DHCP message.
Structure of Subnet Mask
|
Code
|
Length
|
Subnet Mask
|
|---|
1 | 4 | subnet mask in binary format |
Time Offset
This option specifies an offset value (in seconds) from the Coordinated Universal Time (UTC) that applies to the client subnet. This value is configurable as a signed 32-bit integer. Positive offset values indicate a subnet location east of the zero meridian. Negative offset values indicate a subnet location west of the zero meridian.
Code
Length
Value
Signed 32-bit integer used for offset of UTC.
Structure of Time Offset
|
Code
|
Length
|
Time Offset
|
|---|
2 | 4 | time |
Router
This option specifies a list of IP addresses for routers on the client subnet. When more than one router is assigned, the client interprets and uses the addresses in the specified order. This option is normally used to assign a default gateway to DHCP clients on a subnet. A DHCP client running Windows XP or Windows Server 2003 requests this option.
Code
Length
Variable. Minimum length of 4 octets; octet length increases in multiples of 4 for each router address listed.
Value
Unsigned 32-bit integer representing the IP address of each assigned router.
Structure of Router
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
3 | n | IP address in binary format | IP address in binary format |
Time Server
This option specifies a list of IP addresses for time servers, as defined in RFC 868, that are available to the client. When more than one time server is assigned, the client interprets and uses the addresses in the specified order.
Code
Length
Variable. Minimum length of 4 octets; octet length increases in multiples of 4 for each time server address listed.
Value
Unsigned 32-bit integer representing the IP address of each assigned time server.
Structure of Time Server
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
4 | n | IP address in binary format | IP address in binary format |
IEN Name Server
This option specifies a list of IP addresses for Internet Engineering Note (IEN) name servers available to the client. When more than one server is assigned, the client interprets and uses the addresses in the specified order.
Code
Length
Variable. Minimum length of 4 octets; octet length increases in multiples of 4 for each IEN name server address listed.
Value
Unsigned 32-bit integer representing the IP address of each assigned IEN name server.
Structure of IEN Name Server
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
5 | n | IP address in binary format | IP address in binary format |
DNS Servers
This option specifies a list of IP addresses for DNS name servers available to the client. When more than one server is assigned, the client interprets and uses the addresses in the specified order. A DHCP client running Windows XP and Windows Server 2003 requests this option.
Code
Length
Variable. Minimum length of 4 octets; octet length increases in multiples of 4 for each Domain Name System (DNS) server address listed.
Value
Unsigned 32-bit integer representing the IP address of each assigned DNS server.
Structure of DNS Servers
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
6 | n | IP address in binary format | IP address in binary format |
Log Server
This option specifies a list of IP addresses for Massachusetts Institute of Technology Lab for Computer Science (MIT-LCS) User Datagram Protocol (UDP) log servers available to the client. When more than one server is assigned, the client interprets and uses the addresses in the specified order.
Code
Length
Variable. Minimum length of 4 octets; octet length increases in multiples of 4 for each log server address listed.
Value
Unsigned 32-bit integer representing the IP address of each assigned log server.
Structure of Log Server
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
7 | n | IP address in binary format | IP address in binary format |
Cookie Server
This option specifies a list of IP addresses for cookie servers, as defined in RFC 865, available to the client. When more than one server is assigned, the client interprets and uses the addresses in the specified order.
Code
Length
Variable. Minimum length of 4 octets; octet length increases in multiples of 4 for each cookie server address listed.
Value
Unsigned 32-bit integer representing the IP address of each assigned cookie server.
Structure of Cookie Server
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
8 | n | IP address in binary format | IP address in binary format |
LPR Server
This option specifies a list of IP addresses for line printer (LPR) servers, as defined in RFC 1179, available to the client. When more than one server is assigned, the client interprets and uses the addresses in the specified order.
Code
Length
Variable. Minimum length of 4 octets; octet length increases in multiples of 4 for each LPR server address listed.
Value
Unsigned 32-bit integer representing the IP address of each assigned LPR server.
Structure of LPR Server
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
9 | n | IP address in binary format | IP address in binary format |
Impress Server
This option specifies a list of IP addresses for Imagen Impress servers available to the client. When more than one server is assigned, the client interprets and uses the addresses in the specified order.
Code
Length
Variable. Minimum length of 4 octets; octet length increases in multiples of 4 for each Impress server address listed.
Value
Unsigned 32-bit integer representing the IP address of each assigned Impress server.
Structure of Impress Server
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
10 | n | IP address in binary format | IP address in binary format |
Resource Location Server
This option specifies a list of IP addresses for resource location servers, as defined in RFC 887, available to the client. When more than one server is assigned, the client interprets and uses the addresses in the specified order.
Code
Length
Variable. Minimum length of 4 octets; octet length increases in multiples of 4 for each resource location server address listed.
Value
Unsigned 32-bit integer representing the IP address of each assigned resource location server.
Structure of Resource Location Server
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
11 | n | IP address in binary format | IP address in binary format |
Host Name
This option specifies a host name for the client. In some cases, this name can also be fully qualified by appending the name value provided here with the DNS domain name, as specified in DHCP option 15. For Windows clients, this option is not supported for use when configuring the client’s host name, which is set for computers running Windows XP or Windows Server 2003 on the Computer Name tab in the System Properties dialog box on the client computer.
Code
Length
Length varies depending on data in value. Minimum length is 1 octet. Maximum length is limited to 63 characters, or one octet for each character used in the host name configured for use with this option.
Value
ASCII character text.
Structure of Host Name
|
Code
|
Length
|
Host Name
|
|---|
12 | n | name |
Boot File Size
This option specifies the size of the default boot image file for the client.
Code
Length
Value
Unsigned 16-bit integer to indicate the number of 512-octet blocks needed to make up the boot file.
Structure of Boot File Size
|
Code
|
Length
|
File Size
|
|---|
13 | 02 | 16-bit integer |
Merit Dump File
This option specifies the path name of a file to which the client’s core memory image should be dumped in the event the client terminates abnormally. Data used for a value is in ASCII character text format. The length of the value field depends on the number of characters used in the path specified. For example, if the path entered has 20 characters, the value field for this option should also be 20 octets in length.
Code
Length
Length varies depending on data in value. Minimum length is 1 octet.
Value
ASCII character text.
Structure of Merit Dump File
|
Code
|
Length
|
Dump File Path
|
|---|
14 | n | path name |
DNS Domain Name
This option specifies the domain name that the DHCP client should use when resolving unqualified domain names with the Domain Name System (DNS). For DHCP clients running Windows 2000, Windows XP, and Windows Server 2003, the DNS Domain Name option becomes the connection-specific DNS name assigned to the DHCP-configured interface. The connection-specific DNS name is used to construct fully qualified domain names (FQDNs) that are registered using DNS dynamic update. The length of the value field depends on the number of characters used in the DNS domain name specified. For example, if the domain name has 20 characters, the value field for this option is 20 octets in length. A DHCP client running Windows XP or Windows Server 2003 requests this option.
Code
Length
Length varies depending on data in value. Minimum length is 1 octet.
Value
ASCII character text.
Structure of DNS Domain Name
|
Code
|
Length
|
Domain Name
|
|---|
15 | n | domain name |
Swap Server
This option specifies the IP address of the client’s swap server.
Code
Length
Length is fixed at 4 octets.
Value
A single IP address for the client’s swap server (unsigned 32-bit integer).
Structure of Swap Server
|
Code
|
Length
|
Swap Server Address
|
|---|
16 | 4 | IP address in binary format |
Root Path
This option specifies the path of the client’s root disk. The path value is formatted as ASCII text. The length of the value field depends on the number of characters used in the root path specified. For example, if the root path entered has 20 characters, the value field for this option is 20 octets in length.
Code
Length
Length varies depending on data in value. Minimum length is 1 octet.
Value
ASCII character text.
Structure of Root Path
|
Code
|
Length
|
Root Disk Path
|
|---|
17 | n | path name |
Extensions Path
This option specifies an extension path file that can be retrieved using Trivial File Transfer Protocol (TFTP). The file contains information to be interpreted as the 64-octet vendor-extension field within a BOOTP response. To allow more than 64 octets of BOOTP vendor extension information, this option can be enabled. When enabled, the length of the specified extension path file is not constrained in size and all references in the extensions file to tag 18 (such as instances of the BOOTP Extensions Path field) are ignored.
Code
Length
Length varies depending on data in value. Minimum length is 1 octet.
Value
ASCII character text.
Structure of Extension Path
|
Code
|
Length
|
Extensions Path
|
|---|
18 | n | file name |
The following sections describe the DHCP options that affect the operation of the IP layer, on a per-host basis.
IP Forwarding Enable/Disable
This option specifies whether the DHCP client should enable or disable forwarding of datagrams at the IP layer.
Code
Length
Length is fixed at 1 octet.
Value
Accepted values for this option are:
-
1 = Enable IP forwarding
-
0 = Disable IP forwarding
Structure of IP Forwarding Enable/Disable
|
Code
|
Length
|
Value
|
|---|
19 | 1 | 0 | 1 |
Non-Local Source Routing Enable/Disable
This option specifies whether the DHCP client enables or disables the forwarding at the IP layer of datagrams that contain source routing information and were sent by a non-local host.
Code
Length
Length is fixed at 1 octet.
Value
Accepted values for this option are:
-
1 = Enable forwarding of datagrams from non-local sources
-
0 = Disable forwarding of datagrams from non-local sources
Structure of Non-Local Source Routing Enable/Disable
|
Code
|
Length
|
Value
|
|---|
20 | 1 | 0 | 1 |
Policy Filter
This option specifies policy filters for non-local source routing on the client. The filters consist of a list of IP address and mask pairs specifying destination and mask pairs for which incoming datagrams should be source-route filtered. The client discards any source routed datagram with a next-hop address that does not match one of the filters. For further information about policy filtering as it applies to this option, see RFC 1122 in the IETF RFC Database.
Code
Length
Variable. Minimum length is 8 octets for a single destination and mask pair. Length increases in multiples of 8 octets for each additional pair used.
Value
Two consecutive, unsigned 32-bit integers indicating a paired value, consisting of an IP address followed by a subnet mask.
Structure of Policy Filter
|
Code
|
Length
|
Address 1
|
Subnet Mask 1
|
Address N
|
Subnet Mask N
|
|---|
21 | n | IP address in binary format | subnet mask in binary format | IP address in binary format | subnet mask in binary format |
Maximum Datagram Reassembly Size
This option specifies the maximum size datagram that the client needs to be prepared to reassemble.
Code
Length
Value
Unsigned 16-bit integer specifying the maximum datagram size for reassembly. The minimum size for a datagram is 576 octets.
Structure of Maximum Datagram Reassembly Size
|
Code
|
Length
|
File Size
|
|---|
22 | 2 | 16-bit integer |
Default IP Time-To-Live
This option specifies the default Time-To-Live (TTL) that the client uses for the datagrams it sends.
Code
Length
Value
A number (in seconds) between 1 and 255.
Structure of Default IP Time-To-Live
|
Code
|
Length
|
TTL
|
|---|
23 | 1 | TTL value in seconds |
Path MTU Aging Time-out
This option specifies the time-out for aging Path Maximum Transmission Unit (MTU) values. Values are found by the Path MTU discovery process, as defined in RFC 1191.
Code
Length
Value
A number (in seconds) that specifies a time-out value.
Structure of Path MTU Aging Time-out
|
Code
|
Length
|
Time-out
|
|---|
24 | 4 | time-out value in seconds |
Path MTU Plateau Table
This option specifies a table of MTU sizes to use when performing Path MTU discovery, as defined in RFC 1191.
Code
Length
Variable. Minimum length is 2 octets and increases in multiples of 2.
Value
A table formatted as a list of 16-bit unsigned integers, ordered from smallest to largest. The minimum tabled MTU value cannot be smaller than 68.
Structure of Path MTU Plateau Table
|
Code
|
Length
|
MTU Size 1
|
MTU Size N
|
|---|
25 | n | MTU size in binary format | MTU size in binary format |
The following sections describe the DHCP options that affect operation of the IP layer on a per-interface basis.
Interface MTU
This option specifies the MTU size that can be used on a specified host adapter interface.
Code
Length
Value
A 16-bit unsigned integer specifying the interface MTU. The minimum value for the MTU is 68.
Structure of Interface MTU
|
Code
|
Length
|
MTU
|
|---|
26 | 2 | interface MTU |
All Subnets Are Local
This option specifies whether the client assumes that all subnets within the client’s internetwork use the same MTU size as the local subnet on which the client is connected.
Code
Length
Value
Accepted values for this option are:
-
1 = Clients assume all subnets are local and share the same MTU size
-
0 = Clients assume some subnets are not local and that smaller MTU sizes might be in use on remote subnets
Structure of All Subnets Are Local
|
Code
|
Length
|
Value
|
|---|
27 | 1 | 0 | 1 |
Broadcast Address
This option specifies the broadcast address used on the client’s subnet.
Code
Length
Value
Typically, the limited broadcast IP address (255.255.255.255), but can be modified using legal values for broadcast addresses, as specified in section 3.2.1.3 of RFC 1122.
Structure of Broadcast Address
|
Code
|
Length
|
Broadcast Address
|
|---|
28 | 4 | broadcast address in binary format |
Perform Mask Discovery
This option specifies whether the client uses Internet Control Message Protocol (ICMP) for subnet mask discovery.
Code
Length
Value
Accepted values for this option are:
-
1 = Client performs subnet mask discovery
-
0 = Client does not perform subnet mask discovery
Structure of Perform Mask Discovery
|
Code
|
Length
|
Value
|
|---|
29 | 1 | 0 | 1 |
Mask Supplier
This option specifies whether the client responds to subnet mask requests using ICMP.
Code
Length
Value
Accepted values for this option are:
-
1 = Client responds to subnet mask requests
-
0 = Client does not respond to subnet mask requests
Structure of Mask Supplier
|
Code
|
Length
|
Value
|
|---|
30 | 1 | 0 | 1 |
Perform Router Discovery
This option specifies whether the client solicits routers using the router discovery method in RFC 1256. A DHCP client running Windows XP or Windows Server 2003 requests this option.
Code
Length
Value
Accepted values for this option are:
-
1 = Client performs router discovery
-
0 = Client does not perform router discovery
Structure of Perform Router Discovery
|
Code
|
Length
|
Value
|
|---|
31 | 1 | 0 | 1 |
Router Solicitation Address
This option specifies the IP address to which the client submits router solicitation requests.
Code
Length
Value
Unsigned 32-bit integer representing an IP address.
Structure of Router Solicitation Address
|
Code
|
Length
|
Address
|
|---|
32 | 4 | IP address in binary format |
Static Routes
This option specifies a list of classful static routes that the DHCP client automatically adds to its IP routing table. Multiple routes to the same destination are listed in descending order of priority. The default route of 0.0.0.0 is an illegal destination for a static route. To configure the default route, use the Router DHCP option to assign a default gateway. A DHCP client running Windows XP or Windows Server 2003 requests this option.
Code
Length
Variable. Minimum length of 8 octets; octet length increases in multiples of 8 for each additional static route provided with this option.
Value
A list of IP address pairs. Each set of 8 octets provides two consecutive IP addresses pairing the destination (as a classful network ID) and a router address (the IP address of the router interface on the subnet to which this scope-specific option is configured) used for each route. The first 4 octets specify the destination classful network ID, and the second 4 octets specify the router IP address.
Structure of Static Routes
|
Code
|
Length
|
Destination 1
|
Router 1
|
Destination N
|
Router N
|
|---|
33 | n | IP address in binary format | IP address in binary format | IP address in binary format | IP address in binary format |
Classless Static Route
This option specifies a list of classful static routes that the client automatically adds to its IP routing table. A DHCP client running Windows XP or Windows Server 2003 requests this option. The Classless Static Route can be used to configure split tunneling for remote access virtual private network (VPN) clients running Windows XP and Windows Server 2003. For more information, see “VPN Technical Reference.”
Code
249
Note
-
This is the same as option 121, as defined in RFC 3442.
Length
Variable. Minimum length of 5 octets; maximum octet length depends on the nature and number of the classless static routes. Each route entry includes a destination descriptor and a router and can vary from a minimum of 5 octets in length to maximum 9 octets in length. For more information about how classless static routes are constructed using a destination descriptor, see RFC 3442 in the IETF RFC Database.
Value
The destination descriptor and the router IP address. The value is encoded. For the encoding scheme, see RFC 3442.
Structure of Classless Static Route
|
Code
|
Length
|
Destination 1
|
Router 1
|
Destination N
|
Router N
|
|---|
249 | n | Destination descriptor, as defined in RFC 3442 | IP address in binary format | Destination descriptor, as defined in RFC 3442 | IP address in binary format |
The following sections describe the DHCP options that affect the application layer operations on a per-interface basis. These are miscellaneous options used to configure programs and services.
NIS Domain Name
This option specifies the Network Information Service (NIS) domain name as an ASCII string.
Code
Length
Length varies depending on data in value. Minimum length is 1 octet.
Value
ASCII character text.
Structure of NIS Domain Name
|
Code
|
Length
|
NIS Domain Name
|
|---|
40 | n | NIS domain name |
NIS Servers
This option lists the IP addresses in order of preference for Network Information Service (NIS) servers available to the client.
Code
Length
Variable. Minimum length is 4 octets; octet length increases in multiples of 4 for each server address listed.
Value
Unsigned 32-bit integer representing the IP address of each NIS server.
Structure of NIS Servers
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
41 | n | IP address in binary format | IP address in binary format |
NTP Servers
This option lists the IP addresses in the order of preference for Network Time Protocol (NTP) servers available to the client.
Code
Length
Variable. Minimum length is 4 octets; octet length increases in multiples of 4 for each server address listed.
Value
Unsigned 32-bit integer representing the IP address of each NTP server.
Structure of NTP Servers
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
42 | n | IP address in binary format | IP address in binary format |
X Window System Font Servers
This option lists the IP addresses in the order of preference for X Window System font servers available to the client.
Code
Length
Variable. Minimum length is 4 octets; octet length increases in multiples of 4 for each server address listed.
Value
Unsigned 32-bit integer representing each server IP address.
Structure of X Window System Font Servers
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
48 | n | IP address in binary format | IP address in binary format |
X Window System Display Manager Servers
This option lists the IP addresses in the order of preference for X Window System display manager servers available to the client.
Code
Length
Variable. Minimum length is 4 octets; octet length increases in multiples of 4 for each server address listed.
Value
Unsigned 32-bit integer representing each server IP address.
Structure of X Window System Display Manager Servers
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
49 | n | IP address in binary format | IP address in binary format |
NIS+ Domain Name
This option specifies the name of the client’s Network Information Service Plus (NIS+) domain name as an ASCII string.
Code
Length
Length varies depending on the data in its value. Minimum length is 1 octet.
Value
ASCII character text.
Structure of NIS+ Domain Name
|
Code
|
Length
|
NIS+ Domain Name
|
|---|
64 | n | NIS+ domain name |
NIS+ Servers
This option lists the IP addresses in the order of preference for Network Information Service Plus (NIS+) servers available to the client.
Code
Length
Variable. Minimum length is 4 octets; octet length increases in multiples of 4 for each server address listed.
Value
Unsigned 32-bit integer representing IP address of NIS+ servers.
Structure of NIS+ Servers
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
65 | n | IP address in binary format | IP address in binary format |
Mobile IP Home Agents
This option lists the IP addresses in the order of preference for mobile IP home agents available to the client.
Code
Length
Variable. Minimum length is 0 octets. A length of 0 octets signifies that no mobile IP home agents are available. Octet length increases in multiples of 4 for each mobile IP home agent address listed.
Value
Unsigned 32-bit integer representing IP address of a mobile IP home agent.
Structure of Mobile IP Home Agents
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
68 | n | IP address in binary format | IP address in binary format |
Simple Mail Transfer Protocol (SMTP) Server
This option lists the IP addresses in order of preference for SMTP servers available to the client.
Code
Length
Variable. Minimum length is 4 octets; octet length increases in multiples of 4 for each server IP address listed.
Value
Unsigned 32-bit integers representing IP addresses of servers.
Structure of Simple Mail Transfer Protocol (SMTP) Server
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
69 | n | IP address in binary format | IP address in binary format |
Post Office Protocol 3 (POP3) Server
This option lists the IP addresses in order of preference for POP3 servers available to the client.
Code
Length
Variable. Minimum length is 4 octets; octet length increases in multiples of 4 for each server IP address listed.
Value
Unsigned 32-bit integers representing IP addresses of servers.
Structure of Post Office Protocol 3 (POP3) Server
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
70 | n | IP address in binary format | IP address in binary format |
Network News Transport Protocol Server
This option lists the IP addresses in order of preference for NNTP servers available to the client.
Code
Length
Variable. Minimum length is 4 octets; octet length increases in multiples of 4 for each server IP address listed.
Value
Unsigned 32-bit integers representing IP addresses of servers.
Structure of Network News Transport Protocol Server
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
71 | n | IP address in binary format | IP address in binary format |
Default World Wide Web Server
This option lists the IP addresses in order of preference for default Web servers available to the client.
Code
Length
Variable. Minimum length is 4 octets; octet length increases in multiples of 4 for each server IP address listed.
Value
Unsigned 32-bit integers representing IP addresses of servers.
Structure of Default World Wide Web Server
|
Code
|
Length
|
Address 1
|
Address N
|
|---|
72 | n | IP address in binary format | IP address in binary format |