cc/td/doc/product/rtrmgmt/ciscoasu/nr/nr3.0
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

DHCP Options Validation

DHCP Options Validation

DHCP options have a prescribed format and allowed values for their option parameters. Each DCHP option and parameter type is listed in Table C-1. The parameter type is linked to the corresponding line in the "Validation Types" (Table C-2), where the format and allowed values are defined. The parameter formats and allowed values come from the DHCP and Internet RFCs.

All the DHCP options are listed, but some are not controlled by the user, some are only offered by the GUI, and some are only offered by the CLI. The Current Option Validations Table lists the current options offered by Network Registrar and the type validations performed.


Table C-1: DHCP Option Validation
Option Name Type of Validation

all-subnets-local

BOOLEAN

arp-cache-timeout

Accepts 32-bit values. Out of range error message displays "value must be between 0 and 4294967295."

boot-file

STRING

boot-size

Should be SIZE32 ( <= 33553920 ) or SIZE16 and specify the file size is in 512 octet blocks.

broadcast-address

Should be limited to the 0.0.0.0 and 255.255.255.255 broadcast addresses; however users currently using nonstandard broadcast addresses are not prevented from doing so.

cookie-servers

IPADDR LIST

default-ip-ttl

Rejects zero values. Invalid entry error message displays "value must be between 1 and 255."

default-tcp-ttl

Rejects zero values. Invalid entry error message displays "value must be between 1 and 255."

dhcp-class-identifier

STRING

dhcp-lease-time

SIZE32

dhcp-message

STRING

dhcp-rebinding-time

Accepts 32-bit values. Out of range error message displays "value must be between 0 and 4294967295."

dhcp-renewal-time

Accepts 32-bit values. Out of range error message displays "value must be between 0 and 4294967295."

dhcp-requested-address

IPADDR

dhcp-server-identifier

IPADDR

dhcp-user-class-id

STRING

domain-name

STRING

domain-name-servers

IPADDR_LIST

extensions-path

STRING

finger-servers

IPADDR_LIST

font-servers

IPADDR_LIST

host-name

Accepts host names that do not conform to RFC 1035 naming conventions (accepts any string). See Hostname in the Option Validation Table for the acceptable grammar.

ieee802.3-encapsulation

BOOLEAN

impress-servers

IPADDR_LIST

interface-mtu

Rejects values less than 68. Invalid entry error message displays "value must be between 68 and 65535."

ip-forwarding

BOOLEAN

irc-servers

IPADDR_LIST

log-servers

IPADDR_LIST

mask-supplier

BOOLEAN

max-dgram-reassembly

SIZE16

mcns-security-server

IPADDR

merit-dump

STRING

mobile-ip-home-agents

IPADDR_LIST

name-servers

IPADDR_LIST

netbios-dd-servers

IPADDR_LIST

netios-name-servers

IPADDR_LIST

netbios-node-type

Accepts only 1, 2, 4 and 8 values

netbios-scope

STRING

nis+domain

STRING

nis+servers

IPADDR_LIST

nis-domain

STRING

nis-servers

IPADDR_LIST

nntp-servers

IPADDR_LIST

non-local-source-routing

BOOLEAN

ntp-servers

IPADDR_LIST

packet-file-name

STRING

packet-server-name

STRING

packet-siaddr

IPADDR

path-mtu-aging-timeout

Accepts 32-bit values. Out of range error message displays "value must be between 0 and 4294967295."

path-mtu-plateau-tables

Accept multiple values, each in the range of 68 to 65535. The invalid entry error message displays "value must be between 68 and 65535."

perform-mask-discovery

BOOLEAN

policy-filters

Accepts alternating IP address, subnet mask entries. Uses IP address and subnet mask validations for respective entries. Invalid entry message displays "enter a list of IP address, subnet mask pairs."

pop-servers

IPADDR_LIST

resource-location-servers

IPADDR_LIST

root-path

STRING

router-discovery

BOOLEAN

routers

IPADDR_LIST

router-solicitation-address

IPADDR

smtp-servers

IPADDR_LIST

static-routes

Accepts pairs of IP addresses. Uses IP address validation on each entry. The invalid entry message displays "enter a list of IP address pairs."

streettalk-directory-assistance-servers

IPADDR_LIST

streettalkservers

IPADDR_LIST

subnet-mask

Exception: accepts invalid subnet masks---any valid IP address is accepted. See MASK. Note that the GUI asks for the subnet mask when the scope is created, not as a DHCP option. Users currently using non-contiguous subnets are not prevented from doing so.

swap-server

IPADDR

tcp-keepalive-garbage

BOOLEAN

tcp-keepalive-interval

Accepts 32-bit values. Out of range error message displays "value must be between 0 and 4294967295."

tftp-server

STRING

time-offset

INT32

time-servers

IPADDR_LIST

trailer-encapsulation

BOOLEAN

www-servers

IPADDR_LIST

x-displaymanagers

IPADDR_LIST

Table C-2 defines the validation types.


Table C-2: Validation Types
Validation Format and Allowed Values

BOOL

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

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 host name 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 host names 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 thru 32767.

INT32

32-bit integer value. Maximum range of values: - 2147483648 thru 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 1 bits, with the remaining bits set to zero. Nine numbers may appear in a subnet mask--- 0, 128, 192, 224, 240, 248, 252, 254, and 255.

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. May 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. May have a range of allowed values associated with a given option. Maximum range of values: 0 through 65535.

SIZE16_LIST

A list containing at lease one 16-bit unsigned integer value.

SIZE32

32-bit unsigned value. Represents a count, size or duration. May 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-255)

SIZE32


hometocprevnextglossaryfeedbacksearchhelp
Posted: Thu Nov 18 12:25:36 PST 1999
Copyright 1989-1999©Cisco Systems Inc.