hg/dhcpcd: src/dhcpcd.8.in annotate

annotate src/dhcpcd.8.in @ 5526:b1a3d9055662 draft

privsep: Allow logfile reopening in a chroot Now that only the privileged actioneer does the actual logging we can safely reopen the file we are logging to. This also closes and re-opens the syslog connection.

author	Roy Marples <roy@marples.name>
date	Fri, 30 Oct 2020 14:19:16 +0000
parents	557a3f9f2be4
children	a0d828e25482

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

Mercurial > hg > dhcpcd

annotate src/dhcpcd.8.in @ 5526:b1a3d9055662 draft