hg/dhcpcd: src/dhcpcd.conf.5.in annotate

annotate src/dhcpcd.conf.5.in @ 5551:0c4608a6cc2a draft

options: Allow duid to take a value If a value is given, it overrides /var/db/dhcpcd/duid.

author	Roy Marples <roy@marples.name>
date	Wed, 25 Nov 2020 14:19:55 +0000
parents	75fdbbc9e1a5
children	2a519da0f1a2

rev	line source
4548 c7df03794de3 Add SPDX identifiers to all dhcpcd source files. Yegor Yefremov <yegorslists@googlemail.com> parents: 4511 diff changeset	1 .\" SPDX-License-Identifier: BSD-2-Clause
c7df03794de3 Add SPDX identifiers to all dhcpcd source files. Yegor Yefremov <yegorslists@googlemail.com> parents: 4511 diff changeset	2 .\"
4922 555d7d1a4939 Welcome to 2020! Roy Marples <roy@marples.name> parents: 4837 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 .\"
5551 0c4608a6cc2a options: Allow duid to take a value Roy Marples <roy@marples.name> parents: 5522 diff changeset	27 .Dd November 25, 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.CONF 5
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.conf
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	32 .Nd dhcpcd configuration file
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	33 .Sh DESCRIPTION
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	34 Although
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	35 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	36 can do everything from the command line, there are cases where it's just easier
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	37 to do it once in a configuration file.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	38 Most of the options found in
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	39 .Xr dhcpcd 8
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	40 can be used here.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	41 The first word on the line is the option and the rest of the line is the value.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	42 Leading and trailing whitespace for the option and value are trimmed.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	43 You can escape characters in the value using the \\ character.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	44 Comments can be prefixed with the # character.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	45 String values should be quoted with the " character.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	46 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	47 Here's a list of available options:
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	48 .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	49 .It Ic 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	50 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	51 .Ar pattern
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	52 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	53 .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	54 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	55 .Ic denyinterfaces
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	56 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	57 .It Ic 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	58 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	59 .Ar pattern
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	60 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	61 .Xr fnmatch 3 .
4958 a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	62 .It Ic anonymous
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	63 Enables Anonymity Profiles for DHCP, RFC 7844.
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	64 This implementation forces a hardware address randomisaton when
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	65 the interface link is down and that ClientID's are only LL.
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	66 Any DUID is ignored.
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	67 All non essential options are then masked at this point,
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	68 but they could be unmasked by explicitly requesting the option
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	69 .Sy after
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	70 the
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	71 .Ic anonymous
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	72 option is processed.
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	73 As such, the
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	74 .Ic anonymous
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	75 option
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	76 .Sy should
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	77 be the last option in the configuration unless you really want to
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	78 send something which could identify you.
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	79 .Nm dhcpcd
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	80 will not try and reboot an old lease, it will go straight into
a120f447fe74 Implement Anonymity Profiles for DHCP Clients, RFC 7844 Roy Marples <roy@marples.name> parents: 4922 diff changeset	81 DISCOVER/SOLICIT.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	82 .It Ic arping Ar address Op address
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	83 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	84 will arping each address in order before attempting DHCP.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	85 If an address is found, we will select the replying hardware address as the
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	86 profile, otherwise the IP address.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	87 Example:
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	88 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	89 .D1 interface bge0
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	90 .D1 arping 192.168.0.1
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	91 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	92 .D1 # My specific 192.168.0.1 network
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	93 .D1 profile dd:ee:aa:dd:bb:ee
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	94 .D1 static ip_address=192.168.0.10/24
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	95 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	96 .D1 # A generic 192.168.0.1 network
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	97 .D1 profile 192.168.0.1
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	98 .D1 static ip_address=192.168.0.98/24
4266 bd15cb1af330 auth: allow different tokens for send and receive Roy Marples <roy@marples.name> parents: 4218 diff changeset	99 .It Ic authprotocol Ar protocol Op Ar algorithm Op Ar rdm
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	100 Authenticate DHCP messages.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	101 See the Supported Authentication Protocols section.
4266 bd15cb1af330 auth: allow different tokens for send and receive Roy Marples <roy@marples.name> parents: 4218 diff changeset	102 If
bd15cb1af330 auth: allow different tokens for send and receive Roy Marples <roy@marples.name> parents: 4218 diff changeset	103 .Ar protocol
bd15cb1af330 auth: allow different tokens for send and receive Roy Marples <roy@marples.name> parents: 4218 diff changeset	104 is
bd15cb1af330 auth: allow different tokens for send and receive Roy Marples <roy@marples.name> parents: 4218 diff changeset	105 .Ar token
bd15cb1af330 auth: allow different tokens for send and receive Roy Marples <roy@marples.name> parents: 4218 diff changeset	106 then
bd15cb1af330 auth: allow different tokens for send and receive Roy Marples <roy@marples.name> parents: 4218 diff changeset	107 .Ar algorithm is
4825 c8d76614bcd0 Spelling fixes Sascha Wildner <swildner@dragonflybsd.org> parents: 4705 diff changeset	108 snd_secretid/rcv_secretid so you can send and receive different tokens.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	109 .It Ic authtoken Ar secretid Ar realm Ar expire Ar key
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	110 Define a shared key for use in authentication.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	111 .Ar realm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	112 can be "" to for use with the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	113 .Ar delayed
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	114 protocol.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	115 .Ar expire
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	116 is the date the token expires and should be formatted "yyy-mm-dd HH:MM".
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	117 You can use the keyword
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	118 .Ar forever
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	119 or
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	120 .Ar 0
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	121 which means the token never expires.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	122 For the token protocol,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	123 .Ar secretid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	124 needs to be 0 and
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	125 .Ar realm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	126 needs to be "".
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	127 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	128 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	129 has the error
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	130 .D1 dhcp_auth_encode: Invalid argument
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	131 then it means that
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	132 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	133 could not find the correct authentication token in your configuration.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	134 .It Ic background
4318 f532ae553fd1 dhcpcd.conf.5.in: One more minor grammar fix David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4317 diff changeset	135 Fork to the background immediately.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	136 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	137 carrier status.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	138 .It Ic blacklist Ar address Ns Op /cidr
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	139 Ignores 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	140 .Ar address Ns Op /cidr .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	141 .It Ic whitelist Ar address Ns Op /cidr
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	142 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	143 .Ar address Ns Op /cidr .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	144 .Ic blacklist
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	145 is ignored if
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	146 .Ic whitelist
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	147 is set.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	148 .It Ic bootp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	149 Be a BOOTP client.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	150 Basically, this just doesn't send a DHCP Message Type option and will only
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	151 interact with a BOOTP server.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	152 All other DHCP options still work.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	153 .It Ic broadcast
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	154 Instructs the DHCP server to broadcast replies back to the client.
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	155 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	156 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	157 In most cases,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	158 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	159 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	160 .It Ic controlgroup Ar group
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	161 Sets the group ownership of
4837 4938c2c3080e Correct path for dhcpcd socket. Roy Marples <roy@marples.name> parents: 4825 diff changeset	162 .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	163 so that users other than root can connect to
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	164 .Nm dhcpcd .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	165 .It Ic debug
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	166 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	167 .It Ic dev Ar value
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	168 Load the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	169 .Ar value
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	170 .Pa /dev
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	171 management module.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	172 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	173 will load the first one found to work, if any.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	174 .It Ic 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	175 Push
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	176 .Ar value
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	177 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	178 .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	179 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	180 .Ic env
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	181 .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	182 Or set which driver
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	183 .Xr wpa_supplicant 8
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	184 should use with
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	185 .Ic env
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	186 .Va wpa_supplicant_driver=nl80211
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	187 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	188 If the hostname is set, it will be will set to the FQDN if possible as per
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	189 RFC 4702, section 3.1.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	190 If the FQDN option is missing,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	191 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	192 will still try and set a FQDN from the hostname and domain options for
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	193 consistency.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	194 To override this, set
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	195 .Ic env
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	196 .Va hostname_fqdn=[YES\|NO\|SERVER] .
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	197 A value of
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	198 .Va SERVER
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	199 means just what the server says, don't manipulate it.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	200 This could lead to an inconsistent hostname on a DHCPv4 and DHCPv6 network
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	201 where the DHCPv4 hostname is short and the DHCPv6 has an FQDN.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	202 DHCPv6 has no hostname option.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	203 .It Ic clientid Ar string
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	204 Send the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	205 .Ar clientid .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	206 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	207 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	208 .Ar clientid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	209 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	210 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	211 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	212 .Ar clientid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	213 of the hardware family and the hardware address.
5551 0c4608a6cc2a options: Allow duid to take a value Roy Marples <roy@marples.name> parents: 5522 diff changeset	214 .It Ic duid Op ll \| lt \| uuid \| value
4288 0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4272 diff changeset	215 Use a DHCP Unique Identifier.
0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4272 diff changeset	216 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: 4272 diff changeset	217 otheriwse if persistent storage is available then a DUID-LLT
0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4272 diff changeset	218 (link local address + time) is generated,
0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4272 diff changeset	219 otherwise DUID-LL is generated (link local address).
5456 9203603adc76 duid: Allow optional argument to specify ll or llt alongside uuid Roy Marples <roy@marples.name> parents: 5435 diff changeset	220 The DUID type can be hinted as an optional parameter if the file
9203603adc76 duid: Allow optional argument to specify ll or llt alongside uuid Roy Marples <roy@marples.name> parents: 5435 diff changeset	221 .Pa @DBDIR@/duid
9203603adc76 duid: Allow optional argument to specify ll or llt alongside uuid Roy Marples <roy@marples.name> parents: 5435 diff changeset	222 does not exist.
5551 0c4608a6cc2a options: Allow duid to take a value Roy Marples <roy@marples.name> parents: 5522 diff changeset	223 If not
0c4608a6cc2a options: Allow duid to take a value Roy Marples <roy@marples.name> parents: 5522 diff changeset	224 .Va ll ,
0c4608a6cc2a options: Allow duid to take a value Roy Marples <roy@marples.name> parents: 5522 diff changeset	225 .Va lt
0c4608a6cc2a options: Allow duid to take a value Roy Marples <roy@marples.name> parents: 5522 diff changeset	226 or
0c4608a6cc2a options: Allow duid to take a value Roy Marples <roy@marples.name> parents: 5522 diff changeset	227 .Va uuid
0c4608a6cc2a options: Allow duid to take a value Roy Marples <roy@marples.name> parents: 5522 diff changeset	228 then
0c4608a6cc2a options: Allow duid to take a value Roy Marples <roy@marples.name> parents: 5522 diff changeset	229 .Va value
0c4608a6cc2a options: Allow duid to take a value Roy Marples <roy@marples.name> parents: 5522 diff changeset	230 will be converted from 00:11:22:33 format.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	231 This, plus the IAID will be used as the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	232 .Ic clientid .
4288 0bd4f5b53051 duid: Implement RFC 6355 Roy Marples <roy@marples.name> parents: 4272 diff changeset	233 The DUID generated will be held in
3995 329cbac97d4c Fix my silly mistake in a prior commit. Roy Marples <roy@marples.name> parents: 3987 diff changeset	234 .Pa @DBDIR@/duid
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	235 and should not be copied to other hosts.
5551 0c4608a6cc2a options: Allow duid to take a value Roy Marples <roy@marples.name> parents: 5522 diff changeset	236 This file also takes precedence over the above rules except for setting a value.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	237 .It Ic iaid Ar iaid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	238 Set the Interface Association Identifier to
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	239 .Ar iaid .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	240 This option must be used in an
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	241 .Ic interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	242 block.
4052 08038b46c0f5 Detect VLANID to use in IAID. Roy Marples <roy@marples.name> parents: 4020 diff changeset	243 This defaults to the VLANID (prefixed with 0xff) for the interface if set,
08038b46c0f5 Detect VLANID to use in IAID. Roy Marples <roy@marples.name> parents: 4020 diff changeset	244 otherwise the last 4 bytes of the hardware address assigned to the
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	245 interface.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	246 Each instance of this should be unique within the scope of the client and
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	247 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	248 warns if a conflict is detected.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	249 If there is a conflict, it is only a problem if the conflicted IAIDs are
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	250 used on the same network.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	251 .It Ic dhcp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	252 Enable DHCP on the interface, on by default.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	253 .It Ic dhcp6
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	254 Enable DHCPv6 on the interface, on by default.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	255 .It Ic ipv4
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	256 Enable IPv4 on the interface, on by default.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	257 .It Ic ipv6
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	258 Enable IPv6 on the interface, on by default.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	259 .It Ic request Op Ar address
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	260 Request the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	261 .Ar address
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	262 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	263 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	264 If no
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	265 .Ar address
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	266 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	267 .Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	268 is used.
4207 d9c3c7008d20 ipv4: allow configuration of static broadcast address Roy Marples <roy@marples.name> parents: 4197 diff changeset	269 .It Ic inform Op 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	270 Behaves like
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	271 .Ic request
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	272 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	273 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	274 .Ar address
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	275 in use.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	276 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	277 .Ar cidr
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	278 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	279 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	280 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	281 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	282 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	283 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	284 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	285 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	286 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	287 .It Ic inform6
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	288 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	289 No address is requested or specified, but all other DHCPv6 options are allowed.
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	290 This is normally performed automatically when an IPv6 Router Advertisement
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	291 indicates that the client should perform this operation.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	292 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	293 .Nm dhcpcd
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	294 is not processing IPv6 RA messages and the need for a DHCPv6 Information Request
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	295 exists.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	296 .It Ic persistent
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	297 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	298 normally de-configures the interface 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	299 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	300 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	301 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	302 You can use this option to stop this from happening.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	303 .It Ic fallback Ar profile
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	304 Fall back to using this profile if DHCP fails.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	305 This allows you to configure a static profile instead of using ZeroConf.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	306 .It Ic hostname Ar name
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	307 Sends the hostname
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	308 .Ar name
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	309 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	310 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	311 .Ar name
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	312 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	313 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	314 .Ar name
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	315 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	316 .It Ic hostname_short
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	317 Sends the short hostname to the DHCP server instead of the FQDN.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	318 This is useful because DHCP servers will not register the FQDN in their
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	319 DNS if the domain part does not match theirs.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	320 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	321 Also, see the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	322 .Ic env
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	323 option above to control how the hostname is set on the host.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	324 .It Ic ia_na Op Ar iaid Op / address
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	325 Request a DHCPv6 Normal Address for
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	326 .Ar iaid .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	327 .Ar iaid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	328 defaults to the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	329 .Ic iaid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	330 option as described above.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	331 You can request more than one ia_na by specifying a unique
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	332 .Ar iaid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	333 for each one.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	334 .It Ic ia_ta Op Ar iaid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	335 Request a DHCPv6 Temporary Address for
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	336 .Ar iaid .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	337 You can request more than one ia_ta by specifying a unique
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	338 .Ar iaid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	339 for each one.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	340 .It Ic ia_pd Op Ar iaid Oo / Ar prefix / Ar prefix_len Oc Op Ar interface Op / Ar sla_id Op / Ar prefix_len Op / Ar suffix
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	341 Request a DHCPv6 Delegated Prefix for
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	342 .Ar iaid .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	343 This option must be used in an
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	344 .Ic interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	345 block.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	346 Unless a
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	347 .Ar sla_id
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	348 of 0 is assigned with the same resultant prefix length as the delegation,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	349 a reject route is installed for the Delegated Prefix to
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	350 stop unallocated addresses being resolved upstream.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	351 If no
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	352 .Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	353 is given then we will assign a prefix to every other interface with a
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	354 .Ar sla_id
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	355 equivalent to the interface index assigned by the OS.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	356 Otherwise addresses are only assigned for each
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	357 .Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	358 and
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	359 .Ar sla_id .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	360 Each assigned address will have a
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	361 .Ar suffix ,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	362 defaulting to 1.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	363 If the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	364 .Ar suffix
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	365 is 0 then a SLAAC address is assigned.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	366 You cannot assign a prefix to the requesting interface unless the
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	367 DHCPv6 server supports the
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	368 .Li RFC 6603
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	369 Prefix Exclude Option.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	370 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	371 has to be running for all the interfaces it is delegating to.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	372 A default
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	373 .Ar prefix_len
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	374 of 64 is assumed, unless the maximum
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	375 .Ar sla_id
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	376 does not fit.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	377 In this case
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	378 .Ar prefix_len
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	379 is increased to the highest multiple of 8 that can accommodate the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	380 .Ar sla_id .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	381 .Ar sla_id
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	382 is an integer which must be unique inside the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	383 .Ar iaid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	384 and is added to the prefix which must fit inside
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	385 .Ar prefix_len
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	386 less the length of the delegated prefix.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	387 You can specify multiple
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	388 .Ar interface /
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	389 .Ar sla_id /
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	390 .Ar prefix_len
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	391 per
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	392 .Ic ia_pd ,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	393 space separated.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	394 IPv6RS should be disabled globally when requesting a Prefix Delegation.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	395 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	396 In the following example eth0 is the externally facing interface to be
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	397 configured for both IPv4 and IPv6.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	398 The DHCPv4 server will provide us with an IPv4 address and a default route.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	399 The DHCPv6 server is going to provide us with an IPv6 address, a default
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	400 route and a /64 subnet to be delegated to the internal interface.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	401 The eth1 interface will be automatically configured
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	402 for IPv6 using the first address (::1) from the delegated prefix.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	403 A second prefix is requested and assigned to two other interfaces.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	404 .Xr rtadvd 8
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	405 can be used with an empty configuration file on eth1, eth2 and eth3,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	406 to provide automatic
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	407 IPv6 address configuration for the internal network.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	408 .Bd -literal
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	409 noipv6rs # disable routing solicitation
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	410 denyinterfaces eth2 # Don't touch eth2 at all
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	411 interface eth0
4479 7cd8c57f33a0 dhcpcd.conf: Fix wording about ipv6rs Roy Marples <roy@marples.name> parents: 4333 diff changeset	412 ipv6rs # enable routing solicitation for eth0
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	413 ia_na 1 # request an IPv6 address
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	414 ia_pd 2 eth1/0 # request a PD and assign it to eth1
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	415 ia_pd 3 eth2/1 eth3/2 # req a PD and assign it to eth2 and eth3
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	416 .Ed
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	417 .It Ic ipv4only
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	418 Only configure IPv4.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	419 .It Ic ipv6only
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	420 Only configure IPv6.
4272 f1720bb9e425 Document fqdn none. Roy Marples <roy@marples.name> parents: 4266 diff changeset	421 .It Ic fqdn Op disable \| none \| ptr \| both
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	422 .Ar none
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	423 will not ask the DHCP server to update DNS.
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	424 .Ar ptr
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	425 just asks the DHCP server to update the PTR
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	426 record of the host in DNS, whereas
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	427 .Ar both
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	428 also updates the A record.
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	429 .Ar disable
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	430 will disable the FQDN option.
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	431 The default is
4317 f5f4a88c5224 dhcpcd.conf.5.in: A couple more minor tweaks David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4316 diff changeset	432 .Ar both .
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	433 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	434 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	435 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	436 encodes the FQDN hostname as specified in
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	437 .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	438 .It Ic interface Ar interface
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	439 Subsequent options are only parsed for this
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	440 .Ar interface .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	441 .It Ic ipv6ra_autoconf
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	442 Generate SLAAC addresses for each Prefix advertised by an IPv6
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	443 Router Advertisement message with the Auto flag set.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	444 On by default.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	445 .It Ic ipv6ra_noautoconf
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	446 Disables the above option.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	447 .It Ic ipv6ra_fork
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	448 By default, when
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	449 .Nm dhcpcd
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	450 receives an IPv6 Router Advertisement,
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	451 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	452 will only fork to the background if the RA contains at least one unexpired
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	453 RDNSS option and a valid prefix or no DHCPv6 instruction.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	454 Set this option so to make
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	455 .Nm dhcpcd
5153 8248b3a04908 inet6: Add 'temporary' directive to the slaac option Roy Marples <roy@marples.name> parents: 5076 diff changeset	456 always fork on a RA.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	457 .It Ic ipv6rs
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	458 Enables IPv6 Router Advertisement solicitation.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	459 This is on by default, but is documented here in the case where it is disabled
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	460 globally but needs to be enabled for one interface.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	461 .It Ic leasetime Ar seconds
5435 557a3f9f2be4 DHCP: allow leasetime -1 to represent infinity Roy Marples <roy@marples.name> parents: 5376 diff changeset	462 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	463 .Ar seconds .
5435 557a3f9f2be4 DHCP: allow leasetime -1 to represent infinity Roy Marples <roy@marples.name> parents: 5376 diff changeset	464 .Ar -1
557a3f9f2be4 DHCP: allow leasetime -1 to represent infinity Roy Marples <roy@marples.name> parents: 5376 diff changeset	465 represents an infinite lease time.
557a3f9f2be4 DHCP: allow leasetime -1 to represent infinity Roy Marples <roy@marples.name> parents: 5376 diff changeset	466 By default
557a3f9f2be4 DHCP: allow leasetime -1 to represent infinity Roy Marples <roy@marples.name> parents: 5376 diff changeset	467 .Nm dhcpcd
557a3f9f2be4 DHCP: allow leasetime -1 to represent infinity Roy Marples <roy@marples.name> parents: 5376 diff changeset	468 does not request any lease time and leaves it in the hands of the
557a3f9f2be4 DHCP: allow leasetime -1 to represent infinity Roy Marples <roy@marples.name> parents: 5376 diff changeset	469 DHCP server.
4415 4eb8ce6f854c options: add link_rcvbuf variable Roy Marples <roy@marples.name> parents: 4333 diff changeset	470 .It Ic link_rcvbuf Ar size
4eb8ce6f854c options: add link_rcvbuf variable Roy Marples <roy@marples.name> parents: 4333 diff changeset	471 Override the size of the link receive buffer from the kernel default.
4eb8ce6f854c options: add link_rcvbuf variable Roy Marples <roy@marples.name> parents: 4333 diff changeset	472 While
4eb8ce6f854c options: add link_rcvbuf variable Roy Marples <roy@marples.name> parents: 4333 diff changeset	473 .Nm dhcpcd
4eb8ce6f854c options: add link_rcvbuf variable Roy Marples <roy@marples.name> parents: 4333 diff changeset	474 will recover from link buffer overflows,
4eb8ce6f854c options: add link_rcvbuf variable Roy Marples <roy@marples.name> parents: 4333 diff changeset	475 this may not be desirable on heavily loaded systems.
4010 746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	476 .It Ic logfile Ar logfile
746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	477 Writes to the specified
4997 774f445ed677 logging: Always log to syslog(3). Roy Marples <roy@marples.name> parents: 4958 diff changeset	478 .Ar logfile .
774f445ed677 logging: Always log to syslog(3). Roy Marples <roy@marples.name> parents: 4958 diff changeset	479 .Nm dhcpcd
774f445ed677 logging: Always log to syslog(3). Roy Marples <roy@marples.name> parents: 4958 diff changeset	480 still writes to
4010 746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	481 .Xr syslog 3 .
746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	482 The
746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	483 .Ar logfile
4020 96edd7b26cff Note that the logfile is nolonger truncated by dhcpcd. Roy Marples <roy@marples.name> parents: 4010 diff changeset	484 is reopened when
4010 746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	485 .Nm dhcpcd
746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	486 receives the
746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	487 .Dv SIGUSR2
746684127581 logerr: errx with logging Roy Marples <roy@marples.name> parents: 3995 diff changeset	488 signal.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	489 .It Ic 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	490 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	491 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	492 will supply a default metric of 200 +
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	493 .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	494 An extra 100 will be added for wireless interfaces.
4705 0547b88164b4 man: Fix lint errors. Roy Marples <roy@marples.name> parents: 4652 diff changeset	495 .It Ic mudurl Ar url
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	496 Specifies the URL for a Manufacturer Usage Description (MUD).
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	497 The description is used by upstream network devices to instantiate any
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	498 desired access lists.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	499 See draft-ietf-opsawg-mud for more information.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	500 .It Ic noalias
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	501 Any pre-existing IPv4 addresses will be removed from the interface when
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	502 adding a new IPv4 address.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	503 .It Ic noarp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	504 Don't send any ARP requests.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	505 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	506 .It Ic noauthrequired
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	507 Don't require authentication even though we requested it.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	508 Also allows FORCERENEW and RECONFIGURE messages without authentication.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	509 .It Ic nodelay
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	510 Don't delay for an initial randomised time when starting protocols.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	511 .It Ic nodev
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	512 Don't load
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	513 .Pa /dev
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	514 management modules.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	515 .It Ic nodhcp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	516 Don't start DHCP or listen to DHCP messages.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	517 This is only useful when allowing IPv4LL.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	518 .It Ic nodhcp6
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	519 Don't start DHCPv6 or listen to DHCPv6 messages.
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	520 Normally DHCPv6 is started by an IPv6 Router Advertisement instruction or
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	521 configuration.
4067 1c2136f8886d Restore -G, --nogateway. Roy Marples <roy@marples.name> parents: 4053 diff changeset	522 .It Ic nogateway
1c2136f8886d Restore -G, --nogateway. Roy Marples <roy@marples.name> parents: 4053 diff changeset	523 Don't install any default routes.
1c2136f8886d Restore -G, --nogateway. Roy Marples <roy@marples.name> parents: 4053 diff changeset	524 .It Ic gateway
1c2136f8886d Restore -G, --nogateway. Roy Marples <roy@marples.name> parents: 4053 diff changeset	525 Install a default route if available (default).
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	526 .It Ic 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	527 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	528 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	529 .Pa .sh .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	530 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	531 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	532 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	533 from touching your DNS settings or starting wpa_supplicant 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	534 .D1 nohook resolv.conf, wpa_supplicant
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	535 .It Ic noipv4
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	536 Don't attempt to configure an IPv4 address.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	537 .It Ic noipv4ll
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	538 Don't attempt to obtain an IPv4LL address if we failed to get one via DHCP.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	539 See
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	540 .Rs
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	541 .%T "RFC 3927"
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	542 .Re
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	543 .It Ic noipv6
4218 f618f850efdc inet6: simplify setup of kernel Roy Marples <roy@marples.name> parents: 4209 diff changeset	544 Don't solicit or accept IPv6 Router Advertisements and DHCPv6.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	545 .It Ic noipv6rs
4218 f618f850efdc inet6: simplify setup of kernel Roy Marples <roy@marples.name> parents: 4209 diff changeset	546 Don't solicit or accept IPv6 Router Advertisements.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	547 .It Ic nolink
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	548 Don't receive link messages about carrier status.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	549 You should only set this for buggy interface drivers.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	550 .It Ic noup
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	551 Don't bring the interface up when 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	552 .It Ic 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	553 Requests the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	554 .Ar option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	555 from the server.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	556 It can be a variable to be used in
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	557 .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	558 or the numerical value.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	559 You can specify more
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	560 .Ar option Ns s
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	561 separated by commas, spaces or more
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	562 .Ic option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	563 lines.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	564 Prepend dhcp6_ to
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	565 .Ar option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	566 to request a DHCPv6 option.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	567 If no DHCPv6 options are configured,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	568 then DHCPv4 options are mapped to equivalent DHCPv6 options.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	569 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	570 Prepend nd_ to
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	571 .Ar option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	572 to handle ND options, but this only works for the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	573 .Ic nooption ,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	574 .Ic reject
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	575 and
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	576 .Ic require
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	577 options.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	578 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	579 To see a list of options you can use, call
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	580 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	581 with the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	582 .Fl V , Fl Fl variables
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	583 argument.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	584 .It Ic 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	585 Remove the option from the message before it's processed.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	586 .It Ic 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	587 Requires the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	588 .Ar option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	589 to be present in all 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	590 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	591 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	592 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	593 .Ic require
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	594 .Ar dhcp_message_type .
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	595 This isn't an exact science though because a BOOTP server can send DHCP-like
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	596 options.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	597 .It Ic reject Ar option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	598 Reject a message that contains the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	599 .Ar option .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	600 This is useful when you cannot use
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	601 .Ic require
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	602 to select / de-select BOOTP messages.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	603 .It Ic destination Ar option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	604 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	605 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	606 detects an address added to a point to point interface (PPP, TUN, etc) then
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	607 it will set the listed DHCP options to the destination address of the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	608 interface.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	609 .It Ic profile Ar name
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	610 Subsequent options are only parsed for this profile
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	611 .Ar name .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	612 .It Ic quiet
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	613 Suppress any dhcpcd output to the console, except for errors.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	614 .It Ic 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	615 Allow
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	616 .Ar reboot
5521 4396ae1267a0 dhcpcd.conf(5): mention fallback for the reboot option Roy Marples <roy@marples.name> parents: 5486 diff changeset	617 seconds before moving to the DISCOVER phase if we have an old lease to use.
4396ae1267a0 dhcpcd.conf(5): mention fallback for the reboot option Roy Marples <roy@marples.name> parents: 5486 diff changeset	618 Allow
4396ae1267a0 dhcpcd.conf(5): mention fallback for the reboot option Roy Marples <roy@marples.name> parents: 5486 diff changeset	619 .Ar reboot
4396ae1267a0 dhcpcd.conf(5): mention fallback for the reboot option Roy Marples <roy@marples.name> parents: 5486 diff changeset	620 seconds before starting fallback states from the DISCOVER phase.
4396ae1267a0 dhcpcd.conf(5): mention fallback for the reboot option Roy Marples <roy@marples.name> parents: 5486 diff changeset	621 IPv4LL is started when the first
4396ae1267a0 dhcpcd.conf(5): mention fallback for the reboot option Roy Marples <roy@marples.name> parents: 5486 diff changeset	622 .Ar reboot
4396ae1267a0 dhcpcd.conf(5): mention fallback for the reboot option Roy Marples <roy@marples.name> parents: 5486 diff changeset	623 timeout is reached.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	624 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	625 A setting of 0 seconds causes
5521 4396ae1267a0 dhcpcd.conf(5): mention fallback for the reboot option Roy Marples <roy@marples.name> parents: 5486 diff changeset	626 .Nm
4396ae1267a0 dhcpcd.conf(5): mention fallback for the reboot option Roy Marples <roy@marples.name> parents: 5486 diff changeset	627 to skip the reboot phase and go straight into DISCOVER.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	628 This is desirable for mobile users because if you change from network A to
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	629 network B and they use the same subnet and the address from network A isn't
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	630 in use on network B, then the DHCP server will remain silent even if
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	631 authoritative which means
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	632 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	633 will timeout before moving back to the DISCOVER phase.
5521 4396ae1267a0 dhcpcd.conf(5): mention fallback for the reboot option Roy Marples <roy@marples.name> parents: 5486 diff changeset	634 This has no effect on DHCPv6 other than skipping the reboot phase.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	635 .It Ic release
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	636 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	637 will release the lease prior to stopping the interface.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	638 .It Ic 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	639 Use
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	640 .Ar script
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	641 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	642 .Pa @SCRIPT@ .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	643 .It Ic ssid Ar ssid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	644 Subsequent options are only parsed for this wireless
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	645 .Ar ssid .
5153 8248b3a04908 inet6: Add 'temporary' directive to the slaac option Roy Marples <roy@marples.name> parents: 5076 diff changeset	646 .It Ic slaac Ar hwaddr \| Ar private Op Ar temp \| Ar temporary
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	647 Selects the interface identifier used for SLAAC generated IPv6 addresses.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	648 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	649 .Ar private
5153 8248b3a04908 inet6: Add 'temporary' directive to the slaac option Roy Marples <roy@marples.name> parents: 5076 diff changeset	650 is used, a RFC 7217 address is generated.
8248b3a04908 inet6: Add 'temporary' directive to the slaac option Roy Marples <roy@marples.name> parents: 5076 diff changeset	651 The
8248b3a04908 inet6: Add 'temporary' directive to the slaac option Roy Marples <roy@marples.name> parents: 5076 diff changeset	652 .Ar temporary
8248b3a04908 inet6: Add 'temporary' directive to the slaac option Roy Marples <roy@marples.name> parents: 5076 diff changeset	653 directive will create a temporary address for the prefix as well.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	654 .It Ic static Ar value
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	655 Configures a static
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	656 .Ar value .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	657 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	658 .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	659 then
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	660 .Nm dhcpcd
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	661 will not attempt to obtain a lease and will just use the value for the address
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	662 with 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	663 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	664 .Ic ip6_address ,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	665 .Nm dhcpcd
4652 fd05ef5cb087 Man page improvements. Sascha Wildner <swildner@dragonflybsd.org> parents: 4548 diff changeset	666 will continue auto-configuration as normal.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	667 .Pp
4207 d9c3c7008d20 ipv4: allow configuration of static broadcast address Roy Marples <roy@marples.name> parents: 4197 diff changeset	668 Here is an example which configures two static address, overriding the default
d9c3c7008d20 ipv4: allow configuration of static broadcast address Roy Marples <roy@marples.name> parents: 4197 diff changeset	669 IPv4 broadcast address, an IPv4 router, DNS and disables IPv6 auto-configuration.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	670 You could also use the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	671 .Ic inform6
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	672 command here if you wished to obtain more information via DHCPv6.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	673 For IPv4, you should use the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	674 .Ic inform Ar ipaddress
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	675 option instead of setting a static address.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	676 .D1 interface eth0
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	677 .D1 noipv6rs
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	678 .D1 static ip_address=192.168.0.10/24
4207 d9c3c7008d20 ipv4: allow configuration of static broadcast address Roy Marples <roy@marples.name> parents: 4197 diff changeset	679 .D1 static broadcast_address=192.168.0.63
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	680 .D1 static ip6_address=fd51:42f8:caae:d92e::ff/64
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	681 .D1 static routers=192.168.0.1
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	682 .D1 static domain_name_servers=192.168.0.1 fd51:42f8:caae:d92e::1
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	683 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	684 Here is an example for PPP which gives the destination a default route.
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	685 It uses the special
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	686 .Ar destination
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	687 keyword to insert the destination address
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	688 into the value.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	689 .D1 interface ppp0
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	690 .D1 static ip_address=
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	691 .D1 destination routers
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	692 .It Ic timeout Ar seconds
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	693 Time out after
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 seconds ,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	695 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	696 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	697 .Ar seconds
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	698 causes
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	699 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	700 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	701 If
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	702 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	703 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	704 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	705 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	706 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	707 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	708 If using IPv4LL then
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	709 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	710 start the IPv4LL process after the timeout and then wait a little longer
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	711 before really timing out.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	712 .It Ic userclass Ar string
5076 1d53edf5bdaa DHCP: Add support for the Microsoft User Class option Roy Marples <roy@marples.name> parents: 4997 diff changeset	713 Tag the DHCPv4 message with the userclass.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	714 You can specify more than one.
5076 1d53edf5bdaa DHCP: Add support for the Microsoft User Class option Roy Marples <roy@marples.name> parents: 4997 diff changeset	715 .It Ic msuserclass Ar string
1d53edf5bdaa DHCP: Add support for the Microsoft User Class option Roy Marples <roy@marples.name> parents: 4997 diff changeset	716 Tag the DHCPv4 mesasge with the Microsoft userclass.
1d53edf5bdaa DHCP: Add support for the Microsoft User Class option Roy Marples <roy@marples.name> parents: 4997 diff changeset	717 Unlike the
1d53edf5bdaa DHCP: Add support for the Microsoft User Class option Roy Marples <roy@marples.name> parents: 4997 diff changeset	718 .Ic userclass
1d53edf5bdaa DHCP: Add support for the Microsoft User Class option Roy Marples <roy@marples.name> parents: 4997 diff changeset	719 option, this one can only be added once.
1d53edf5bdaa DHCP: Add support for the Microsoft User Class option Roy Marples <roy@marples.name> parents: 4997 diff changeset	720 It should only be used for Microsoft DHCP servers and the
1d53edf5bdaa DHCP: Add support for the Microsoft User Class option Roy Marples <roy@marples.name> parents: 4997 diff changeset	721 .Ic vendorclassid
1d53edf5bdaa DHCP: Add support for the Microsoft User Class option Roy Marples <roy@marples.name> parents: 4997 diff changeset	722 should be set to "MSFT 98" or "MSFT 5.0".
1d53edf5bdaa DHCP: Add support for the Microsoft User Class option Roy Marples <roy@marples.name> parents: 4997 diff changeset	723 This option is not RFC compliant.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	724 .It Ic 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	725 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	726 .Ar code
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	727 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	728 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	729 .Ar code
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	730 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	731 Examples.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	732 .Pp
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	733 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	734 .D1 vendor 01,192.168.0.2
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	735 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	736 .D1 vendor 02,01:02:03:04:05
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	737 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	738 .D1 vendor 03,\e"192.168.0.2\e"
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	739 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	740 .D1 vendor ,"hello world"
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	741 .It Ic vendorclassid Ar string
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	742 Set the DHCP Vendor Class.
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	743 DHCPv6 has its own option as shown below.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	744 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	745 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	746 For example
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	747 .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	748 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	749 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	750 To work around it, try and impersonate Windows by using the MSFT vendorclassid.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	751 .It Ic vendclass Ar en Ar data
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	752 Add the DHCPv6 Vendor Indetifying Vendor Class with the IANA assigned Enterprise
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	753 Number
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	754 .Ar en
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	755 with the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	756 .Ar data .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	757 This option can be set more than once to add more data, but the behaviour,
4652 fd05ef5cb087 Man page improvements. Sascha Wildner <swildner@dragonflybsd.org> parents: 4548 diff changeset	758 as per RFC 3925 is undefined if the Enterprise Number differs.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	759 .It Ic waitip Op 4 \| 6
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	760 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	761 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	762 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	763 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	764 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	765 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	766 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	767 .Nm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	768 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	769 .It Ic xidhwaddr
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	770 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	771 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	772 .El
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	773 .Ss Defining new options
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	774 DHCP, ND and DHCPv6 allow for the use of custom options, and RFC 3925 vendor
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	775 options for DHCP can also be supplied.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	776 Each option needs to be started with the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	777 .Ic define ,
4705 0547b88164b4 man: Fix lint errors. Roy Marples <roy@marples.name> parents: 4652 diff changeset	778 .Ic definend ,
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	779 .Ic define6
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	780 or
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	781 .Ic vendopt
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	782 directive.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	783 This can optionally be followed by both
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	784 .Ic embed
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	785 or
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	786 .Ic encap
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	787 options.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	788 Both can be specified more than once and
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	789 .Ic embed
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	790 must come before
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	791 .Ic encap .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	792 .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	793 .It Ic define Ar code Ar type Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	794 Defines the DHCP option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	795 .Ar code
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	796 of
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	797 .Ar type
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	798 with a name of
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	799 .Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	800 exported to
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	801 .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	802 .It Ic definend Ar code Ar type Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	803 Defines the ND option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	804 .Ar code
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	805 of
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	806 .Ar type
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	807 with a name of
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	808 .Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	809 exported to
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	810 .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	811 with a prefix of
5219 dc62219c044c Fix neighbor discovery option parsing (#16) Andrew Childs <lorne@cons.org.nz> parents: 5153 diff changeset	812 .Va nd_ .
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	813 .It Ic define6 Ar code Ar type Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	814 Defines the DHCPv6 option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	815 .Ar code
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	816 of
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	817 .Ar type
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	818 with a name of
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	819 .Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	820 exported to
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	821 .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	822 with a prefix of
5219 dc62219c044c Fix neighbor discovery option parsing (#16) Andrew Childs <lorne@cons.org.nz> parents: 5153 diff changeset	823 .Va dhcp6_ .
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	824 .It Ic vendopt Ar code Ar type Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	825 Defines the Vendor-Identifying Vendor Options.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	826 The
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	827 .Ar code
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	828 is the IANA Enterprise Number which will uniquely describe the encapsulated
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	829 options.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	830 .Ar type
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	831 is normally
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	832 .Ar encap .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	833 .Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	834 names the Vendor option to be exported.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	835 .It Ic embed Ar type Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	836 Defines an embedded variable within the defined option.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	837 The length is determined by the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	838 .Ar type .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	839 If the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	840 .Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	841 is not the same as defined in the parent option,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	842 it is prefixed with the parent
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	843 .Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	844 first with an underscore.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	845 If the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	846 .Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	847 has the name of
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	848 .Ar reserved
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	849 then it is not processed.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	850 .It Ic encap Ar code Ar type Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	851 Defines an encapsulated variable within the defined option.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	852 The length is determined by the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	853 .Ar type .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	854 If the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	855 .Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	856 is not the same as defined in the parent option,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	857 it is prefixed with the parent
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	858 .Ar variable
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	859 first with an underscore.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	860 .El
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	861 .Ss Type prefix
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	862 These keywords come before the type itself, to describe it more fully.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	863 You can use more than one, but they must appear in the order listed below.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	864 .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	865 .It Ic request
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	866 Requests the option by default without having to be specified in user
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	867 configuration.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	868 .It Ic norequest
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	869 This option cannot be requested, regardless of user configuration.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	870 .It Ic optional
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	871 This option is optional.
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	872 Only makes sense for embedded options like the client FQDN option, where
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	873 the FQDN string itself is optional.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	874 .It Ic index
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	875 The option can appear more than once and will be indexed.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	876 .It Ic array
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	877 The option data is split into a space separated array, each element being
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	878 the same type.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	879 .El
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	880 .Ss Types to define
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	881 The type directly affects the length of data consumed inside the option.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	882 Any remaining data is normally discarded.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	883 Lengths can be specified for string and binhex types, but this is generally
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	884 with other data embedded afterwards in the same option.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	885 .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	886 .It Ic ipaddress
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	887 An IPv4 address, 4 bytes.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	888 .It Ic ip6address
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	889 An IPv6 address, 16 bytes.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	890 .It Ic string Op : Ic length
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	891 A NVT ASCII string of printable characters.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	892 .It Ic byte
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	893 A byte.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	894 .It Ic bitflags : Ic flags
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	895 A byte represented as a string of flags, most significant bit first.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	896 For example, using ABCDEFGH then A would equal 10000000, B 01000000,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	897 C 00100000, etc.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	898 If the bit is not set, the flag is not printed.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	899 A flag of 0 is not printed even if the bit position is set.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	900 This is to allow reservation of the first bits while assigning the last bits.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	901 .It Ic int16
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	902 A signed 16bit integer, 2 bytes.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	903 .It Ic uint16
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	904 An unsigned 16bit integer, 2 bytes.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	905 .It Ic int32
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	906 A signed 32bit integer, 4 bytes.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	907 .It Ic uint32
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	908 An unsigned 32bit integer, 4 bytes.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	909 .It Ic flag
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	910 A fixed value (1) to indicate that the option is present, 0 bytes.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	911 .It Ic domain
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	912 An RFC 3397 encoded string.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	913 .It Ic dname
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	914 An RFC 1035 validated string.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	915 .It Ic binhex Op : Ic length
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	916 Binary data expressed as hexadecimal.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	917 .It Ic embed
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	918 Contains embedded options (implies encap as well).
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	919 .It Ic encap
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	920 Contains encapsulated options (implies embed as well).
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	921 .It Ic option
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	922 References an option from the global definition.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	923 .El
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	924 .Ss Example definition
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	925 .D1 # DHCP option 81, Fully Qualified Domain Name, RFC 4702
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	926 .D1 define 81 embed fqdn
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	927 .D1 embed byte flags
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	928 .D1 embed byte rcode1
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	929 .D1 embed byte rcode2
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	930 .D1 embed domain fqdn
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	931 .Pp
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	932 .D1 # DHCP option 125, Vendor Specific Information Option, RFC 3925
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	933 .D1 define 125 encap vsio
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	934 .D1 embed uint32 enterprise_number
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	935 .D1 # Options defined for the enterprise number
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	936 .D1 encap 1 ipaddress ipaddress
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	937 .Ss Supported Authentication Protocols
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	938 .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	939 .It Ic token
4266 bd15cb1af330 auth: allow different tokens for send and receive Roy Marples <roy@marples.name> parents: 4218 diff changeset	940 Sends a plain text token the server expects and matches a token sent by
bd15cb1af330 auth: allow different tokens for send and receive Roy Marples <roy@marples.name> parents: 4218 diff changeset	941 the server.
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	942 The tokens do not have to be the same.
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	943 If unspecified, the token with a
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	944 .Ar secretid
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	945 of 0 will be used in sending messages
4266 bd15cb1af330 auth: allow different tokens for send and receive Roy Marples <roy@marples.name> parents: 4218 diff changeset	946 and validating received messages.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	947 .It Ic delayedrealm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	948 Delayed Authentication.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	949 .Nm dhcpcd
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	950 will send an authentication option with no key or MAC.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	951 The server will see this option, and select a key for
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	952 .Nm , writing the
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	953 .Ar realm
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	954 and
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	955 .Ar secretid
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	956 in it.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	957 .Nm dhcpcd
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	958 will then look for an unexpired token with a matching
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	959 .Ar realm
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	960 and
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	961 .Ar secretid .
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	962 This token is used to authenticate all other messages.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	963 .It Ic delayed
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	964 Same as above, but without a realm.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	965 .El
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	966 .Ss Supported Authentication Algorithms
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	967 If none specified,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	968 .Ic hmac-md5
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	969 is the default.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	970 .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	971 .It Ic hmac-md5
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	972 .El
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	973 .Ss Supported Replay Detection Mechanisms
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	974 If none specified,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	975 .Ic monotonic
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	976 is the default.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	977 If this is changed from what was previously used,
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	978 or the means of calculating or storing it is broken, then the DHCP server
4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	979 will probably have to have its notion of the client's Replay Detection Value
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	980 reset.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	981 .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	982 .It Ic monocounter
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	983 Read the number in the file
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	984 .Pa @DBDIR@/dhcpcd-rdm.monotonic
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	985 and add one to it.
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	986 .It Ic monotime
4316 4c5d6bcd36e0 dhcpcd.conf.5.in: Fix various typos, add more markup, etc. David H. Gutteridge <dhgutteridge@hotmail.com> parents: 4288 diff changeset	987 Create an NTP timestamp from the system time.
3932 e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	988 .It Ic monotonic
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	989 Same as
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	990 .Ic monotime .
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	991 .El
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	992 .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	993 .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	994 .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	995 .Xr dhcpcd 8 ,
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	996 .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	997 .Sh AUTHORS
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	998 .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	999 .Sh BUGS
e802a4235d75 Move the source files along with dev, crypt and comapt into src dir. Roy Marples <roy@marples.name> parents: diff changeset	1000 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	1001 .Lk http://roy.marples.name/projects/dhcpcd

Mercurial > hg > dhcpcd

annotate src/dhcpcd.conf.5.in @ 5551:0c4608a6cc2a draft