sys/man/8/dhcpd

   1 .TH DHCPD 8
   2 .SH NAME
   3 dhcpd, dhcp6d, dhcpleases, rarpd, tftpd \- Internet booting
   4 .SH SYNOPSIS
   5 .PP
   6 .B ip/dhcpd
   7 .RB [ -dmnprsSZ ]
   8 .RB [ -f
   9 .IR ndb-file ]
  10 .RB [ -M
  11 .IR secs ]
  12 .RB [ -x
  13 .IR netmtpt ]
  14 .RB [ -Z
  15 .IR secs ]
  16 [
  17 .I address
  18 .I n
  19 ] ...
  20 .PP
  21 .B ip/dhcpleases
  22 .PP
  23 .B ip/dhcp6d
  24 .RB [ -d ]
  25 .RB [ -f
  26 .IR ndb-file ]
  27 .RB [ -x
  28 .IR netmtpt ]
  29 .PP
  30 .B ip/rarpd
  31 .RB [ -d ]
  32 .RB [ -e
  33 .IR etherdev ]
  34 .RB [ -x
  35 .IR netmtpt ]
  36 .PP
  37 .B ip/tftpd
  38 .RB [ -dr ]
  39 .RB [ -h
  40 .IR homedir ]
  41 .RB [ -x
  42 .IR netmtpt ]
  43 .SH DESCRIPTION
  44 These programs support booting over the Internet.
  45 They should all be run on the same server to
  46 allow other systems to be booted.
  47 .IR Dhcpd ,
  48 .I dhcp6d
  49 and
  50 .I tftpd
  51 are used to boot everything;
  52 .I rarpd
  53 is an extra piece just for Suns.
  54 .PP
  55 .I Dhcpd
  56 runs the
  57 .SM BOOTP
  58 and
  59 .SM DHCP
  60 protocols.
  61 Clients use these protocols to obtain configuration information.
  62 This information comes from attribute/value pairs in the network database
  63 (see
  64 .IR ndb (6)
  65 and
  66 .IR ndb (8)).
  67 DHCP requests are honored both for static addresses found in
  68 the NDB and for dynamic addresses listed in the command line.
  69 DHCP requests are honored if either:
  70 .br
  71 \- there exists an NDB entry
  72 containing both the ethernet address of the requester and
  73 an IP address on the originating network or subnetwork.
  74 .br
  75 \- a free dynamic address exists on the originating network or subnetwork.
  76 .PP
  77 A BOOTP request is honored if all of the following are true:
  78 .br
  79 \- there exists an NDB entry
  80 containing both the ethernet address of the requester and
  81 an IP address on the originating network or subnetwork.
  82 .br
  83 \- the entry contains a
  84 .B bootf=
  85 attribute
  86 .br
  87 \- the file in the
  88 .B bootf=
  89 attribute is readable.
  90 .PP
  91 Dynamic addresses are specified on the command line as a list
  92 of addresses and number pairs.
  93 For example,
  94 .EX
  95         ip/dhcpd 10.1.1.12 10 10.2.1.70 12
  96 .EE
  97 directs
  98 .I dhcpd
  99 to return dynamic addresses 10.1.1.12 through 10.1.1.21 inclusive
 100 and 10.2.1.70 through 10.2.1.81 inclusive.
 101 .PP
 102 .I Dhcpd
 103 maintains a record of all dynamic addresses in the directory
 104 .BR /lib/ndb/dhcp ,
 105 one file per address.
 106 If multiple servers have access to this common directory,
 107 they will correctly coordinate their actions.
 108 .PP
 109 Attributes come from either the NDB entry for the system, the entry for its
 110 subnet, or the entry for its network.  The system entry has precedence,
 111 then the subnet, then the network.
 112 The NDB attributes used are:
 113 .TF ipmask
 114 .TP
 115 .B ip
 116 the IP address
 117 .TP
 118 .B ipmask
 119 the IP mask
 120 .TP
 121 .B ipgw
 122 the default IP gateway
 123 .TP
 124 .B dom
 125 the domain name of the system
 126 .TP
 127 .B fs
 128 the default Plan 9 file server
 129 .TP
 130 .B auth
 131 the default Plan 9 authentication server
 132 .TP
 133 .B dns
 134 a domain name server
 135 .TP
 136 .B ntp
 137 a network time protocol server
 138 .TP
 139 .B time
 140 a time server
 141 .TP
 142 .B wins
 143 a
 144 .SM NETBIOS
 145 name server
 146 .TP
 147 .B www
 148 a World Wide Web proxy
 149 .TP
 150 .B pop3
 151 a POP3 mail server
 152 .TP
 153 .B smtp
 154 an SMTP mail server
 155 .TP
 156 .B bootf
 157 the default boot file;
 158 see
 159 .IR ndb (6)
 160 .PD
 161 .PP
 162 .I Dhcpd
 163 will answer
 164 .SM BOOTP
 165 requests only if it has been specifically targeted or if it
 166 has read access to the boot file for the requester.  That means that the requester
 167 must specify a boot file in the request or one has to exist in NDB for
 168 .I dhcpd
 169 to answer.
 170 .I Dhcpd
 171 will answer all
 172 .SM DHCP
 173 requests for which it can associate an IP address with the
 174 requester.
 175 The options are:
 176 .TP
 177 .B d
 178 Print debugging to standard output.
 179 .TP
 180 .B f
 181 Specify a file other than
 182 .B /lib/ndb/local
 183 as the network database.
 184 .TP
 185 .B m
 186 Mute: don't reply to requests, just log them and what
 187 .I dhcpd
 188 would have done.
 189 .TP
 190 .B M
 191 Use
 192 .I secs
 193 as the minimum lease time for dynamic addresses.
 194 .TP
 195 .B n
 196 Don't answer
 197 .SM BOOTP
 198 requests.
 199 .TP
 200 .B p
 201 Answer
 202 .SM DHCP
 203 requests from
 204 .SM PPTP
 205 clients only.
 206 .TP
 207 .B r
 208 Mute static addresses: don't reply to requests for static addresses,
 209 just log them and what
 210 .I dhcpd
 211 would have done.
 212 .TP
 213 .B s
 214 Sleep 2 seconds before answering requests for static addresses.
 215 This is used to make a server be a backup only.
 216 .TP
 217 .B S
 218 Sleep 2 seconds before answering requests for dynamic addresses.
 219 .TP
 220 .B x
 221 The IP stack to use is mounted at
 222 .IR netmtpt .
 223 The default is
 224 .BR /net .
 225 .TP
 226 .B Z
 227 Use
 228 .I secs
 229 as the minimum lease time for static addresses.
 230 .PD
 231 .PP
 232 .I Dhcp6d
 233 provides DHCPv6 service for IPv6 clients. Only network boot and
 234 DNS parameters are supported.
 235 .PP
 236 .I Dhcpleases
 237 prints out the currently valid DHCP leases found in the
 238 .B /lib/ndb/dhcp
 239 directory.
 240 .PP
 241 .I Rarpd
 242 performs the Reverse Address Resolution Protocol, translating
 243 Ethernet addresses into IP addresses.
 244 The options are:
 245 .TP
 246 .B d
 247 Print debugging to standard output.
 248 .TP
 249 .B e
 250 Use the Ethernet mounted at
 251 .BI /net/ etherdev\f1.
 252 .TP
 253 .B x
 254 The IP stack to use is mounted at
 255 .IR netmtpt .
 256 The default is
 257 .BR /net .
 258 .PD
 259 .PP
 260 .I Tftpd
 261 transfers files to systems that are booting.
 262 It runs as user
 263 .B none
 264 and can only access files with global read permission.
 265 The options are:
 266 .TP
 267 .B d
 268 Print debugging to standard output.
 269 .TP
 270 .B x
 271 The IP stack to use is mounted at
 272 .IR netmtpt .
 273 The default is
 274 .BR /net .
 275 .TP
 276 .B h
 277 Change directory to
 278 .IR homedir .
 279 The default is
 280 .BR /lib/tftpd .
 281 All requests for files with non-rooted file names are served starting at this
 282 directory.
 283 .I Tftpd
 284 supports only octet mode.
 285 .TP
 286 .B r
 287 Restricts access to only those files rooted in the
 288 .IR homedir .
 289 .PD
 290 .SH FILES
 291 .BR /lib/ndb/dhcp "    directory of dynamic address files
 292 .SH SOURCE
 293 .B /sys/src/cmd/ip
 294 .SH "SEE ALSO"
 295 .IR ndb (6),
 296 .IR booting (8)