Cisco CNS Network Registrar User's Guide, 5.5
Appendix: DHCP Options
Downloads: This chapterpdf (PDF - 447.0KB) The complete bookPDF (PDF - 5.45MB) | Feedback

DHCP Options

Table Of Contents

DHCP Options

Option Descriptions

BOOTP Extensions/DHCP Option Field Format

RFC 1497 Vendor Extensions

IP Layer Parameters Per Host

IP Layer Parameters Per Interface

Link Layer Parameters Per Interface

TCP Parameters

Application and Service Parameters

DHCP Extensions

Microsoft Client Options

Option Tables

Options by Number

Options by Network Registrar Name

Options by Category

Option Validation Types


DHCP Options


DHCP 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 appendix contains DHCP options and BOOTP vendor extensions from RFC 2132, and includes the validation type for each option, as indicated in Table B-9.

This appendix also contains the standard Microsoft client options and several tables displaying the options sorted by categories.

Option Descriptions

The following sections describe the DHCP options in detail:

BOOTP Extensions/DHCP Option Field Format

RFC 1497 Vendor Extensions

IP Layer Parameters Per Host

Link Layer Parameters Per Interface

TCP Parameters

Application and Service Parameters

DHCP Extensions

Microsoft Client Options

BOOTP Extensions/DHCP Option Field Format

DHCP options have the same format as the BOOTP vendor extensions defined in RFC 1497. Options can 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 omits the two octets specifying the tag and length. The length octet is followed by that number of 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.

Except for the options in section 9, all options can 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 instead of FQDNs can make future renumbering of IP hosts more difficult. Use of these addresses is discouraged at sites that may require renumbering.

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.

RFC 1497 Vendor Extensions

Table B-1 lists the vendor extensions as defined in RFC 1497.

Table B-1 RFC 1497 Vendor Extension Options 

Option Name
No.
Length
Description

Pad

0

1 octet

Causes the subsequent fields to align on word boundaries.

End

255

1 octet

End of valid information in the vendor field. Subsequent octets should be filled with the Pad options.

Subnet Mask

1

4 octets

Client's subnet mask, as per RFC 950. If both the Subnet Mask and the Router option are specified in a DHCP reply, the Subnet Mask option must be first.

Time Offset

2

4 octets

Offset of the client's subnet, in seconds, from Universal Time (UT). The offset is expressed as a twos-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.

Router

3

4 octet minimum; multiples of 4

List of IP addresses for routers on the client's subnet. Routers should be in order of preference.

Time Server

4

4 octet minimum; multiples of 4

List of RFC 868 compliant time servers available to the client. Servers should be in order of preference.

Name Server Option

5

4 octet minimum; multiples of 4

List of IEN 116 name servers available to the client. Servers should be in order of preference.

Domain Name Server

6

4 octet minimum; multiples of 4

List of Domain Name System (STD 13, RFC 1035) name servers available to the client. Servers should be in order of preference.

Log Server

7

4 octet minimum; multiples of 4

List of MIT-LCS UDP log servers available to the client. Servers should be in order of preference.

Cookie Server

8

4 octet minimum; multiples of 4

List of RFC 865-compliant cookie servers available to the client. Servers should be in order of preference.

LPR Server

9

4 octet minimum; multiples of 4

List of RFC 1179-compliant line printer servers available to the client. Servers should be in order of preference.

Impress Server

10

4 octet minimum; multiples of 4

List of Imagen Impress servers available to the client. Servers should be in order of preference.

Resource Location Server

11

4 octet minimum; multiples of 4

List of RFC 887-compliant resource location servers available to the client. Servers should be in order of preference.

Host Name

12

4 octet minimum; multiples of 4

Name of the client. The name may or may not be qualified with the local domain name. See RFC 1035 for the character set restrictions.

Boot File Size

13

2 octets

Number of 512-octet blocks in the default boot file.

Merit Dump File

14

1 octet minimum

Path name of a file to which the client's core image should be placed in the event the client crashes. The path is formatted as a character string consisting of characters from the NVT ASCII character set.

Domain Name

15

1 octet minimum

Domain name that the client should use when resolving hostnames through the Domain Name System.

Swap Server

16

4 octets

IP address of the client's swap server.

Root Path

17

1 octet minimum

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.

Extensions Path

18

1 octet minimum

Uses a string to specify a file, retrievable through TFTP. The file contains information that 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, and all references to instances of this option in the file are ignored.


IP Layer Parameters Per Host

Table B-2 lists the options that affect the operation of the IP layer on a per-host basis.

Table B-2 IP Layer Parameters Per Host Options 

Option Name
No.
Length
Description

IP Forwarding Enable/Disable

19

1 octet

Specifies whether the client should configure its IP layer for packet forwarding. Values: 0=disable; 1=enable

Non-Local Source Routing Enable/Disable

20

1 octet

Specifies whether the client should configure its IP layer to allow forwarding of datagrams with non-local source routes. Values: 0=disable; 1=enable

Policy Filter

21

8 octet minimum; multiples of 8

Policy filters for non-local source routing. The filters consist of a list of IP addresses and masks that 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.

Maximum Datagram Reassembly Size

22

2 octets

Maximum size datagram that the client should be prepared to reassemble. Value: 576 minimum

Default IP Time-to-Live

23

1 octet

Default TTL that the client should use on outgoing datagrams. Values: 1 to 255

Path MTU Aging Timeout

24

4 octets

Timeout (in seconds) to use when aging Path MTU values (defined in RFC 1191).

Path MTU Plateau Table

25

2 octets minimum; multiples of 2

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. Value: 68 minimum


IP Layer Parameters Per Interface

Table B-3 lists the options that affect the operation of the IP layer on a per-interface basis. A client can issue multiple requests, one per interface, to configure interfaces with their specific parameters.

Table B-3 IP Layer Parameters Per Interface Options 

Option Name
No.
Length
Description

Interface MTU

26

2 octets

Maximum time to live to use on this interface.

All Subnets Are Local

27

1 octet

Specifies whether or not the client can 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.
Values: 1=all subnets share same MTU; 0=some directly-connected subnets can have smaller MTUs

Broadcast Address

28

4 octets

Broadcast address in use on the client's subnet.

Perform Mask Discovery

29

1 octet

Specifies whether or not the client should perform subnet mask discovery using ICMP. Values: 0=disable; 1=enable

Mask Supplier

30

1 octet

Specifies whether or not the client should respond to subnet mask requests using ICMP.
Values: 0=do not respond; 1=respond

Perform Router Discovery

31

1 octet

Specifies whether or not the client should solicit routers using the Router Discovery mechanism defined in RFC 1256. Values: 0=disable; 1=enable

Router Solicitation Address

32

4 octets

Address to which the client should transmit router solicitation requests.

Static Route

33

8 octet minimum; multiples of 8

List of static routes that the client should install in its routing cache. If multiple routes to the same destination are specified, they are 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.


Link Layer Parameters Per Interface

Table B-4 lists the options that affect the operation of the data link layer on a per-interface basis.

Table B-4 Link Layer Parameters Per Interface Options 

Option Name
No.
Length
Description

Trailer Encapsulation

34

1 octet

Specifies whether or not the client should negotiate the use of trailers (RFC 893) when using the ARP protocol. Values: 0=do not use; 1=use

ARP Cache Timeout

35

4 octets

Timeout in seconds for ARP cache entries.

Ethernet Encapsulation

36

1 octet

Specifies whether or not the client should use Ethernet Version 2 (RFC 894) or IEEE 802.3 (RFC 1042) encapsulation if the interface is an Ethernet.
Value: 0=use RFC 894 encapsulation; 1=use RFC 1042 encapsulation


TCP Parameters

Table B-5 lists the options that affect the operation of the TCP layer on a per-interface basis.

Table B-5 TCP Parameter Options 

Option Name
No.
Length
Description

TCP Default TTL

37

1 octet

Default TTL that the client should use when sending TCP segments. Value: minimum 1

TCP Keepalive Interval

38

4 octets

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. Value: 32-bit unsigned; 0=do not generate keepalive messages unless specifically requested.

TCP Keepalive Garbage

39

1 octet

Specifies the whether or not the client should send TCP keep-alive messages with an octet of garbage for compatibility with older implementations.
Values: 0=do not send; 1=send


Application and Service Parameters

Table B-6 lists some miscellaneous options used to configure miscellaneous applications and services.

Table B-6 Application and Service Parameter Options 

Option Name
No.
Length
Description

Network Information Service Domain

40

1 octet minimum

Name of the client's NIS domain. The domain is formatted as a character string consisting of characters from the NVT ASCII character set.

Network Information Servers

41

4 octet minimum; multiples of 4

List of IP addresses indicating NIS servers available to the client. Servers should be in order of preference.

Network Time Protocol Servers

42

4 octet minimum; multiples of 4

List of IP addresses indicating NTP servers that are available to the client. Servers should be in order of preference.

Vendor-Specific Information

43

1 octet minimum

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 can be reported). Clients that do not receive desired vendor-specific information should make an attempt to operate without it, although they can do so (and announce they are doing so) in a degraded mode.

(continued)

Vendor-Specific Information, continued

43

1 octet minimum

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 here.

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:

There should not be a magic cookie field in the encapsulated vendor-specific extensions field.

Codes other than 0 or 255 can 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.

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.

NetBIOS over TCP/IP Name Server

44

4 octet minimum; multiples of 4

List of RFC 1001/1002 NBNS name servers in order of preference.

NetBIOS over TCP/IP Datagram Distribution Server

45

4 octet minimum; multiples of 4

List of RFC 1001/1002 NBDD servers in order of preference.

NetBIOS over TCP/IP Node Type

46

1 octet

Allows NetBIOS over TCP/IP client, which are configured as described in RFC 1001/1002.
Values: Single octet in hexadecimal that identifies the client type:

0x1=B-node (broadcast node)

0x2=P-node (point-to-point node)

0x4=M-node (mixed node)

0x8=H-node

NetBIOS over TCP/IP Scope

47

1 octet minimum

NetBIOS over TCP/IP scope parameter for the client as specified in RFC 1001/1002.

X Window System Font Server

48

4 octet minimum; multiples of 4

List of X Window System Font servers available to the client. Servers should be in order of preference.

X Window System Display Manager

49

4 octet minimum; multiples of 4

List of IP addresses of systems that are running the X Window System Display Manager and are available to the client. Addresses should be in order of preference.

Network Information Service+ Domain

64

1 octet minimum

Name of the client's NIS+ domain. The domain is formatted as a character string consisting of characters from the NVT ASCII character set.

Network Information Service+ Servers

65

4 octet minimum; multiples of 4

List of IP addresses indicating NIS+ servers available to the client. Servers should be in order of preference.

Mobile IP Home Agent

68

0 octets minimum; multiples of 4; expected, 4 octets (single home agent's address)

List of IP addresses indicating mobile IP home agents available to the client. Agents should be in order of preference.
Value: 32-bit address; 0=no home agents available

Simple Mail Transport Protocol (SMTP) Server

69

4 octet minimum; multiples of 4

List of SMTP servers available to the client. Servers should be in order of preference.

Post Office Protocol (POP3) Server

70

4 octet minimum; multiples of 4

List of POP3 servers available to the client. Servers should be in order of preference.

Network News Transport Protocol (NNTP) Server

71

4 octet minimum; multiples of 4

List of NNTP servers available to the client. Servers should be in order of preference.

Default World Wide Web (WWW) Server

72

4 octet minimum; multiples of 4

List of World Wide Web (WWW) servers available to the client. Servers should be in order of preference.

Default Finger Server

73

4 octet minimum; multiples of 4

List of Finger servers available to the client. Servers should be in order of preference.

Default Internet Relay Chat Server

74

4 octet minimum; multiples of 4

List of IRC servers available to the client. Servers should be in order of preference.

StreetTalk Server

75

4 octet minimum; multiples of 4

List of StreetTalk servers available to the client. Servers should be in order of preference.

StreetTalk Directory Assistance (STDA) Server

76

4 octet minimum; multiples of 4

List of STDA servers available to the client. Servers should be in order of preference.


DHCP Extensions

This section describes the options that are specific to DHCP.

Table B-6 lists some miscellaneous options used to configure miscellaneous applications and services.

Table B-7 Application and Service Parameter Options 

Option Name
No.
Length
Description

Requested IP Address

50

4 octets

Used in a client request (DHCPDISCOVER) to allow the client to request that a particular IP address be assigned.

IP Address Lease Time

51

4 octets

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.
Value: seconds, as 32-bit unsigned integer

Option Overload

52

1 octet

Indicates 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.
Values: 1=file field is used to hold options; 2=sname field is used to hold options; 3=both fields are used to hold options

DHCP Message Type

53

1 octet

Used to convey the type of DHCP message. The default is 1 (DHCPDISCOVER).
Values: 1=DHCPDISCOVER; 2=DHCPOFFER; 3=DHCPREQUEST; 4=DHCPDECLINE; 5=DHCPACK; 6=DHCPNAK; 7=DHCPRELEASE; 8=DHCPINFORM

Server Identifier

54

4 octets

Used in DHCPOFFER and DHCPREQUEST messages, and can 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.

Parameter Request List

55

1 octet minimum

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 can list the options in order of preference. The DHCP server does not have to return the options in the requested order, but must try to insert the options in the order that the client requested.

Message

56

1 octet minimum

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 can use this option in a DHCPDECLINE message to indicate why the client declined the offered parameters. The message consists of n octets of NVT ASCII text, which the client can display on an available output device.

Maximum DHCP Message Size

57

2 octets

Maximum length DHCP message that a server is willing to accept. The length is specified as an unsigned 16-bit integer. A client can use the maximum DHCP message size option in DHCPDISCOVER or DHCPREQUEST messages, but should not use the option in DHCPDECLINE messages. Value: 576 minimum

Renewal (T1) Time Value

58

4 octets

Time interval from address assignment until the client transitions to RENEWING state.
Value: seconds, as 32-bit unsigned integer

Rebinding (T2) Time Value

59

4 octets

Time interval from address assignment until the client transitions to REBINDING state.
Value: seconds, as 32-bit unsigned integer

Vendor Class Identifier

60

1 octet minimum

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 can choose to define specific vendor class identifiers to convey particular configuration or other identification information about a client. For example, the identifier can encode the client's hardware configuration. Servers not equipped to interpret the class-specific information sent by a client must ignore it (although it can be reported). Servers that respond should only use option 43 to return the vendor-specific information to the client.

Client-Identifier

61

2 octet minimum

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.

DHCP servers should treat identifiers as opaque objects. The client identifier can consist of type-value pairs similar to the htype/chaddr fields. For instance, it can 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. A hardware type of 0 (zero) should be used when the value field contains an identifier other than a hardware address (for example, a fully qualified domain name).

(continued)

Client-Identifier, continued

61

2 octet minimum

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.

TFTP Server Name

66

1 octet minimum

Identifies a TFTP server when the sname field in the DHCP header has been used for DHCP options.

Bootfile Name

67

1 octet minimum

Identifies a bootfile when the file field is the DHCP header that has been used for DHCP options.


Microsoft Client Options

Table B-8 lists the standard Microsoft client options.

Table B-8 Microsoft DHCP Client Options 

This option...
Means...

dhcp-lease-time

14 days

domain-name

A domain name such as cisco.com

domain-name-servers

IP address of the name servers

netbios-name-servers

WINS server address

netbios-node-type

Identifies the NetBIOS client type; note that Network Registrar displays a warning if it is not present

routers

IP address of the router for this subnet


Option Tables

The following tables display the DHCP options in various ways. They show the options sorted numerically, by Network Registrar name, and by category.

DHCP options have a prescribed format and allowed values for their option parameters. Table B-9 lists each DCHP option and parameter type (in the Validation column). The parameter formats and allowed values come from the DHCP and Internet RFCs. All the DHCP options appear, but clients control only some, and the GUI and CLI only others.

Options by Number

Table B-9 shows the DHCP options sorted by option number, and includes the validation type. (See Table B-12 for details on the option validation types found in the Validation column.)

.

Table B-9 DHCP Options by Number 

No.
Network Registrar Name
Protocol Name
Category
Validation

--

packet-file-name

--

DHCP Packet Fields

STRING

--

packet-server-name

--

DHCP Packet Fields

STRING

--

packet-siaddr

--

DHCP Packet Fields

IPADDR

0

pad
(set by protocol)

Pad

--

(cannot set in GUI or CLI)

1

subnet-mask
(derived)

Subnet Mask

Basic

MASK (cannot set in GUI)

2

time-offset

Time Offset

BOOTP

INT32

3

routers

Router

Basic, MS DHCP Client

IPADDR_LIST

4

time-servers

Time Server

BOOTP

IPADDR_LIST

5

name-servers

Name Server

BOOTP

IPADDR_LIST

6

domain-name-servers

Domain Name Server

Basic, MS DHCP Client

IPADDR_LIST

7

log-servers

Log Server

Servers

IPADDR_LIST

8

cookie-servers

Cookie Server

BOOTP

IPADDR_LIST

9

lpr-servers

LPR Server

Servers

IPADDR_LIST

10

impress-servers

Impress Server

BOOTP

IPADDR_LIST

11

resource-location-servers

Resource Location Server

BOOTP

IPADDR_LIST

12

host-name

Host Name

Basic

HOSTNAME (but accepts any string)

13

boot-size

Boot File Size

BOOTP

SIZE16 in 512-byte blocks

14

merit-dump

Merit Dump File

BOOTP

STRING

15

domain-name

Domain Name

Basic, MS DHCP Client

STRING

16

swap-server

Swap Server

BOOTP

IPADDR

17

root-path

Root Path

BOOTP

STRING

18

extensions-path

Extensions Path

BOOTP

STRING

19

ip-forwarding

IP Forwarding Enable/Disable

Host IP

BOOLEAN

20

non-local-source-routing

Non-Local Source Routing

Host IP

BOOLEAN

21

policy-filters

Policy Filter

Host IP

Accepts alternating IPADDR/MASK entries

22

max-dgram-reassembly

Maximum Datagram Reassembly Size

Host IP

SIZE16

23

default-ip-ttl

Default IP Time-to-Live

Host IP

1 - 255; rejects zero values

24

path-mtu-aging-timeout

Path MTU Aging Timeout

Host IP

SIZE32

25

path-mtu-plateau-tables

Path MTU Plateau Table

Host IP

SIZE16 => 68

26

interface-mtu

Interface MTU

Interface

SIZE16 => 68

27

all-subnets-local

All Subnets Are Local

Interface

BOOLEAN

28

broadcast-address
(cannot set in GUI)

Broadcast Address

Interface

0.0.0.0, 255.255.255.255, or nonstandard

29

perform-mask-discovery

Perform Mask Discovery

Interface

BOOLEAN

30

mask-supplier

Mask Supplier

Interface

BOOLEAN

31

router-discovery

Perform Router Discovery

Interface

BOOLEAN

32

router-solicitation-address

Router Solicitation Address

Interface

IPADDR

33

static-routes

Static Route

Interface

IPADDR pairs

34

trailer-encapsulation

Trailer Encapsulation

Interface

BOOLEAN

35

arp-cache-timeout

ARP Cache Timeout

Interface

SIZE32

36

ieee802.3-encapsulation

Ethernet Encapsulation

Interface

BOOLEAN

37

default-tcp-ttl

TCP Default TTL

Interface

SIZE8 > 0

38

tcp-keepalive-interval

TCP Keepalive Interval

Interface

SIZE32

39

tcp-keepalive-garbage

TCP Keepalive Garbage

Interface

BOOLEAN

40

nis-domain

NIS Domain

Servers

STRING

41

nis-servers

Network Information Servers

Servers

IPADDR_LIST

42

ntp-servers

NTP Servers

Servers

IPADDR_LIST

43

vendor-encapsulated-
options

Vendor-Specific Information

--

(cannot set in GUI)

44

netbios-name-servers

NetBIOS over TCP/IP Name Server

WINS/NetBIOS, MS DHCP Client

IPADDR_LIST

45

netbios-dd-servers

NetBIOS over TCP/IP Datagram Distribution Server

WINS/NetBIOS

IPADDR_LIST

46

netbios-node-type

NetBIOS over TCP/IP Node Type

WINS/NetBIOS, MS DHCP Client

1, 2, 4, 8 only

47

netbios-scope

NetBIOS over TCP/IP Scope

WINS/NetBIOS, MS DHCP Client

STRING

48

font-servers

X Window System Font Server

Servers

IPADDR_LIST

49

x-display-managers

X Window System Display Manager

Servers

IPADDR_LIST

50

dhcp-requested-address
(set by DHCP client)

Requested IP Address

--

IPADDR (cannot set in GUI)

51

dhcp-lease-time

IP Address Lease Time

Lease Information, MS DHCP Client

SIZE32

52

dhcp-option-overload

Option Overload

--

OVERLOAD (cannot set)

53

dhcp-message-type
(set by protocols)

DHCP Message Type

--

(cannot set in GUI or CLI)

54

dhcp-server-identifier
(set by DHCP server)

Server Identifier

--

IPADDR (cannot set in GUI)

55

dhcp-parameter-request-list

Parameter Request List

--

REQUEST_LIST (cannot set in GUI)

56

dhcp-message

Message

--

STRING (cannot set in GUI)

57

dhcp-max-message-size
(set by protocol)

Maximum DHCP Message Size

--

(cannot set in GUI or CLI)

58

dhcp-renewal-time

Renewing (T1) Time Value

Lease Information, MS DHCP Client

SIZE32

59

dhcp-rebinding-time

Rebinding (T2) Time Value

Lease Information, MS DHCP Client

SIZE32

60

dhcp-class-identifier
(set by DHCP client)

Vendor Class Identifier

--

STRING (cannot set in GUI)

61

dhcp-client-identifier
(set by DHCP client)

Client-Identifier

Basic

STRING (cannot set in GUI)

62

netwareip-domain

NetWare/IP Domain Name

NetWare Client

 

63

netwareip-information

NetWare/IP Information

NetWare Client

 

64

nis+-domain

NIS+ Domain

Servers

STRING

65

nis+-servers

NIS+ Servers

Servers

IPADDR_LIST

66

tftp-server

TFTP Server Name

Servers

STRING

67

boot-file

Bootfile Name

BOOTP

STRING

68

mobile-ip-home-agents

Mobile IP Home Agent

Servers

IPADDR_LIST

69

smtp-servers

SMTP Server

Servers

IPADDR_LIST

70

pop3-servers

POP3 Server

Servers

IPADDR_LIST

71

nntp-servers

NNTP Server

Servers

IPADDR_LIST

72

www-servers

Default WWW Server

Servers

IPADDR_LIST

73

finger-servers

Default Finger Server

Servers

IPADDR_LIST

74

irc-servers

Default IRC Server

Servers

IPADDR_LIST

75

streettalk-servers

StreetTalk Server

Servers

IPADDR_LIST

76

streettalk-directory-
assistance-servers

STDA Server

Servers

IPADDR_LIST

77

dhcp-user-class-id
(set by DHCP client)

--

--

STRING (cannot set in GUI)

81

fqdn
(see the "Configuring DNS Updates for Windows 2000 Clients" section)

DHCP Client FQDN

(proposed)

(IETF draft)

82

relay-agent-info
(see "Configuring the DHCP Server for Virtual Private Networks and Subnet Allocation")

DHCP Relay Agent Information

--

See RFC 3046

85

nds-servers

NDS Servers

NetWare Client

 

86

nds-tree

NDS Tree Name

NetWare Client

 

87

nds-context

NDS Context

NetWare Client

 

128

mcns-security-server

--

Servers

IPADDR

255

end
(set by protocol)

End

--

(cannot set in GUI or CLI)


Options by Network Registrar Name

Table B-10 lists the DHCP options by Network Registrar name. (For each option's validation type, cross-reference it by number to Table B-9 and check the Validation column.)

Table B-10 DHCP Options by Network Registrar Name 

Network Registrar Name
Number
Protocol Name
Category

all-subnets-local

27

All Subnets Are Local

Interface

arp-cache-timeout

35

ARP Cache Timeout

Interface

boot-file

67

Bootfile Name

BOOTP

boot-size

13

Boot File Size

BOOTP

broadcast-address

28

Broadcast Address

Interface

cookie-servers

8

Cookie Server

BOOTP

default-ip-ttl

23

Default IP Time-to-Live

Host IP

default-tcp-ttl

37

TCP Default TTL

Interface

dhcp-class-identifier

60

Vendor Class Identifier

--

dhcp-client-identifier

61

Client-Identifier

Basic

dhcp-lease-time

51

IP Address Lease Time

Lease Information, MS DHCP Client

dhcp-max-message-size

57

Maximum DHCP Message Size

--

dhcp-message-type

53

DHCP Message Type

--

dhcp-message

56

Message

--

dhcp-option-overload

52

Option Overload

--

dhcp-parameter-request-list

55

Parameter Request List

--

dhcp-rebinding-time

59

Rebinding (T2) Time Value

Lease Information, MS DHCP Client

dhcp-renewal-time

58

Renewing (T1) Time Value

Lease Information, MS DHCP Client

dhcp-requested-address

50

Requested IP Address

--

dhcp-server-identifier

54

Server Identifier

--

dhcp-user-class-id

77

--

--

domain-name

15

Domain Name

Basic, MS DHCP Client

domain-name-servers

6

Domain Name Server

Basic, MS DHCP Client

end

255

End

--

extensions-path

18

Extensions Path

BOOTP

finger-servers

73

Default Finger Server

Servers

font-servers

48

X Window System Font Server

Servers

fqdn

81

DHCP Client FQDN

(proposed)

host-name

12

Host Name

Basic

ieee802.3-encapsulation

36

Ethernet Encapsulation

Interface

impress-servers

10

Impress Server

BOOTP

interface-mtu

26

Interface MTU

Interface

ip-forwarding

19

IP Forwarding Enable/Disable

Host IP

irc-servers

74

Default IRC Server

Servers

log-servers

7

Log Server

Servers

lpr-servers

9

LPR Server

Servers

mask-supplier

30

Mask Supplier

Interface

max-dgram-reassembly

22

Maximum Datagram Reassembly Size

Host IP

mcns-security-server

128

--

Servers

merit-dump

14

Merit Dump File

BOOTP

mobile-ip-home-agents

68

Mobile IP Home Agent

Servers

name-servers

5

Name Server

BOOTP

nds-context

87

NDS Context

NetWare Client

nds-servers

85

NDS Servers

NetWare Client

nds-tree

86

NDS Tree Name

NetWare Client

netbios-dd-servers

45

NetBIOS over TCP/IP Datagram Distribution Server

WINS/NetBIOS

netbios-name-servers

44

NetBIOS over TCP/IP Name Server

WINS/NetBIOS, MS DHCP Client

netbios-node-type

46

NetBIOS over TCP/IP Node Type

WINS/NetBIOS, MS DHCP Client

netbios-scope

47

NetBIOS over TCP/IP Scope

WINS/NetBIOS, MS DHCP Client

netwareip-domain

62

NetWare/IP Domain Name

NetWare Client

netwareip-information

63

NetWare/IP Information

NetWare Client

nis+-domain

64

NIS+ Domain

Servers

nis+-servers

65

Network Information+ Servers

Servers

nis-domain

40

NIS Domain

Servers

nis-servers

41

Network Information Servers

Servers

nntp-servers

71

NNTP Server

Servers

non-local-source-routing

20

Non-Local Source Routing

Host IP

ntp-servers

42

NTP Servers

Servers

packet-file-name

--

--

DHCP Packet Fields

packet-server-name

--

--

DHCP Packet Fields

packet-siaddr

--

--

DHCP Packet Fields

pad

0

Pad

--

path-mtu-aging-timeout

24

Path MTU Aging Timeout

Host IP

path-mtu-plateau-tables

25

Path MTU Plateau Table

Host IP

perform-mask-discovery

29

Perform Mask Discovery

Interface

policy-filters

21

Policy Filter

Host IP

pop3-servers

70

POP3 Server

Servers

relay-agent-info

82

DHCP Relay Agent Information

--

resource-location-servers

11

Resource Location Server

BOOTP

root-path

17

Root Path

BOOTP

router-discovery

31

Perform Router Discovery

Interface

router-solicitation-address

32

Router Solicitation Address

Interface

routers

3

Router

Basic, MS DHCP Client

smtp-servers

69

SMTP Server

Servers

static-routes

33

Static Route

Interface

streettalk-directory-
assistance-servers

76

STDA Server

Servers

streettalk-servers

75

StreetTalk Server

Servers

subnet-mask

1

Subnet Mask

Basic

swap-server

16

Swap Server

BOOTP

tcp-keepalive-garbage

39

TCP Keepalive Garbage

Interface

tcp-keepalive-interval

38

TCP Keepalive Interval

Interface

tftp-server

66

TFTP Server Name

Servers

time-offset

2

Time Offset

BOOTP

time-servers

4

Time Server

BOOTP

trailer-encapsulation

34

Trailer Encapsulation

Interface

vendor-encapsulated-options

43

Vendor Specific Information

--

www-servers

72

Default WWW Server

Servers

x-display-managers

49

X Window System Display Manager

Servers


Options by Category

Table B-11 list each option by category. (For each option's validation type, cross-reference it by number to Table B-9 and check the Validation column.)

Table B-11 DHCP Options by Category 

Category
Number
Network Registrar Name
Protocol Name

--

0

pad

Pad

--

43

vendor-encapsulated-options

Vendor Specific Information

--

50

dhcp-requested-address

Requested IP Address

--

52

dhcp-option-overload

Option Overload

--

53

dhcp-message-type

DHCP Message Type

--

54

dhcp-server-identifier

Server Identifier

--

55

dhcp-parameter-request-list

Parameter Request List

--

56

dhcp-message

Message

--

57

dhcp-max-message-size

Maximum DHCP Message Size

--

60

dhcp-class-identifier

Vendor Class Identifier

--

77

dhcp-user-class-id

--

--

82

relay-agent-info

--

--

255

end

End

Basic

1

subnet-mask

Subnet Mask

Basic

3

routers

Router

Basic

6

domain-name-servers

Domain Name Server

Basic

12

host-name

Host Name

Basic

15

domain-name

Domain Name

Basic

61

dhcp-client-identifier

Client-Identifier

BOOTP

2

time-offset

Time Offset

BOOTP

4

time-servers

Time Server

BOOTP

5

name-servers

Name Server

BOOTP

8

cookie-servers

Cookie Server

BOOTP

10

impress-servers

Impress Server

BOOTP

11

resource-location-servers

Resource Location Server

BOOTP

13

boot-size

Boot File Size

BOOTP

14

merit-dump

Merit Dump File

BOOTP

16

swap-server

Swap Server

BOOTP

17

root-path

Root Path

BOOTP

18

extensions-path

Extensions Path

BOOTP

67

boot-file

Bootfile Name

DHCP Packet Fields

--

packet-file-name

--

DHCP Packet Fields

--

packet-server-name

--

DHCP Packet Fields

--

packet-siaddr

--

Host IP

19

ip-forwarding

IP Forwarding Enable/Disable

Host IP

20

non-local-source-routing

Non-Local Source Routing

Host IP

21

policy-filters

Policy Filter

Host IP

22

max-dgram-reassembly

Maximum Datagram Reassembly Size

Host IP

23

default-ip-ttl

Default IP Time-to-Live

Host IP

24

path-mtu-aging-timeout

Path MTU Aging Timeout

Host IP

25

path-mtu-plateau-tables

Path MTU Plateau Table

Interface

26

interface-mtu

Interface MTU

Interface

27

all-subnets-local

All Subnets Are Local

Interface

28

broadcast-address

Broadcast Address

Interface

29

perform-mask-discovery

Perform Mask Discovery

Interface

30

mask-supplier

Mask Supplier

Interface

31

router-discovery

Perform Router Discovery

Interface

32

router-solicitation-address

Router Solicitation Address

Interface

33

static-routes

Static Route

Interface

34

trailer-encapsulation

Trailer Encapsulation

Interface

35

arp-cache-timeout

ARP Cache Timeout

Interface

36

ieee802.3-encapsulation

Ethernet Encapsulation

Interface

37

default-tcp-ttl

TCP Default TTL

Interface

38

tcp-keepalive-interval

TCP Keepalive Interval

Interface

39

tcp-keepalive-garbage

TCP Keepalive Garbage

Lease Information

51

dhcp-lease-time

IP Address Lease Time

Lease Information

58

dhcp-renewal-time

Renewing (T1) Time Value

Lease Information

59

dhcp-rebinding-time

Rebinding (T2) Time Value

Microsoft DHCP Client

3

routers

Router

Microsoft DHCP Client

6

domain-name-servers

Domain Name Server

Microsoft DHCP Client

15

domain-name

Domain Name

Microsoft DHCP Client

44

netbios-name-servers

NetBIOS over TCP/IP Name Server

Microsoft DHCP Client

46

netbios-node-type

NetBIOS over TCP/IP Node Type

Microsoft DHCP Client

47

netbios-scope

NetBIOS over TCP/IP Scope

Microsoft DHCP Client

51

dhcp-lease-time

IP Address Lease Time

Microsoft DHCP Client

58

dhcp-renewal-time

Renewing (T1) Time Value

Microsoft DHCP Client

59

dhcp-rebinding-time

Rebinding (T2) Time Value

NetWare Client

62

netwareip-domain

NetWare/IP Domain Name

NetWare Client

63

netwareip-information

NetWare/IP Information

NetWare Client

85

nds-servers

NDS Servers

NetWare Client

86

nds-tree

NDS Tree Name

NetWare Client

87

nds-context

NDS Context

Servers

7

log-servers

Log Server

Servers

9

lpr-servers

LPR Server

Servers

40

nis-domain

NIS Domain

Servers

41

nis-servers

Network Information Servers

Servers

42

ntp-servers

NTP Servers

Servers

48

font-servers

X Window System Font Server

Servers

49

x-display-managers

X Window System Display Manager

Servers

64

nis+-domain

NIS+ Domain

Servers

65

nis+-servers

NIS+ Servers

Servers

66

tftp-server

TFTP Server Name

Servers

68

mobile-ip-home-agents

Mobile IP Home Agent

Servers

69

smtp-servers

SMTP Server

Servers

70

pop3-servers

POP3 Server

Servers

71

nntp-servers

NNTP Server

Servers

72

www-servers

Default WWW Server

Servers

73

finger-servers

Default Finger Server

Servers

74

irc-servers

Default IRC Server

Servers

75

streettalk-servers

StreetTalk Server

Servers

76

streettalk-directory-assistance-servers

STDA Server

Servers

128

mcns-security-server

--

WINS/NetBIOS

44

netbios-name-servers

NetBIOS over TCP/IP Name Server

WINS/NetBIOS

45

netbios-dd-servers

NetBIOS over TCP/IP Datagram Distribution Server

WINS/NetBIOS

46

netbios-node-type

NetBIOS over TCP/IP Node Type

WINS/NetBIOS

47

netbios-scope

NetBIOS over TCP/IP Scope


Option Validation Types

Table B-12 defines the DHCP option validation types.

Table B-12 Validation Types 

Validation
Format and Allowed Values

BOOLEAN

Boolean value. Represents the state of an enabled or disabled option. The GUI presents a set of two radio buttons marked True and False from which to choose.

BROADCAST_ADDR

The broadcast address for the network. This address is entered in IPADDR format and can be one of two values: 0.0.0.0 or 255.255.255.255. The 0.0.0.0 address has been deprecated and is seldom used on modern networks.

BYTES

Unrestricted sequence of octets.

HOSTNAME

Used by the hostname to specify the name of the client. The name may or may not be qualified with the local domain name. RFC 1035 character set restrictions. The grammar for hostnames is:

domain ::= <subdomain> | " "

<subdomain> ::= <label> | <subdomain> "." <label>

<label> ::= <ldh-str> <let-dig>

<ldh-str> ::= <let-dig-hyp> | <let-dig-hyp> <ldh-str>

<let-dig-hyp> ::= <let-dig> | `-`

<let-dig> ::= <letter> | <digit>

<letter> ::= any one of the 52 alphabetic characters `A' through `Z' in uppercase and `a' through `z' in lowercase.

<digit> ::= any one of the ten digits `0' through `9'

INT16

16-bit integer value. Maximum range of values: -32768 through 32767.

INT32

32-bit integer value. Maximum range of values: - 2147483648 through 2147483647.

IPADDR

An IP address is a 32-bit number, entered as a quadruple-octet (numbers ranging from 0-255) with decimal points separating the octet numbers.

IPADDR_LIST

A list containing at least one IP address. See IPADDR for format and allowed values of each list member.

IPADDR_MASK_LIST

A list of IP address and subnet mask tuples. The list contains at least one tuple. See IPADDR and MASK for respective formats and allowed values of the tuple members.

IPADDR_PAIR_LIST

A list of IP address tuples. The list contains at least one tuple. See IPADDR for format and allowed values of the tuple members.

MASK

Client subnet mask as per RFC 950. A subnet mask is a 32-bit number, entered in IP Address format, starting with 0 or more bits, with the remaining bits set to zero. Nine numbers can appear in a subnet mask— 0, 128, 192, 224, 240, 248, 252, 254, and 255. The subnet-mask option is an exception: it accepts any valid IP address, even invalid masks. The GUI asks for the subnet mask when the scope is created, not as a DHCP option.


Note Users currently using non-contiguous subnets are not prevented from doing so.


OVERLOAD

DHCP Message field overload indicator. Integer values 1, 2, or 3.

REQUEST_LIST

A list of DHCP option codes used by dhcp-parameter-request-list to return requested option data.

SIZE8

8-bit unsigned value. Represents a count, size or duration. Can have a range of allowed values associated with a given option. Maximum range of values: 0 through 255.

SIZE16

16-bit unsigned value. Represents a count, size or duration. Can have a range of allowed values associated with a given option. Maximum range of values: 0 through 65535.

SIZE16_LIST

A list containing one or more 16-bit unsigned integer values.

SIZE32

32-bit unsigned value. Represents a count, size or duration. Can have a range of allowed values associated with a given option. Maximum range of values: 0 through 4294967295.

STRING

Unrestricted sequence of ASCII characters (values: 0 through 255)