Index Index for
Section 4
Index Alphabetical
listing for D
Bottom of page Bottom of
page

dhcptags(4)

NAME

dhcptags - DHCP and BOOTP server database

DESCRIPTION

Parameters (or options) returned to the client by the DHCP/BOOTP protocol are encoded in the so-called vendor field of the BOOTP packet. Each option is identified numerically, and also carries a length specifier. The dhcptags file identifies the type of each option, labels each with a short mnemonic text string for use in the dhcpcap database, and provides a description of each for use in the xjoin program. Options defined by DHCP are of three general types: Standard: The semantics of which all client and server DHCP implementations agree upon. These are administered by the Internet Assigned Numbers Authority (IANA). These options are numbered from 1 to 127 and 255. Site-specific: Within a specific site all client and server implementations agree as to the semantics, but at another site the type and meaning of an option may be quite different. These options are numbered from 128 to 254. Vendor-specific: Each vendor may define 256 options unique to that vendor. The vendor is identified within a DHCP packet by the "Vendor Class" option (#60). An option with a specific numeric identifier belonging to one vendor will, in general, have a type and semantics different from those of another vendor. Vendor options are "super-encapsulated" into the vendor field (#43): within a specific DHCP packet there may be several instances of option #43. As well as these, the DHCP implementation defines certain "pseudo" options, numbered from 512 upward. These are used by the server to identify items in its database which either correspond to fixed fields in the BOOTP packet (such as the "siaddr" field) or which though not options themselves are used in constructing valid options. For example, the "home directory" used in constructing the exact path to a boot image. In general, the joind server knows little about the semantics of any of the first three types of options. Its only duty is to deliver those values to clients that need them. The responsibility for understanding and using the data rests with the client. Pseudo-tags, on the contrary, have a meaning specific to joind, and consequently are not added to this list. The only useful edit that can be performed on the pseudo-tags is to change the description or the mnemonic.

FORMAT

Blank lines and those whose first nonwhitespace character is '#' are ignored. Data entries are written one per line and have seven fields. An individual entry cannot be continued onto another line. The fields are (in order): · The tag number · Identifier as used in bootptab file · Grouping in GUI · Vendor class · Data type. Choose from the following (case insensitive) list: byte octet int1 A 1-byte value int2 A 2-byte value int4 A 4-byte value string A printable character string ip An IP address iplist A list of IP addresses int2list A list of 2-byte values opaque A array of 1-byte values boolean Either true or false · Column grouping in GUI · Long name Tag List The currently recognized /etc/join/dhcptags tags are: as Maximum reassembly size at Arp timeout ba Broadcast address of network bf Boot file br Be a router bs Boot file size (512 octet blocks) bw Netbios name servers bx Netbios datagram distribution servers by Netbios node type bz Netbios scope cb Path to join client binary cs Cookie servers ct Class type df Dump file dn DNS domain name ds Domain name servers ef Encapsulate flavor ep Path of the extensions file fn Forward nonlocal datagrams gw Gateways (IP rosters) ha Hardware address hd Home directory hn Send host name ho Host name ht Hardware type id Client id im Impress servers ip Host or network IP address it IP TTL ki Keep alive interval ko Keep alive octet lg Log servers lp LPR servers lt Lease time md Perform mask discovery mf Publicly mountable file systems ms Supply masks ns IEN-116 name servers nt NTP (network time protocol) servers pf Policy filters pl PMTU plateaus pr Printcap setup ps SVR4 printer setup pt PMTU timeout ra Reply address override rd Do route discovery rl Resource location protocol servers rp Root path rs Solicit routes sa TFTP server address (used by clients) si Boot server address sl Subnets are local sm Subnet mask (host) sr Static routes ss Name service switch sw Swap server address t1 DHCP T1 t2 DHCP T2 tc Template host (points to similar host entry) td TFTP root directory (used by secure TFTP server) to Time offset (seconds) tr Trailers ts Time servers tt TCP TTL tu MTU vm Vendor magic cookie selector wd Netware domain name wo Netware options xd X display managers xf X font servers yd NIS domain ys NIS map servers zd NIS+ domain zs NIS+ map servers There is also a generic tag, Tn, where n is an RFC 1533 vendor field tag number. Thus it is possible to immediately take advantage of future extensions to RFC 1533 without being required to modify the DHCP server (joind). Generic data may be represented as either a stream of hexadecimal numbers or as a quoted string of ASCII characters. The length of the generic data is automatically determined and inserted into the proper field(s) of the RFC 1533-style BOOTP and DHCP reply.

FILES

/etc/join/dhcptags DHCP server database

RELATED INFORMATION

Commands: dhcpparm(8), joind(8). Files: bootptab(4), DARPA Internet Request For Comments RFC 1533, RFC 1541, Assigned Numbers

Index Index for
Section 4
Index Alphabetical
listing for D
Top of page Top of
page