DHCPD(8) DHCPD(8)
NAME
dhcpd, rarpd, tftpd - Internet booting
SYNOPSIS
ip/dhcpd [-mdsnp] [-f ndb-file] [-x netmtpt] [-M secs]
ip/rarpd [-d] [-e etherdev] [-x netmtpt]
ip/tftpd [-dr] [-h homedir] [-x netmtpt]
DESCRIPTION
These programs support booting over the Internet. They
should all be run on the same server to allow other systems
to be booted. Dhcpd and tftpd are used to boot everything;
rarpd is an extra piece just for Suns.
Dhcpd runs the BOOTP and DHCP protocols. Clients use these
protocols to obtain configuration information. This infor-
mation comes from attribute/value pairs in the network data-
base (see ndb(6) and ndb(8)). Attributes come from either
the NDB entry for the system, the entry for its subnet, or
the entry for its network. The system entry has precedence,
then the subnet, then the network. The NDB attributes used
are:
ip the IP address
ipmask the IP mask
ipgw the default IP gateway
dom the domain name of the system
fs the default Plan 9 name server
auth the default Plan 9 authentication server
dns a domain name server
ntp a network time protocol server
time a time server
wins a NETBIOS name server
www a World Wide Web proxy
pop3 a POP3 mail server
smtp an SMTP mail server
bootf the default boot file
Dhcpd will answer BOOTP requests only if it has been specif-
ically targeted or if it has read access to the boot file
for the requester. That means that the requester must spec-
ify a boot file in the request or one has to exist in NDB
for dhcpd to answer. Dhcpd will answer all DHCP requests
for which it can associate an IP address with the requester.
The options are:
d Print debugging to standard output.
Page 1 Plan 9 (printed 11/30/25)
DHCPD(8) DHCPD(8)
m Mute: don't reply to requests, just log them and what
dhcpd would have done.
f Specify a file other than /lib/ndb/local as the network
database.
s Sleep 2 seconds before answering requests. This is
used to make a server be a backup only.
n Don't answer BOOTP requests.
p Answer DHCP requests from PPTP clients only.
x The IP stack to use is mounted at netmtpt. The default
is /net.
M Use secs as the minimum lease time.
Rarpd performs the Reverse Address Resolution Protocol,
translating Ethernet addresses into IP addresses. The
options are:
d Print debugging to standard output.
e Use the Ethernet mounted at /net/etherdev.
x The IP stack to use is mounted at netmtpt. The default
is /net.
Tftpd transfers files to systems that are booting. It runs
as user none and can only access files with global read per-
mission. The options are:
d Print debugging to standard output.
x The IP stack to use is mounted at netmtpt. The default
is /net.
h Change directory to homedir. The default is /lib/tftpd.
All requests for files with non-rooted file names are
served starting at this directory with the exception of
files of the form xxxxxxxx.SUNyy. These are Sparc ker-
nel boot files where xxxxxxxx is the hex IP address of
the machine requesting the kernel and yy is an archi-
tecture identifier. Tftpd looks up the file in the
network database using ipinfo (see ndb(2)) and responds
with the boot file specified for that particular
machine. If no boot file is specified, the transfer
fails. Tftpd supports only octet mode.
r Restricts access to only those files rooted in the
homedir.
Page 2 Plan 9 (printed 11/30/25)
DHCPD(8) DHCPD(8)
SOURCE
/sys/src/cmd/ip
SEE ALSO
ndb(6)
Page 3 Plan 9 (printed 11/30/25)