rfc-2242

NetWare/IP Domain Name and Information

R. Droms, K. Fong
date1997-11 streamIETF areaint wgdhc statusPROPOSED STANDARD pages6 canonicalhttps://www.rfc-editor.org/rfc/rfc2242 doi10.17487/RFC2242
This document defines options that carry NetWare/IP domain name and NetWare/IP sub-options to DHCP clients. [STANDARDS-TRACK]

Extracted elements (20)

interoperability-note §3

When NWIP_EXIST_IN_SNAME_FILE is used, options 62 and 63 are placed in the area covered by the DHCP 'sname' and 'file' fields. Option 63 in the 'options' area is a stub with length 2 pointing to the sname/file area; the full sub-option data appears only in sname/file.

normative-requirement §3 SHOULD

If NSQ_BROADCAST sub-option value is 1, the client SHOULD perform a NetWare Nearest Server Query to find its nearest NetWare/IP server.

normative-requirement §3 SHOULD

If NWIP_1_1 sub-option value is 1, the NetWare/IP client SHOULD support NetWare/IP Version 1.1 compatibility.

normative-requirement §3 MUST

One and only one of the four status sub-options (NWIP_DOES_NOT_EXIST, NWIP_EXIST_IN_OPTIONS_AREA, NWIP_EXIST_IN_SNAME_FILE, NWIP_EXIST_BUT_TOO_BIG) MUST be the first sub-option present in option 63 encoding.

protocol-element §2

DHCP option 62 carries the NetWare/IP Domain Name as an NVT ASCII string. The option code is 62, maximum length is 255, and the string length is inferred from the 'len' field.

dns

protocol-element §3

DHCP option 63 carries NetWare/IP information (all NetWare/IP data except the domain name) as a set of sub-options. The option code is 63, maximum length is 255, and each sub-option contains a one-byte code, one-byte length, and optional value field.

protocol-element §3

Sub-option AUTORETRIES (code 8) has length 1 and a one-byte integer indicating how many times a NetWare/IP client should attempt to communicate with a given DSS server at startup.

protocol-element §3

Sub-option AUTORETRY_SECS (code 9) has length 1 and a one-byte integer indicating the delay in seconds between each NetWare/IP client attempt to communicate with a given DSS server at startup.

protocol-element §3

Sub-option NEAREST_NWIP_SERVER (code 7) contains an array of up to 5 IPv4 addresses (each 4 bytes) of the nearest NetWare/IP servers. Maximum length is 20 bytes.

protocol-element §3

Sub-option NSQ_BROADCAST (code 5) has length 1; a value of 1 indicates the client SHOULD perform a NetWare Nearest Server Query to find its nearest NetWare/IP server.

protocol-element §3

Sub-option NWIP_1_1 (code 10) has length 1; a value of 1 indicates the NetWare/IP client SHOULD support NetWare/IP Version 1.1 compatibility, required only when contacting a v1.1 server.

protocol-element §3

Sub-option NWIP_DOES_NOT_EXIST (code 1) indicates the responding DHCP server has no NetWare/IP information configured. It is a type-length pair with length set to zero.

protocol-element §3

Sub-option NWIP_EXIST_BUT_TOO_BIG (code 4) indicates neither the 'options' area nor 'sname' field can accommodate the NetWare/IP information.

protocol-element §3

Sub-option NWIP_EXIST_IN_OPTIONS_AREA (code 2) indicates all NetWare/IP information is present in the 'options' area of the DHCP response packet. It is a type-length pair with length set to zero.

protocol-element §3

Sub-option NWIP_EXIST_IN_SNAME_FILE (code 3) indicates all NetWare/IP information is present in the 'sname' and, if necessary, 'file' fields of the DHCP response. Within the 'options' area, option 63 appears with length 2, first byte set to NWIP_EXIST_IN_SNAME_FILE and second byte zero.

protocol-element §3

Sub-option PREFERRED_DSS (code 6) contains an array of up to 5 IPv4 addresses (each 4 bytes) of NetWare Domain SAP/RIP Servers (DSS). Maximum length is 20 bytes.

protocol-element §3

Sub-option PRIMARY_DSS (code 11) has length 4 and contains a single IPv4 address identifying the Primary Domain SAP/RIP Service server (DSS) for the NetWare/IP domain.

security-consideration §5

DHCP provides no authentication or security mechanisms. Unauthorized DHCP servers can use NetWare/IP options 62 and 63 to misconfigure NetWare/IP clients with potentially disruptive information.

security

wire-format §2

Option 62 encoding: code byte (62), length byte (n), followed by n ASCII character bytes representing the NetWare/IP domain name.

wire-format §3

Option 63 sub-options are encoded sequentially: each sub-option has a one-byte code, one-byte length, and variable-length value. The option 63 'len' field covers the total length of all sub-option code, length, and value bytes.