
BOOTP AND DHCP PARAMETERS

(last updated 2003-04-28)

The Bootstrap Protocol (BOOTP) [RFC951] describes an IP/UDP bootstrap
protocol (BOOTP) which allows a diskless client machine to discover
its own IP address, the address of a server host, and the name of a
file to be loaded into memory and executed.  The Dynamic Host
Configuration Protocol (DHCP) [RFC2131] provides a framework for
automatic configuration of IP hosts.  The "DHCP Options and BOOTP
Vendor Information Extensions" [RFC2132] describes the additions to
the Bootstrap Protocol (BOOTP) which can also be used as options with
the Dynamic Host Configuration Protocol (DHCP).  

BCP 29, RFC 2489, "Procedure for Defining New DHCP Options" [RFC2489],
describes the procedure for defining new DHCP options.  This new
procedure provides guidance to IANA in the assignment of new option
codes.  The DHCP option number space (1-254) is split into two parts.
The site-specific options (128-254) are defined as "Private Use" and
require no review by the DHC WG.  The public options (1-127) are
defined as "Specification Required" and new options must be reviewed
prior to assignment of an option number by IANA.


BOOTP Vendor Extensions and DHCP Options are listed below:

                                  Data 
   Tag     Name                  Length  Meaning          
   ---     ----                  ------  -------          
    0      Pad                      0    None                          [RFC2132]    
    1      Subnet Mask              4    Subnet Mask Value             [RFC2132] 
    2      Time Offset              4    Time Offset in                [RFC2132] 
                                         Seconds from UTC 
    3      Router                   N    N/4 Router addresses          [RFC2132] 
    4      Time Server              N    N/4 Timeserver addresses      [RFC2132] 
    5      Name Server              N    N/4 IEN-116 Server addresses  [RFC2132] 
    6      Domain Server            N    N/4 DNS Server addresses      [RFC2132] 
    7      Log Server               N    N/4 Logging Server addresses  [RFC2132] 
    8      Quotes Server            N    N/4 Quotes Server addresses   [RFC2132] 
    9      LPR Server               N    N/4 Printer Server addresses  [RFC2132] 
   10      Impress Server           N    N/4 Impress Server addresses  [RFC2132] 
   11      RLP Server               N    N/4 RLP Server addresses      [RFC2132] 
   12      Hostname                 N    Hostname string               [RFC2132] 
   13      Boot File Size           2    Size of boot file in 512 byte [RFC2132] 
                                         chunks 
   14      Merit Dump File          N    Client to dump and name       [RFC2132] 
                                         the file to dump it to 
   15      Domain Name              N    The DNS domain name of the    [RFC2132] 
                                         client 
   16      Swap Server              N    Swap Server addeess           [RFC2132] 
   17      Root Path                N    Path name for root disk       [RFC2132] 
   18      Extension File           N    Path name for more BOOTP info [RFC2132] 
   19      Forward On/Off           1    Enable/Disable IP Forwarding  [RFC2132] 
   20      SrcRte On/Off            1    Enable/Disable Source Routing [RFC2132] 
   21      Policy Filter            N    Routing Policy Filters        [RFC2132] 
   22      Max DG Assembly          2    Max Datagram Reassembly Size  [RFC2132] 
   23      Default IP TTL           1    Default IP Time to Live       [RFC2132] 
   24      MTU Timeout              4    Path MTU Aging Timeout        [RFC2132] 
   25      MTU Plateau              N    Path MTU  Plateau Table       [RFC2132] 
   26      MTU Interface            2    Interface MTU Size            [RFC2132] 
   27      MTU Subnet               1    All Subnets are Local         [RFC2132] 
   28      Broadcast Address        4    Broadcast Address             [RFC2132] 
   29      Mask Discovery           1    Perform Mask Discovery        [RFC2132] 
   30      Mask Supplier            1    Provide Mask to Others        [RFC2132] 
   31      Router Discovery         1    Perform Router Discovery      [RFC2132] 
   32      Router Request           4    Router Solicitation Address   [RFC2132] 
   33      Static Route             N    Static Routing Table          [RFC2132] 
   34      Trailers                 1    Trailer Encapsulation         [RFC2132] 
   35      ARP Timeout              4    ARP Cache Timeout             [RFC2132] 
   36      Ethernet                 1    Ethernet Encapsulation        [RFC2132] 
   37      Default TCP TTL          1    Default TCP Time to Live      [RFC2132] 
   38      Keepalive Time           4    TCP Keepalive Interval        [RFC2132] 
   39      Keepalive Data           1    TCP Keepalive Garbage         [RFC2132] 
   40      NIS Domain               N    NIS Domain Name               [RFC2132] 
   41      NIS Servers              N    NIS Server Addresses          [RFC2132] 
   42      NTP Servers              N    NTP Server Addresses          [RFC2132] 
   43      Vendor Specific          N    Vendor Specific Information   [RFC2132] 
   44      NETBIOS Name Srv         N    NETBIOS Name Servers          [RFC2132] 
   45      NETBIOS Dist Srv         N    NETBIOS Datagram Distribution [RFC2132] 
   46      NETBIOS Node Type        1    NETBIOS Node Type             [RFC2132] 
   47      NETBIOS Scope            N    NETBIOS Scope                 [RFC2132] 
   48      X Window Font            N    X Window Font Server          [RFC2132] 
   49      X Window Manager         N    X Window Display Manager      [RFC2132] 
   50      Address Request          4    Requested IP Address          [RFC2132] 
   51      Address Time             4    IP Address Lease Time         [RFC2132] 
   52      Overload                 1    Overload "sname" or "file"    [RFC2132] 
   53      DHCP Msg Type            1    DHCP Message Type             [RFC2132] 
   54      DHCP Server Id           4    DHCP Server Identification    [RFC2132] 
   55      Parameter List           N    Parameter Request List        [RFC2132] 
   56      DHCP Message             N    DHCP Error Message            [RFC2132] 
   57      DHCP Max Msg Size        2    DHCP Maximum Message Size     [RFC2132] 
   58      Renewal Time             4    DHCP Renewal (T1) Time        [RFC2132] 
   59      Rebinding Time           4    DHCP Rebinding (T2) Time      [RFC2132] 
   60      Class Id                 N    Class Identifier              [RFC2132] 
   61      Client Id                N    Client Identifier             [RFC2132] 
   62      Netware/IP Domain        N    Netware/IP Domain Name        [RFC2242] 
   63      Netware/IP Option        N    Netware/IP sub Options        [RFC2242] 
   64      NIS-Domain-Name          N    NIS+ v3 Client Domain Name    [RFC2132] 
   65      NIS-Server-Addr          N    NIS+ v3 Server Addresses      [RFC2132] 
   66      Server-Name              N    TFTP Server Name              [RFC2132] 
   67      Bootfile-Name            N    Boot File Name                [RFC2132] 
   68      Home-Agent-Addrs         N    Home Agent Addresses          [RFC2132] 
   69      SMTP-Server              N    Simple Mail Server Addresses  [RFC2132] 
   70      POP3-Server              N    Post Office Server Addresses  [RFC2132] 
   71      NNTP-Server              N    Network News Server Addresses [RFC2132] 
   72      WWW-Server               N    WWW Server Addresses          [RFC2132] 
   73      Finger-Server            N    Finger Server Addresses       [RFC2132] 
   74      IRC-Server               N    Chat Server Addresses         [RFC2132] 
   75      StreetTalk-Server        N    StreetTalk Server Addresses   [RFC2132] 
   76      STDA-Server              N    ST Directory Assist. Addresses[RFC2132] 
   77      User-Class               N    User Class Information        [RFC3004] 
   78      Directory Agent          N    directory agent information   [RFC2610] 
   79      Service Scope            N    service location agent scope  [RFC2610] 
   80      Naming Authority         N    naming authority 
   81      Client FQDN              N    Fully Qualified Domain Name   [DRAFT-IETF-DHC-FQDN-OPTION] 
   82      Relay Agent Information  N    Relay Agent Information       [RFC3046] 
   83      Agent Remote ID          N    Agent Remote ID               
   84      Agent Subnet Mask        N    Agent Subnet Mask             
   85      NDS Servers              N    Novell Directory Services     [RFC2241] 
   86      NDS Tree Name            N    Novell Directory Services     [RFC2241] 
   87      NDS Context              N    Novell Directory Services     [RFC2241] 
   88      IEEE 1003.1 POSIX        N    IEEE 1003.1 POSIX Timezone 
   89      FQDN                     N    Fully Qualified Domain Name 
   90      Authentication           N    Authentication                [RFC3118] 
   91      Vines TCP/IP             N    Vines TCP/IP Server Option 
   92      Server Selection         N    Server Selection Option 
   93      Client System            N    Client System Architecture 
   94      Client NDI               N    Client Network Device Interface 
   95      LDAP                     N    Lightweight Directory Access Protocol 
   96      IPv6 Transitions         N    IPv6 Transitions 
   97      UUID/GUID                N    UUID/GUID-based Client Identifier 
   98      User-Auth                N    Open Group's User Authentication [RFC2485] 
   99      Unassigned 
   100     Printer Name             N    Printer Name 
   101     MDHCP                    N    DHCP multicast address 
   102-107 REMOVED/Unassigned 
   108     Swap Path                N    Swap Path Option 
   109     Unassigned 
   110     IPX Compatability        N    IPX Compatability 
   111     Unassigned 
   112     Netinfo Address          N    NetInfo Parent Server Address 
   113     Netinfo Tag              N    NetInfo Parent Server Tag 
   114     URL                      N    URL 
   115     Failover                 N    DHCP Failover Protocol 
   116     Auto-Config              N    DHCP Auto-Configuration       [RFC2563] 
   117     Name Service Search      N    Name Service Search           [RFC2937] 
   118     Subnet Selection Option  4    Subnet Selection Option       [RFC3011] 
   119     Domain Search            N    DNS domain serach list        [RFC3397] 
   120     SIP Servers DHCP Option  N    SIP Servers DHCP Option       [RFC3361] 
   121     Classless Static Route   N    Classless Static Route Option [RFC3442] 
           Option 
   122     CCC                      N    CableLabs Client Configuration [RFC3495]
   123-125 Unassigned 
   126     Extension                N    Extension 
   127     Extension                N    Extension 
   128-254 Private Use 
   255     End                      0    None                          [RFC2132] 


DHCP Message Type 53 Values

Value   Message Type   		Reference
-----   ------------   		---------
    1   DHCPDISCOVER   		[RFC2132]
    2   DHCPOFFER               [RFC2132]
    3   DHCPREQUEST             [RFC2132]
    4   DHCPDECLINE             [RFC2132]
    5   DHCPACK                 [RFC2132]
    6   DHCPNAK                 [RFC2132]
    7   DHCPRELEASE             [RFC2132]
    8   DHCPINFORM              [RFC2132]
    9   DHCPFORCERENEW          [RFC3203]

Network/IP Option Type 63 Sub-Option Codes

Value   Message Type                Reference
-----   ------------                ---------
    1   NWIP_DOES_NOT_EXIST         [RFC2242] 
    2   NWIP_EXIST_IN_OPTIONS_AREA  [RFC2242]
    3   NWIP_EXIST_IN_SNAME_FILE    [RFC2242]
    4   NWIP_EXIST_BUT_TOO_BIG      [RFC2242]
    5   NSQ_BROADCAST               [RFC2242]
    6   PREFERRED_DSS               [RFC2242]
    7   NEAREST_NWIP_SERVER         [RFC2242]
    8   AUTORETRIES                 [RFC2242]
    9   AUTORETRY_SECS              [RFC2242]
   10   NWIP_1_1                    [RFC2242]
   11   PRIMARY_DSS                 [RFC2242]

DHCP Cablelabs Client Configuration Option Type 122 Sub-Option Codes per [RFC3495]

Code    Sub-Option Description                   Reference 
-----   -----------------------                  --------- 
    1   TSP's Primary DHCP Server Address        [RFC3495] 
    2   TSP's Secondary DHCP Server Address      [RFC3495] 
    3   TSP's Provisioning Server Address        [RFC3495]
    4   TSP's AS-REQ/AS-REP Backoff and Retry    [RFC3495]
    5   TSP's AP-REQ/AP-REP Backoff and Retry    [RFC3495]
    6   TSP's Kerberos Realm Name                [RFC3495]
    7   TSP's Ticket Granting Server Utilization [RFC3495]
    8   TSP's Provisioning Timer Value           [RFC3495]
9-255   Reserved for future extensions

DHCP Agent Sub-Option Codes  per [RFC3046]

Code    Sub-Option Description                 Reference
-----   -----------------------                ---------
    1   Agent Circuit ID Sub-option            [RFC3046]
    2   Agent Remote ID Sub-option             [RFC3046]
    3   Sub-option 3 is reserved and should      [Droms]
        not be assigned at this time;
        proprietary and incompatible usages
        of this sub-option value have been
        seen limited deployment.
    4   DOCSIS Device Class Suboption          [RFC3256]
    5   Link selection Sub-option              [RFC3527]


REFERENCES
----------

[RFC951]  Croft, B., and J. Gilmore, "BOOTSTRAP Protocol (BOOTP)",
          RFC-951, Stanford and SUN Microsytems, September 1985.

[RFC2131]  Droms, R., "Dynamic Host Configuration Protocol", Bucknell
           University, March 1997.

[RFC2132]  Alexander, S., and R. Droms, "DHCP Options and BOOTP Vendor
           Extensions", Silicon Graphics, Inc., Bucknell University,
           March 1997.

[RFC2241]  D. Provan, "DHCP Options for Novell Directory Services", 
           RFC 2241, November 1997.

[RFC2242]  R. Droms and K. Fong, "NetWare/IP Domain Name and 
           Information", RFC 2242, November 1997.

[RFC2485]  S. Drach, "DHCP Option for The Open Group's User Authentication 
           Protocol", RFC 2485, January 1999.

[RFC2489]  Droms, R., "Procedure for Defining New DHCP Options",
           BCP 29, RFC 2489, January 1999.

[RFC2563]  R. Troll, "DHCP Option to Disable Stateless Auto-Configuration 
           in IPv4 Clients, RFC 2563, May 1999.

[RFC2610]  C. Perkins and E. Guttman, "DHCP Options for Service Location 
           Protocol", RFC 2610, June 1999.

[RFC2937]  C. Smith, "The Name Service Search Option for DHCP", RFC 2937,
           September 2000.

[RFC3004]  G. Stump, R. Droms, Y. Gu, R. Vyaghrapuri, A. Demirtjis, 
           B. Beser, and J. Privat, "The User Class Option for DHCP", 
           RFC 3004, November 2000.

[RFC3011]  G. Waters, "The IPv4 Subnet Selection Option for DHCP",
           RFC 3011, November 2000.  

[RFC3046]  M. Patrick, "DHCP Relay Agent Information Option", 
           RFC 3046, January 2001.

[RFC3118]  R. Droms and W. Arbaugh, "Authentication for DHCP Messages",
           RFC 3118, June 2001.

[RFC3203]  Y. T'Jones, C. Hublet, and P. De Schrijver, "DHCP 
           Reonfigure Extension", RFC 3203, December 2001.

[RFC3256]  D. Jones and R. Woundy, "The DOCSIS Device Class DHCP 
           Relay Agent Information Sub-option", RFC 3256,
           April 2002.

[RFC3361]  H. Schulzrinne, "DHCPv4 Option for SIP Servers", RFC 3361,
           August 2002.

[RFC3397]  B. Aboba and S. Cheshire, "Dynamic Host Configuration Protocol 
           (DHCP) Domain Search Option", RFC 3397, November 2002.

[RFC3442]  T. Lemon, S. Cheshire, and B. Volz, "The Classless Static 
           Route Option for DHCPv4", RFC 3442, December 2002.

[RFC3495]  B. Beser and P. Duffy, "DHCP Option for CableLabs Client 
           Configuration", RFC 3495, March 2003.

[RFC3527]  K. Kinnear, M. Stapp, R. Johnson, and J. Kumarasamy, 
           "Link Selection sub-option for the Relay Agent Information 
           Option for DHCPv4", RFC 3527, April 2003.
PEOPLE
------

[Droms]  Ralph Droms, <rdroms@cisco.com>, January 2001.

[]









