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

annotate src/dhcpcd.8.in @ 5535:a0d828e25482 draft

Add --noconfigure option With this set dhcpcd will not configure anything on the host. The expectation is that a 3rd party script will instead.

author	Roy Marples <roy@marples.name>
date	Wed, 04 Nov 2020 14:18:48 +0000
parents	b1a3d9055662
children	a233fe729323

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 .\"
5535 a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	27 .Dd November 3, 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
5535 a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	65 .Op Fl Fl configure
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	66 .Op Fl Fl noconfigure
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	67 .Op interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	68 .Op ...
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	69 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	70 .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	71 .Op interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	72 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	73 .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	74 .Op interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	75 .Nm
4650 87fbc94cfce4 Add some missing whitespace. Sascha Wildner <swildner@dragonflybsd.org> parents: 4590 diff changeset	76 .Fl U , Fl Fl dumplease
5288 30958d539e6c Restore dumping a lease from stdin Roy Marples <roy@marples.name> parents: 5251 diff changeset	77 .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	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 Fl version
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	80 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	81 .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	82 .Op interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	83 .Sh DESCRIPTION
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	84 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	85 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	86 .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	87 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	88 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	89 .Po
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	90 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	91 .Pc
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	92 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	93 .Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	94 of the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	95 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	96 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	97 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	98 .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	99 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	100 .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	101 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	102 .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	103 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	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 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	106 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	107 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	108 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	109 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	110 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	111 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	112 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	113 .Nm
5174 b5bcdc5822fa Grammar nits Sascha Wildner <saw@online.de> parents: 5092 diff changeset	114 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	115 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	116 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	117 .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	118 and
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	119 .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	120 options.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	121 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	122 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	123 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	124 .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	125 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	126 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	127 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	128 .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	129 and
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	130 .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	131 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	132 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	133 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	134 specified in
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	135 .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	136 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	137 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	138 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	139 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	140 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	141 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	142 .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	143 By default,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	144 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	145 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	146 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	147 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	148 .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	149 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	150 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	151 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	152 .Po
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	153 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	154 .Pc .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	155 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	156 proper address.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	157 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	158 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	159 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	160 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	161 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	162 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	163 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	164 .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	165 option.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	166 .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	167 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	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 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	170 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	171 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	172 When
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	173 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	174 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	175 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	176 The
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	177 .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	178 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	179 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	180 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	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 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	183 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	184 processes.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	185 .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	186 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	187 versions.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	188 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	189 .Fl k ,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	190 .Fl N ,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	191 .Fl n
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	192 and
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	193 .Fl x
4308 71bf4daa6dfa dhcpcd.8.in: Fix typos and minor grammatical issues David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	194 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	195 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	196 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	197 .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	198 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	199 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	200 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	201 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	202 metric, otherwise
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	203 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	204 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	205 metric.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	206 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	207 the use of patterns.
4752 8106541dc0b0 man: Note the default ignoring of virtual interfaces. Roy Marples <roy@marples.name> parents: 4658 diff changeset	208 .Pp
4753 ff60668a89ab man: some virtual interfaces .... Roy Marples <roy@marples.name> parents: 4752 diff changeset	209 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	210 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	211 as is the FireWire interface.
8106541dc0b0 man: Note the default ignoring of virtual interfaces. Roy Marples <roy@marples.name> parents: 4658 diff changeset	212 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	213 be listed in
8106541dc0b0 man: Note the default ignoring of virtual interfaces. Roy Marples <roy@marples.name> parents: 4658 diff changeset	214 .Fl Fl allowinterfaces
8106541dc0b0 man: Note the default ignoring of virtual interfaces. Roy Marples <roy@marples.name> parents: 4658 diff changeset	215 or have an interface directive in
8106541dc0b0 man: Note the default ignoring of virtual interfaces. Roy Marples <roy@marples.name> parents: 4658 diff changeset	216 .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	217 .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	218 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	219 runs
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	220 .Pa @SCRIPT@ ,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	221 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	222 .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	223 option.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	224 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	225 .Pa @HOOKDIR@
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	226 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	227 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	228 .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	229 .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	230 .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	231 and
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	232 .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	233 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	234 .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	235 option.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	236 See
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	237 .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	238 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	239 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	240 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	241 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	242 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	243 .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	244 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	245 .Pa @HOOKDIR@
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	246 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	247 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	248 .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	249 so that
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	250 .Nm
4590 ae11f99f87ad Mention 29-lookup-hostname rather than 10-wpa_supplicant Roy Marples <roy@marples.name> parents: 4575 diff changeset	251 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	252 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	253 .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	254 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	255 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	256 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	257 .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	258 .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	259 Background immediately.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	260 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	261 carrier status.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	262 .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	263 Use this
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	264 .Ar script
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	265 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	266 .Pa @SCRIPT@ .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	267 .It Fl D , Fl Fl duid
4288 0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4264 diff changeset	268 Use a DHCP Unique Identifier.
0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4264 diff changeset	269 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	270 otheriwse if persistent storage is available then a DUID-LLT
0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4264 diff changeset	271 (link local address + time) is generated,
0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4264 diff changeset	272 otherwise DUID-LL is generated (link local address).
0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4264 diff changeset	273 This, plus the IAID will be used as the
4650 87fbc94cfce4 Add some missing whitespace. Sascha Wildner <swildner@dragonflybsd.org> parents: 4590 diff changeset	274 .Fl I , Fl Fl clientid .
4288 0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4264 diff changeset	275 The DUID generated will be held in
0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4264 diff changeset	276 .Pa @DBDIR@/duid
0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4264 diff changeset	277 and should not be copied to other hosts.
0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4264 diff changeset	278 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	279 .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	280 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	281 .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	282 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	283 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	284 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	285 interface.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	286 .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	287 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	288 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	289 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	290 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	291 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	292 .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	293 Push
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	294 .Ar value
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	295 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	296 .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	297 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	298 .Fl e
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	299 .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	300 .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	301 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	302 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	303 .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	304 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	305 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	306 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	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 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	309 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	310 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	311 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	312 .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	313 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	314 hostname.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	315 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	316 .Ar fqdn
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	317 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	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 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	320 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	321 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	322 .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	323 .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	324 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	325 .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	326 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	327 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	328 .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	329 Sends
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	330 .Ar hostname
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	331 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	332 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	333 .Ar hostname
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	334 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	335 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	336 .Ar hostname
4308 71bf4daa6dfa dhcpcd.8.in: Fix typos and minor grammatical issues David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	337 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	338 .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	339 Send the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	340 .Ar clientid .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	341 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	342 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	343 .Ar clientid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	344 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	345 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	346 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	347 .Ar clientid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	348 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	349 .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	350 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	351 .Ar vendorclassid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	352 field sent.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	353 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	354 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	355 For example
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	356 .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	357 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	358 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	359 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	360 .It Fl j , Fl Fl logfile Ar logfile
746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	361 Writes to the specified
4997 774f445ed677 logging: Always log to syslog(3). Roy Marples <roy@marples.name> parents: 4958 diff changeset	362 .Ar logfile .
774f445ed677 logging: Always log to syslog(3). Roy Marples <roy@marples.name> parents: 4958 diff changeset	363 .Nm
774f445ed677 logging: Always log to syslog(3). Roy Marples <roy@marples.name> parents: 4958 diff changeset	364 still writes to
4010 746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	365 .Xr syslog 3 .
746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	366 The
746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	367 .Ar logfile
4575 d0044fa1a6e1 Typo Roy Marples <roy@marples.name> parents: 4548 diff changeset	368 is reopened when
4010 746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	369 .Nm
746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	370 receives the
746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	371 .Dv SIGUSR2
746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	372 signal.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	373 .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	374 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	375 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	376 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	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 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	379 .Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	380 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	381 .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	382 option.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	383 If no
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	384 .Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	385 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	386 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	387 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	388 will exit.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	389 .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	390 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	391 .Ar seconds .
5435 557a3f9f2be4 DHCP: allow leasetime -1 to represent infinity Roy Marples <roy@marples.name> parents: 5288 diff changeset	392 .Ar -1
557a3f9f2be4 DHCP: allow leasetime -1 to represent infinity Roy Marples <roy@marples.name> parents: 5288 diff changeset	393 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	394 By default
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	395 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	396 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	397 DHCP server.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	398 .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	399 Start
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	400 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	401 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	402 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	403 .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	404 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	405 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	406 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	407 .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	408 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	409 .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	410 Notifies
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	411 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	412 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	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 If no
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	415 .Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	416 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	417 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	418 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	419 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	420 .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	421 Notifies
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	422 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	423 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	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 If no
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	426 .Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	427 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	428 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	429 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	430 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	431 Unlike the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	432 .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	433 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	434 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	435 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	436 .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	437 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	438 .Ar option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	439 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	440 .Pa @SCRIPT@ .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	441 .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	442 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	443 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	444 .Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	445 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	446 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	447 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	448 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	449 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	450 .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	451 Request the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	452 .Ar address
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	453 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	454 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	455 If no
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	456 .Ar address
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	457 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	458 .Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	459 is used.
4207 d9c3c7008d20 ipv4: allow configuration of static broadcast address Roy Marples <roy@marples.name> parents: 4197 diff changeset	460 .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	461 Behaves like
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	462 .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	463 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	464 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	465 .Ar address
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	466 in use.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	467 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	468 .Ar cidr
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	469 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	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 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	472 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	473 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	474 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	475 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	476 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	477 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	478 .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	479 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	480 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	481 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	482 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	483 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	484 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	485 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	486 exists.
4650 87fbc94cfce4 Add some missing whitespace. Sascha Wildner <swildner@dragonflybsd.org> parents: 4590 diff changeset	487 .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	488 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	489 .Ar value .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	490 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	491 .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	492 then
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	493 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	494 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	495 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	496 .Pp
4308 71bf4daa6dfa dhcpcd.8.in: Fix typos and minor grammatical issues David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	497 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	498 .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	499 .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	500 .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	501 .D1 eth0
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	502 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	503 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	504 Use the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	505 .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	506 option instead.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	507 .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	508 Timeout after
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	509 .Ar seconds ,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	510 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	511 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	512 .Ar seconds
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	513 causes
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	514 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	515 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	516 If
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 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	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 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	521 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	522 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	523 .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	524 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	525 .Ar class .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	526 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	527 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	528 .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	529 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	530 .Ar code
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	531 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	532 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	533 .Ar code
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	534 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	535 Examples.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	536 .Pp
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 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	538 .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	539 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	540 .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	541 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	542 .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	543 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	544 .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	545 .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	546 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	547 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	548 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	549 .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	550 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	551 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	552 .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	553 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	554 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	555 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	556 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	557 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	558 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	559 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	560 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	561 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	562 .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	563 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	564 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	565 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	566 .Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	567 to exit.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	568 If no
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	569 .Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	570 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	571 See the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	572 .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	573 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	574 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	575 .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	576 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	577 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	578 .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	579 Allow
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	580 .Ar reboot
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	581 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	582 Allow
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	583 .Ar reboot
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	584 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	585 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	586 .Ar reboot
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	587 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	588 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	589 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	590 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	591 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	592 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	593 .El
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	594 .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	595 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	596 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	597 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	598 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	599 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	600 .Pp
af2b389465a7 man: note requirements of interface / protocol when exiting Roy Marples <roy@marples.name> parents: 4067 diff changeset	601 Note that when
af2b389465a7 man: note requirements of interface / protocol when exiting Roy Marples <roy@marples.name> parents: 4067 diff changeset	602 .Nm
af2b389465a7 man: note requirements of interface / protocol when exiting Roy Marples <roy@marples.name> parents: 4067 diff changeset	603 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	604 specified when asking
af2b389465a7 man: note requirements of interface / protocol when exiting Roy Marples <roy@marples.name> parents: 4067 diff changeset	605 .Nm
af2b389465a7 man: note requirements of interface / protocol when exiting Roy Marples <roy@marples.name> parents: 4067 diff changeset	606 to exit using the commandline.
af2b389465a7 man: note requirements of interface / protocol when exiting Roy Marples <roy@marples.name> parents: 4067 diff changeset	607 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	608 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	609 .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	610 .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	611 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	612 Use the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	613 .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	614 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	615 .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	616 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	617 .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	618 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	619 .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	620 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	621 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	622 .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	623 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	624 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	625 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	626 .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	627 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	628 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	629 .Pa .sh .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	630 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	631 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	632 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	633 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	634 .D1 dhcpcd -C resolv.conf eth0
4067 1c2136f8886d Restore -G, --nogateway. Roy Marples <roy@marples.name> parents: 4020 diff changeset	635 .It Fl G , Fl Fl nogateway
1c2136f8886d Restore -G, --nogateway. Roy Marples <roy@marples.name> parents: 4020 diff changeset	636 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	637 .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	638 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	639 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	640 .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	641 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	642 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	643 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	644 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	645 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	646 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	647 .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	648 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	649 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	650 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	651 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	652 .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	653 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	654 .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	655 Removes the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	656 .Ar option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	657 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	658 .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	659 Print the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	660 .Pa pidfile
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	661 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	662 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	663 .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	664 Requires the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	665 .Ar option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	666 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	667 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	668 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	669 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	670 .Fl Q
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	671 .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	672 .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	673 Quiet
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	674 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	675 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	676 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	677 These messages are still logged via
50eb48a9b47b dhcpcd: Silence console output entirely with more -q Roy Marples <roy@marples.name> parents: 5209 diff changeset	678 .Xr syslog 3 .
4650 87fbc94cfce4 Add some missing whitespace. Sascha Wildner <swildner@dragonflybsd.org> parents: 4590 diff changeset	679 .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	680 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	681 .Pa @SCRIPT@
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	682 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	683 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	684 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	685 files.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	686 The
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	687 .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	688 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	689 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	690 before starting
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	691 .Nm .
5288 30958d539e6c Restore dumping a lease from stdin Roy Marples <roy@marples.name> parents: 5251 diff changeset	692 .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	693 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	694 .Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	695 to stdout.
5288 30958d539e6c Restore dumping a lease from stdin Roy Marples <roy@marples.name> parents: 5251 diff changeset	696 If no
30958d539e6c Restore dumping a lease from stdin Roy Marples <roy@marples.name> parents: 5251 diff changeset	697 .Ar interface
30958d539e6c Restore dumping a lease from stdin Roy Marples <roy@marples.name> parents: 5251 diff changeset	698 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	699 Use the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	700 .Fl 4
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	701 or
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	702 .Fl 6
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	703 flags to specify an address family.
5288 30958d539e6c Restore dumping a lease from stdin Roy Marples <roy@marples.name> parents: 5251 diff changeset	704 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	705 In this case, specifying an address family is mandatory.
4650 87fbc94cfce4 Add some missing whitespace. Sascha Wildner <swildner@dragonflybsd.org> parents: 4590 diff changeset	706 .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	707 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	708 .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	709 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	710 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	711 directly requested.
4650 87fbc94cfce4 Add some missing whitespace. Sascha Wildner <swildner@dragonflybsd.org> parents: 4590 diff changeset	712 .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	713 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	714 .Ar address Ns Op /cidr .
4650 87fbc94cfce4 Add some missing whitespace. Sascha Wildner <swildner@dragonflybsd.org> parents: 4590 diff changeset	715 .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	716 is ignored if
4650 87fbc94cfce4 Add some missing whitespace. Sascha Wildner <swildner@dragonflybsd.org> parents: 4590 diff changeset	717 .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	718 is set.
4650 87fbc94cfce4 Add some missing whitespace. Sascha Wildner <swildner@dragonflybsd.org> parents: 4590 diff changeset	719 .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	720 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	721 .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	722 .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	723 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	724 .Ar pattern
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	725 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	726 .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	727 .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	728 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	729 .Ar pattern
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	730 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	731 .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	732 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	733 .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	734 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	735 .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	736 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	737 This allows
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 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	740 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	741 commands to start each interface as required.
5535 a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	742 .It Fl Fl configure
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	743 Allows
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	744 .Nm
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	745 to configure the system.
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	746 This is the default behaviour and sets
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	747 .Ev if_configured=true .
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	748 .It Fl Fl noconfigure
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	749 .Nm
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	750 will not configure the system add all.
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	751 This is only of use if the
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	752 .Fl Fl script
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	753 that
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	754 .Nm
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	755 calls at each network event configures the system instead.
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	756 This is different from
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	757 .Fl T , Fl Fl test
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	758 mode in that it's not one shot and the only change to the environment is the
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	759 addition of
a0d828e25482 Add --noconfigure option Roy Marples <roy@marples.name> parents: 5526 diff changeset	760 .Ev if_configured=false .
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	761 .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	762 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	763 .Pa /dev
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	764 management modules.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	765 .El
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	766 .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	767 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	768 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	769 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	770 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	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 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	773 act accordingly.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	774 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	775 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	776 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	777 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	778 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	779 .Sh NOTES
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	780 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	781 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	782 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	783 configuration.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	784 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	785 If restricting
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	786 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	787 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	788 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	789 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	790 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	791 so that
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	792 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	793 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	794 .Pp
b68206d6e0a1 dhcpcd(8): document some servers might filter based on ClientID Roy Marples <roy@marples.name> parents: 4209 diff changeset	795 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	796 If
b68206d6e0a1 dhcpcd(8): document some servers might filter based on ClientID Roy Marples <roy@marples.name> parents: 4209 diff changeset	797 .Nm
b68206d6e0a1 dhcpcd(8): document some servers might filter based on ClientID Roy Marples <roy@marples.name> parents: 4209 diff changeset	798 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	799 option
b68206d6e0a1 dhcpcd(8): document some servers might filter based on ClientID Roy Marples <roy@marples.name> parents: 4209 diff changeset	800 .Nm
b68206d6e0a1 dhcpcd(8): document some servers might filter based on ClientID Roy Marples <roy@marples.name> parents: 4209 diff changeset	801 sends to match.
b68206d6e0a1 dhcpcd(8): document some servers might filter based on ClientID Roy Marples <roy@marples.name> parents: 4209 diff changeset	802 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	803 .Pa @DBDIR@/duid
b68206d6e0a1 dhcpcd(8): document some servers might filter based on ClientID Roy Marples <roy@marples.name> parents: 4209 diff changeset	804 accordingly.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	805 .Sh FILES
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	806 .Bl -ohang
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	807 .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	808 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	809 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	810 .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	811 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	812 .It Pa @LIBDIR@/dhcpcd/dev
4658 1aadabec63bb Note dev modules are for Linux only. Roy Marples <roy@marples.name> parents: 4651 diff changeset	813 Linux
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	814 .Pa /dev
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	815 management modules.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	816 .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	817 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	818 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	819 .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	820 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	821 .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	822 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	823 .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	824 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	825 .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	826 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	827 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	828 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	829 .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	830 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	831 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	832 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	833 .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	834 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	835 .Ar replay
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	836 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	837 .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	838 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	839 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	840 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	841 .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	842 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	843 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	844 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	845 .Ar interface .
4834 4684eb2ca980 build: Move rundir from /var/run to /var/run/dhcpcd Roy Marples <roy@marples.name> parents: 4753 diff changeset	846 .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	847 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	848 .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	849 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	850 .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	851 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	852 .El
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	853 .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	854 .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	855 .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	856 .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	857 .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	858 .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	859 .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	860 .Sh STANDARDS
4651 7d9109cf0e90 Whitespace police. Roy Marples <roy@marples.name> parents: 4650 diff changeset	861 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	862 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	863 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	864 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	865 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	866 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	867 .Sh AUTHORS
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	868 .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	869 .Sh BUGS
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	870 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	871 .Lk http://roy.marples.name/projects/dhcpcd

Mercurial > hg > dhcpcd

annotate src/dhcpcd.8.in @ 5535:a0d828e25482 draft