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 information comes from attribute/value pairs in the network database (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 specifically targeted or if it has read access to the boot file for the requester.  That means that the requester must specify 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. 

­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 permission.  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 kernel boot files where ­xxxxxxxx is the hex IP address of the machine requesting the kernel and ­yy is an architecture 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.

SOURCE

­/sys/src/cmd/ip

SEE ALSO

ndb(6)

Plan 9  —  March 27, 2001