| blob | 9d148d446bb3ef9e39644b0a13c01803a1d0b58b |
1 .\" $NetBSD: dhcpcd.8.in,v 1.44 2015/08/21 10:39:00 roy Exp $
2 .\" Copyright (c) 2006-2015 Roy Marples
3 .\" All rights reserved
4 .\"
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
7 .\" are met:
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
13 .\"
14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 .\" SUCH DAMAGE.
25 .\"
26 .Dd August 21, 2015
27 .Dt DHCPCD 8
28 .Os
29 .Sh NAME
30 .Nm dhcpcd
31 .Nd a DHCP client
32 .Sh SYNOPSIS
33 .Nm
34 .Op Fl 46ABbDdEGgHJKLMpqTV
35 .Op Fl C , Fl Fl nohook Ar hook
36 .Op Fl c , Fl Fl script Ar script
37 .Op Fl e , Fl Fl env Ar value
38 .Op Fl F , Fl Fl fqdn Ar FQDN
39 .Op Fl f , Fl Fl config Ar file
40 .Op Fl h , Fl Fl hostname Ar hostname
41 .Op Fl I , Fl Fl clientid Ar clientid
42 .Op Fl i , Fl Fl vendorclassid Ar vendorclassid
43 .Op Fl j , Fl Fl logfile Ar logfile
44 .Op Fl l , Fl Fl leasetime Ar seconds
45 .Op Fl m , Fl Fl metric Ar metric
46 .Op Fl O , Fl Fl nooption Ar option
47 .Op Fl o , Fl Fl option Ar option
48 .Op Fl Q , Fl Fl require Ar option
49 .Op Fl r , Fl Fl request Ar address
50 .Op Fl S , Fl Fl static Ar value
51 .Op Fl s , Fl Fl inform Ar address Ns Op Ar /cidr
52 .Op Fl t , Fl Fl timeout Ar seconds
53 .Op Fl u , Fl Fl userclass Ar class
54 .Op Fl v , Fl Fl vendor Ar code , Ar value
55 .Op Fl W , Fl Fl whitelist Ar address Ns Op Ar /cidr
56 .Op Fl w
57 .Op Fl Fl waitip Op 4 | 6
58 .Op Fl y , Fl Fl reboot Ar seconds
59 .Op Fl X , Fl Fl blacklist Ar address Ns Op Ar /cidr
60 .Op Fl Z , Fl Fl denyinterfaces Ar pattern
61 .Op Fl z , Fl Fl allowinterfaces Ar pattern
62 .Op interface
63 .Op ...
64 .Nm
65 .Fl n , Fl Fl rebind
66 .Op interface
67 .Nm
68 .Fl k , Fl Fl release
69 .Op interface
70 .Nm
71 .Fl U, Fl Fl dumplease
72 .Ar interface
73 .Nm
74 .Fl Fl version
75 .Nm
76 .Fl x , Fl Fl exit
77 .Op interface
78 .Sh DESCRIPTION
79 .Nm
80 is an implementation of the DHCP client specified in
81 .Li RFC 2131 .
82 .Nm
83 gets the host information
84 .Po
85 IP address, routes, etc
86 .Pc
87 from a DHCP server and configures the network
88 .Ar interface
89 of the
90 machine on which it is running.
91 .Nm
92 then runs the configuration script which writes DNS information to
93 .Xr resolvconf 8 ,
94 if available, otherwise directly to
95 .Pa /etc/resolv.conf .
96 If the hostname is currently blank, (null) or localhost, or
97 .Va force_hostname
98 is YES or TRUE or 1 then
99 .Nm
100 sets the hostname to the one supplied by the DHCP server.
101 .Nm
102 then daemonises and waits for the lease renewal time to lapse.
103 It will then attempt to renew its lease and reconfigure if the new lease
104 changes when the lease beings to expire or the DHCP server sends message
105 to renew early.
106 .Pp
107 If any interface reports a working carrier then
108 .Nm
109 will try and obtain a lease before forking to the background,
110 otherwise it will fork right away.
111 This behaviour can be modified with the
112 .Fl b , Fl Fl background
113 and
114 .Fl w , Fl Fl waitip
115 options.
116 .Pp
117 .Nm
118 is also an implementation of the BOOTP client specified in
119 .Li RFC 951 .
120 .Pp
121 .Nm
122 is also an implementation of the IPv6 Router Solicitor as specified in
123 .Li RFC 4861
124 and
125 .Li RFC 6106 .
126 .Pp
127 .Nm
128 is also an implementation of the IPv6 Privacy Extensions to AutoConf as
129 specified in
130 .Li RFC 4941 .
131 This feature needs to be enabled in the kernel and
132 .Nm
133 will start using it.
134 .Pp
135 .Nm
136 is also an implemenation of the DHCPv6 client as specified in
137 .Li RFC 3315 .
138 By default,
139 .Nm
140 only starts DHCPv6 when instructed to do so by an IPV6 Router Advertisement.
141 If no Identity Association is configured,
142 then a Non-temporary Address is requested.
143 .Ss Local Link configuration
144 If
145 .Nm
146 failed to obtain a lease, it probes for a valid IPv4LL address
147 .Po
148 aka ZeroConf, aka APIPA
149 .Pc .
150 Once obtained it restarts the process of looking for a DHCP server to get a
151 proper address.
152 .Pp
153 When using IPv4LL,
154 .Nm
155 nearly always succeeds and returns an exit code of 0.
156 In the rare case it fails, it normally means that there is a reverse ARP proxy
157 installed which always defeats IPv4LL probing.
158 To disable this behaviour, you can use the
159 .Fl L , Fl Fl noipv4ll
160 option.
161 .Ss Multiple interfaces
162 If a list of interfaces are given on the command line, then
163 .Nm
164 only works with those interfaces, otherwise
165 .Nm
166 discovers available Ethernet interfaces that can be configured.
167 When
168 .Nm
169 is operating on more than one interface,
170 it is called Master mode. and this behaviour can be forced with the
171 .Fl M , Fl Fl master
172 option so that an individual interface can start
173 .Nm
174 but only one instance is running.
175 The
176 .Nm dhcpcd-ui
177 project expects dhcpcd to be running this way.
178 .Pp
179 If a single interface is given then
180 .Nm
181 only works for that interface and runs as a separate instance.
182 The
183 .Fl w , Fl Fl waitip
184 option is enabled in this instance to maintain compatibility with older
185 versions.
186 .Pp
187 Interfaces are preferred by carrier, DHCP lease/IPv4LL and then lowest metric.
188 For systems that support route metrics, each route will be tagged with the
189 metric, otherwise
190 .Nm
191 changes the routes to use the interface with the same route and the lowest
192 metric.
193 See options below for controlling which interfaces we allow and deny through
194 the use of patterns.
195 .Ss Hooking into events
196 .Nm
197 runs
198 .Pa @SCRIPT@ ,
199 or the script specified by the
200 .Fl c , Fl Fl script
201 option.
202 This script runs each script found in
203 .Pa @HOOKDIR@
204 in a lexical order.
205 The default installation supplies the scripts
206 .Pa 01-test ,
207 .Pa 02-dump ,
208 .Pa 10-wpa_supplicant ,
209 .Pa 15-timezone ,
210 .Pa 20-resolv.conf
211 and
212 .Pa 30-hostname .
213 You can disable each script by using the
214 .Fl C , Fl Fl nohook
215 option.
216 See
217 .Xr dhcpcd-run-hooks 8
218 for details on how these scripts work.
219 .Nm
220 currently ignores the exit code of the script.
221 .Ss Fine tuning
222 You can fine-tune the behaviour of
223 .Nm
224 with the following options:
225 .Bl -tag -width indent
226 .It Fl b , Fl Fl background
227 Background immediately.
228 This is useful for startup scripts which don't disable link messages for
229 carrier status.
230 .It Fl c , Fl Fl script Ar script
231 Use this
232 .Ar script
233 instead of the default
234 .Pa @SCRIPT@ .
235 .It Fl D , Fl Fl duid
236 Generate an
237 .Li RFC 4361
238 compliant clientid.
239 This requires persistent storage and not all DHCP servers work with it so it
240 is not enabled by default.
241 .Nm
242 generates the DUID and stores it in
243 .Pa @SYSCONFDIR@/dhcpcd.duid .
244 This file should not be copied to other hosts.
245 .It Fl d , Fl Fl debug
246 Echo debug messages to the stderr and syslog.
247 .It Fl E , Fl Fl lastlease
248 If
249 .Nm
250 cannot obtain a lease, then try to use the last lease acquired for the
251 interface.
252 If the
253 .Fl p, Fl Fl persistent
254 option is not given then the lease is used if it hasn't expired.
255 .It Fl e , Fl Fl env Ar value
256 Push
257 .Ar value
258 to the environment for use in
259 .Xr dhcpcd-run-hooks 8 .
260 For example, you can force the hostname hook to always set the hostname with
261 .Fl e
262 .Va force_hostname=YES .
263 .It Fl g , Fl Fl reconfigure
264 .Nm
265 will re-apply IP address, routing and run
266 .Xr dhcpcd-run-hooks 8
267 for each interface.
268 This is useful so that a 3rd party such as PPP or VPN can change the routing
269 table and / or DNS, etc and then instruct
270 .Nm
271 to put things back afterwards.
272 .Nm
273 does not read a new configuration when this happens - you should rebind if you
274 need that functionality.
275 .It Fl F , Fl Fl fqdn Ar fqdn
276 Requests that the DHCP server updates DNS using FQDN instead of just a
277 hostname.
278 Valid values for
279 .Ar fqdn
280 are disable, none, ptr and both.
281 .Nm
282 itself never does any DNS updates.
283 .Nm
284 encodes the FQDN hostname as specified in
285 .Li RFC1035 .
286 .It Fl f , Fl Fl config Ar file
287 Specify a config to load instead of
288 .Pa @SYSCONFDIR@/dhcpcd.conf .
289 .Nm
290 always processes the config file before any command line options.
291 .It Fl h , Fl Fl hostname Ar hostname
292 Sends
293 .Ar hostname
294 to the DHCP server so it can be registered in DNS.
295 If
296 .Ar hostname
297 is an empty string then the current system hostname is sent.
298 If
299 .Ar hostname
300 is a FQDN (ie, contains a .) then it will be encoded as such.
301 .It Fl I , Fl Fl clientid Ar clientid
302 Send the
303 .Ar clientid .
304 If the string is of the format 01:02:03 then it is encoded as hex.
305 For interfaces whose hardware address is longer than 8 bytes, or if the
306 .Ar clientid
307 is an empty string then
308 .Nm
309 sends a default
310 .Ar clientid
311 of the hardware family and the hardware address.
312 .It Fl i , Fl Fl vendorclassid Ar vendorclassid
313 Override the DHCPv4
314 .Ar vendorclassid
315 field sent.
316 The default is
317 dhcpcd-<version>:<os>:<machine>:<platform>.
318 For example
319 .D1 dhcpcd-5.5.6:NetBSD-6.99.5:i386:i386
320 If not set then none is sent.
321 Some badly configured DHCP servers reject unknown vendorclassids.
322 To work around it, try and impersonate Windows by using the MSFT vendorclassid.
323 .It Fl j , Fl Fl logfile Ar logfile
324 Writes to the specified
325 .Ar logfile
326 rather than
327 .Xr syslog 3 .
328 The
329 .Ar logfile
330 is truncated when opened and is reopened when
331 .Nm
332 receives the
333 .Dv SIGUSR2
334 signal.
335 .It Fl k , Fl Fl release Op Ar interface
336 This causes an existing
337 .Nm
338 process running on the
339 .Ar interface
340 to release its lease and de-configure the
341 .Ar interface
342 regardless of the
343 .Fl p , Fl Fl persistent
344 option.
345 If no
346 .Ar interface
347 is specified then this applies to all interfaces.
348 If no interfaces are left running,
349 .Nm
350 will exit.
351 .It Fl l , Fl Fl leasetime Ar seconds
352 Request a specific lease time in
353 .Ar seconds .
354 By default
355 .Nm
356 does not request any lease time and leaves it in the hands of the
357 DHCP server.
358 .It Fl M , Fl Fl master
359 Start
360 .Nm
361 in master mode even if only one interface specified on the command line.
362 See the Multiple Interfaces section above.
363 .It Fl m , Fl Fl metric Ar metric
364 Metrics are used to prefer an interface over another one, lowest wins.
365 .Nm
366 will supply a default metic of 200 +
367 .Xr if_nametoindex 3 .
368 An extra 100 will be added for wireless interfaces.
369 .It Fl n , Fl Fl rebind Op Ar interface
370 Notifies
371 .Nm
372 to reload its configuration and rebind the specified
373 .Ar interface .
374 If no interface is specified then this applies to all interfaces.
375 If
376 .Nm
377 is not running, then it starts up as normal.
378 This may also cause
379 .Xr wpa_supplicant 8
380 to reload its configuration for each interface as well.
381 .It Fl o , Fl Fl option Ar option
382 Request the DHCP
383 .Ar option
384 variable for use in
385 .Pa @SCRIPT@ .
386 .It Fl p , Fl Fl persistent
387 .Nm
388 normally de-configures the
389 .Ar interface
390 and configuration when it exits.
391 Sometimes, this isn't desirable if, for example, you have root mounted over
392 NFS or SSH clients connect to this host and they need to be notified of
393 the host shutting down.
394 You can use this option to stop this from happening.
395 .It Fl r , Fl Fl request Op Ar address
396 Request the
397 .Ar address
398 in the DHCP DISCOVER message.
399 There is no guarantee this is the address the DHCP server will actually give.
400 If no
401 .Ar address
402 is given then the first address currently assigned to the
403 .Ar interface
404 is used.
405 .It Fl s , Fl Fl inform Op Ar address Ns Op Ar /cidr
406 Behaves like
407 .Fl r , Fl Fl request
408 as above, but sends a DHCP INFORM instead of DISCOVER/REQUEST.
409 This does not get a lease as such, just notifies the DHCP server of the
410 .Ar address
411 in use.
412 You should also include the optional
413 .Ar cidr
414 network number in case the address is not already configured on the interface.
415 .Nm
416 remains running and pretends it has an infinite lease.
417 .Nm
418 will not de-configure the interface when it exits.
419 If
420 .Nm
421 fails to contact a DHCP server then it returns a failure instead of falling
422 back on IPv4LL.
423 .It Fl S, Fl Fl static Ar value
424 Configures a static DHCP
425 .Ar value .
426 If you set
427 .Ic ip_address
428 then
429 .Nm
430 will not attempt to obtain a lease and just use the value for the address with
431 an infinite lease time.
432 .Pp
433 Here is an example which configures a static address, routes and dns.
434 .D1 dhcpcd -S ip_address=192.168.0.10/24 \e
435 .D1 -S routers=192.168.0.1 \e
436 .D1 -S domain_name_servers=192.168.0.1 \e
437 .D1 eth0
438 .Pp
439 You cannot presently set static DHCPv6 values.
440 Use the
441 .Fl e , Fl Fl env
442 option instead.
443 .It Fl t , Fl Fl timeout Ar seconds
444 Timeout after
445 .Ar seconds ,
446 instead of the default 30.
447 A setting of 0
448 .Ar seconds
449 causes
450 .Nm
451 to wait forever to get a lease.
452 If
453 .Nm
454 is working on a single interface then
455 .Nm
456 will exit when a timeout occurs, otherwise
457 .Nm
458 will fork into the background.
459 .It Fl u , Fl Fl userclass Ar class
460 Tags the DHCPv4 message with the userclass
461 .Ar class .
462 DHCP servers use this to give members of the class DHCP options other than the
463 default, without having to know things like hardware address or hostname.
464 .It Fl v , Fl Fl vendor Ar code , Ns Ar value
465 Add an encapsulated vendor option.
466 .Ar code
467 should be between 1 and 254 inclusive.
468 To add a raw vendor string, omit
469 .Ar code
470 but keep the comma.
471 Examples.
472 .Pp
473 Set the vendor option 01 with an IP address.
474 .D1 dhcpcd \-v 01,192.168.0.2 eth0
475 Set the vendor option 02 with a hex code.
476 .D1 dhcpcd \-v 02,01:02:03:04:05 eth0
477 Set the vendor option 03 with an IP address as a string.
478 .D1 dhcpcd \-v 03,\e"192.168.0.2\e" eth0
479 Set un-encapsulated vendor option to hello world.
480 .D1 dhcpcd \-v ,"hello world" eth0
481 .It Fl Fl version
482 Display both program version and copyright information.
483 .Nm
484 then exits before doing any configuration.
485 .It Fl w
486 Wait for an address to be assigned before forking to the background.
487 Does not take an argument, unlike the below option.
488 .Fl fl waitip
489 option.
490 .It Fl Fl waitip Op 4 | 6
491 Wait for an address to be assigned before forking to the background.
492 4 means wait for an IPv4 address to be assigned.
493 6 means wait for an IPv6 address to be assigned.
494 If no argument is given,
495 .Nm
496 will wait for any address protocol to be assigned.
497 It is possible to wait for more than one address protocol and
498 .Nm
499 will only fork to the background when all waiting conditions are satisfied.
500 .It Fl x , Fl Fl exit Op Ar interface
501 This will signal an existing
502 .Nm
503 process running on the
504 .Ar interface
505 to exit.
506 If no interface is specified, then the above is applied to all interfaces.
507 See the
508 .Fl p , Fl Fl persistent
509 option to control configuration persistence on exit,
510 which is enabled by default in
511 .Xr dhcpcd.conf 5 .
512 .Nm
513 then waits until this process has exited.
514 .It Fl y , Fl Fl reboot Ar seconds
515 Allow
516 .Ar reboot
517 seconds before moving to the discover phase if we have an old lease to use.
518 Allow
519 .Ar reboot
520 seconds before starting fallback states from the discover phase.
521 IPv4LL is started when the first
522 .Ar reboot
523 timeout is reached.
524 The default is 5 seconds.
525 A setting of 0 seconds causes
526 .Nm
527 to skip the reboot phase and go straight into discover.
528 This has no effect on DHCPv6 other than skipping the reboot phase.
529 .El
530 .Ss Restricting behaviour
531 .Nm
532 will try to do as much as it can by default.
533 However, there are sometimes situations where you don't want the things to be
534 configured exactly how the the DHCP server wants.
535 Here are some options that deal with turning these bits off.
536 .Bl -tag -width indent
537 .It Fl 4 , Fl Fl ipv4only
538 Configure IPv4 only.
539 .It Fl 6 , Fl Fl ipv6only
540 Configure IPv6 only.
541 .It Fl A , Fl Fl noarp
542 Don't request or claim the address by ARP.
543 This also disables IPv4LL.
544 .It Fl B , Fl Fl nobackground
545 Don't run in the background when we acquire a lease.
546 This is mainly useful for running under the control of another process, such
547 as a debugger or a network manager.
548 .It Fl C , Fl Fl nohook Ar script
549 Don't run this hook script.
550 Matches full name, or prefixed with 2 numbers optionally ending with
551 .Pa .sh .
552 .Pp
553 So to stop
554 .Nm
555 from touching your DNS settings you would do:-
556 .D1 dhcpcd -C resolv.conf eth0
557 .It Fl G , Fl Fl nogateway
558 Don't set any default routes.
559 .It Fl H , Fl Fl xidhwaddr
560 Use the last four bytes of the hardware address as the DHCP xid instead
561 of a randomly generated number.
562 .It Fl J , Fl Fl broadcast
563 Instructs the DHCP server to broadcast replies back to the client.
564 Normally this is only set for non Ethernet interfaces,
565 such as FireWire and InfiniBand.
566 In most instances,
567 .Nm
568 will set this automatically.
569 .It Fl K , Fl Fl nolink
570 Don't receive link messages for carrier status.
571 You should only have to use this with buggy device drivers or running
572 .Nm
573 through a network manager.
574 .It Fl L , Fl Fl noipv4ll
575 Don't use IPv4LL (aka APIPA, aka Bonjour, aka ZeroConf).
576 .It Fl O , Fl Fl nooption Ar option
577 Don't request the specified option.
578 If no option given, then don't request any options other than those to
579 configure the interface and routing.
580 .It Fl Q , Fl Fl require Ar option
581 Requires the
582 .Ar option
583 to be present in all DHCP messages, otherwise the message is ignored.
584 To enforce that
585 .Nm
586 only responds to DHCP servers and not BOOTP servers, you can
587 .Fl Q
588 .Ar dhcp_message_type .
589 .It Fl q , Fl Fl quiet
590 Quiet
591 .Nm
592 on the command line, only warnings and errors will be displayed.
593 The messages are still logged though.
594 .It Fl T, Fl Fl test
595 On receipt of DHCP messages just call
596 .Pa @SCRIPT@
597 with the reason of TEST which echos the DHCP variables found in the message
598 to the console.
599 The interface configuration isn't touched and neither are any configuration
600 files.
601 The
602 .Ar rapid_commit
603 option is not sent in TEST mode so that the server does not lease an address.
604 To test INFORM the interface needs to be configured with the desired address
605 before starting
606 .Nm .
607 .It Fl U, Fl Fl dumplease Ar interface
608 Dumps the last lease for the
609 .Ar interface
610 to stdout.
611 .Ar interface
612 could also be a path to a DHCP wire formatted file.
613 Use the
614 .Fl 4
615 or
616 .Fl 6
617 flags to specify an address family.
618 .It Fl V, Fl Fl variables
619 Display a list of option codes, the associated variable and encoding for use in
620 .Xr dhcpcd-run-hooks 8 .
621 Variables are prefixed with new_ and old_ unless the option number is -.
622 Variables without an option are part of the DHCP message and cannot be
623 directly requested.
624 .It Fl W, Fl Fl whitelist Ar address Ns Op /cidr
625 Only accept packets from
626 .Ar address Ns Op /cidr .
627 .Fl X, Fl Fl blacklist
628 is ignored if
629 .Fl W, Fl Fl whitelist
630 is set.
631 .It Fl X, Fl Fl blacklist Ar address Ns Op Ar /cidr
632 Ignore all packets from
633 .Ar address Ns Op Ar /cidr .
634 .It Fl Z , Fl Fl denyinterfaces Ar pattern
635 When discovering interfaces, the interface name must not match
636 .Ar pattern
637 which is a space or comma separated list of patterns passed to
638 .Xr fnmatch 3 .
639 .It Fl z , Fl Fl allowinterfaces Ar pattern
640 When discovering interfaces, the interface name must match
641 .Ar pattern
642 which is a space or comma separated list of patterns passed to
643 .Xr fnmatch 3 .
644 If the same interface is matched in
645 .Fl Z , Fl Fl denyinterfaces
646 then it is still denied.
647 .It Fl Fl nodev
648 Don't load any
649 .Pa /dev
650 management modules.
651 .El
652 .Sh 3RDPARTY LINK MANAGEMENT
653 Some interfaces require configuration by 3rd parties, such as PPP or VPN.
654 When an interface configuration in
655 .Nm
656 is marked as STATIC or INFORM without an address then
657 .Nm
658 will monitor the interface until an address is added or removed from it and
659 act accordingly.
660 For point to point interfaces (like PPP), a default route to its
661 destination is automatically added to the configuration.
662 If the point to point interface is configured for INFORM, then
663 .Nm
664 unicasts INFORM to the destination, otherwise it defaults to STATIC.
665 .Sh NOTES
666 .Nm
667 requires a Berkley Packet Filter, or BPF device on BSD based systems and a
668 Linux Socket Filter, or LPF device on Linux based systems for all IPv4
669 configuration.
670 .Pp
671 If restricting
672 .Nm
673 to a single interface and optionally address family via the command-line
674 then all futher calls to
675 .Nm
676 to rebind, reconfigure or exit need to include the same restrictive flags
677 so that
678 .Nm
679 knows which process to signal.
680 .Sh FILES
681 .Bl -ohang
682 .It Pa @SYSCONFDIR@/dhcpcd.conf
683 Configuration file for dhcpcd.
684 If you always use the same options, put them here.
685 .It Pa @SYSCONFDIR@/dhcpcd.duid
686 Text file that holds the DUID used to identify the host.
687 .It Pa @SYSCONFDIR@/dhcpcd.secret
688 Text file that holds a secret key known only to the host.
689 .It Pa @SCRIPT@
690 Bourne shell script that is run to configure or de-configure an interface.
691 .It Pa @LIBDIR@/dhcpcd/dev
692 .Pa /dev
693 management modules.
694 .It Pa @HOOKDIR@
695 A directory containing bourne shell scripts that are run by the above script.
696 Each script can be disabled by using the
697 .Fl C , Fl Fl nohook
698 option described above.
699 .It Pa @DBDIR@/dhcpcd\- Ns Ar interface Ns Ar -ssid Ns .lease
700 The actual DHCP message sent by the server.
701 We use this when reading the last
702 lease and use the files mtime as when it was issued.
703 .It Pa @DBDIR@/dhcpcd\- Ns Ar interface Ns Ar -ssid Ns .lease6
704 The actual DHCPv6 message sent by the server.
705 We use this when reading the last
706 lease and use the files mtime as when it was issued.
707 .It Pa @DBDIR@/dhcpcd-rdm.monotonic
708 Stores the monotonic counter used in the
709 .Ar replay
710 field in Authentication Options.
711 .It Pa @RUNDIR@/dhcpcd.pid
712 Stores the PID of
713 .Nm
714 running on all interfaces.
715 .It Pa @RUNDIR@/dhcpcd\- Ns Ar interface Ns .pid
716 Stores the PID of
717 .Nm
718 running on the
719 .Ar interface .
720 .It Pa @RUNDIR@/dhcpcd.sock
721 Control socket to the master daemon.
722 .It Pa @RUNDIR@/dhcpcd.unpriv.sock
723 Unpriviledged socket to the master daemon, only allows state retrieval.
724 .It Pa @RUNDIR@/dhcpcd\- Ns Ar interface Ns .sock
725 Control socket to per interface daemon.
726 .El
727 .Sh SEE ALSO
728 .Xr fnmatch 3 ,
729 .Xr if_nametoindex 3 ,
730 .Xr dhcpcd.conf 5 ,
731 .Xr resolv.conf 5 ,
732 .Xr dhcpcd-run-hooks 8 ,
733 .Xr resolvconf 8
734 .Sh STANDARDS
735 RFC\ 951, RFC\ 1534, RFC\ 2104, RFC\ 2131, RFC\ 2132, RFC\ 2563, RFC\ 2855,
736 RFC\ 3004, RFC\ 3118, RFC\ 3203, RFC\ 3315, RFC\ 3361, RFC\ 3633, RFC\ 3396,
737 RFC\ 3397, RFC\ 3442, RFC\ 3495, RFC\ 3925, RFC\ 3927, RFC\ 4039, RFC\ 4075,
738 RFC\ 4242, RFC\ 4361, RFC\ 4390, RFC\ 4702, RFC\ 4074, RFC\ 4861, RFC\ 4833,
739 RFC\ 4941, RFC\ 5227, RFC\ 5942, RFC\ 5969, RFC\ 6106, RFC\ 6334, RFC\ 6603,
740 RFC\ 6704, RFC\ 7217, RFC\ 7550.
741 .Sh AUTHORS
742 .An Roy Marples Aq Mt roy@marples.name
743 .Sh BUGS
744 Please report them to
745 .Lk http://roy.marples.name/projects/dhcpcd