NAME

ip/dhcpd [ -ds ] [ -f ndbfile ] [ -x net ] [ ipaddr n ... ]

DESCRIPTION

Dhcpd serves the BOOTP protocol, and DHCP extensions.

Options:


-f ndbfile
Read configuration from ndbfile instead of the default /lib/ndb/local.
-x net
Serve on net instead of the default /net.
-d
Print debug information.
-s
Only listen for and print requests, don't respond to them.

Bootp clients need an explicit ether entry in the ndb file. Dhcp clients may have an explicit ether entry. Clients that are not explicitly configured will receive an available address from the dynamic address pool. The pool is specified by parameters to dhcpd, with zero or more pairs of ipaddr and n, the first ip address of a range and the number of addresses. Leases are recorded in /services/dhcpd/, each leased ip address is stored in a file named after the ip address. Files in /services/dhcpd/ are read at start up, to ensure leases survive restarts dhcpd and clients receive the same ip addresses as long as the pool has unused addresses.

Clients request an ip address and accompanying configuration (e.g. gateway, dns servers). Dhcpd consults the ndb file for the following options: ipmask, ipgw, dns, sys, dnsdomain, bootf, rootpath, leasetime, nextserver. Ndb(6) defines most of them. Rootpath is used by clients with a network file system as root. Leasetime is the DHCP lease time, it defaults to one day. Nextserver is the server to continue booting from, typically a tftp server that serves a kernel.

Attributes are resolved by first looking for entries that exactly match the IP address. Ipnet entries are consulted for the remaining options, most specific ipmask first.

EXAMPLE

The following is a snippet from a /lib/ndb/local:
	ipnet=lan ip=192.168.1.0 ipmask=255.255.255.0
		ipgw=192.168.1.254
		dnsdomain=lan
		dns=192.168.1.254
		nextserver=192.168.1.1

	ip=192.168.1.1 sys=narf
	ip=192.168.1.10 sys=laser
	ip=192.168.1.11 sys=wrt54gl

	ip=192.168.1.33 ether=000ae43623bc sys=dis
	ip=192.168.1.34 ether=000ae4269c38 sys=bad
		bootf=9pxeload
	ip=192.168.1.35 ether=000ae432664c sys=yeah
	ip=192.168.1.50 ether=00504301c7d5 sys=sheeva0
		bootf=sheeva0

SOURCE

/appl/cmd/ip/dhcpd.b

FILES

/services/dhcpd/

SEE ALSO

ndb(6), dhcp(8)
Internet RFCs RFC951, RFC1542, RFC2131, RFC2132

BUGS

Only DHCPv4 support is implemented.

DHCPD(8 ) Rev:  Thu Jun 18 16:20:17 GMT 2009