.Nm
normally sends a DHCP Broadcast to find servers to offer an address.
.Nm
-will then request the address used. You can use this option to skip the
-broadcast step and just request an
+will then request the address used.
+You can use this option to skip the broadcast step and just request an
.Ar address .
-The downside is if you request
-an
+The downside is if you request an
.Ar address
the DHCP server does not know about or the DHCP server is not
-authorative, it will remain silent. In this situation, we go back to the init
-state and broadcast again.
+authorative, it will remain silent.
+In this situation, we go back to the init state and broadcast again.
If no
.Ar address
is given then we use the first address currently assigned to the
.It Fl s , -inform Op Ar address Op / Ar cidr
Behaves exactly like
.Fl r , -request
-as above, but sends a DHCP inform instead of a request. This requires the
-interface to be configured first. This does not get a lease as such, just
-notifies the DHCP server of the
+as above, but sends a DHCP inform instead of a request.
+This requires the interface to be configured first.
+This does not get a lease as such, just notifies the DHCP server of the
.Ar address
-we are using. If we fail to contact a DHCP server then we return a failure
-instead of falling back on IPv4LL.
+we are using.
+If we fail to contact a DHCP server then we return a failure instead of falling
+back on IPv4LL.
.It Fl t , -timeout Ar seconds
Timeout after
.Ar seconds ,
.Rs
.%T "RFC 4361"
.Re
-compliant clientid. This requires persistent storage
-and not all DHCP servers work with it so it's not enabled by default.
+compliant clientid.
+This requires persistent storage and not all DHCP servers work with it so it's
+not enabled by default.
The DUID generated will be held in
.Pa @SYSCONFDIR@/dhcpcd.duid
and should not be copied to other hosts.
.It Fl F , -fqdn Ar fqdn
Requests that the DHCP server updates DNS using FQDN instead of just a
-hostname. Valid values for
+hostname.
+Valid values for
.Ar fqdn
are none, ptr and both.
The current hostname or the hostname specified using the
.El
.Ss Restriciting behaviour
.Nm
-will try to do as much as it can by default. However, there are sometimes
-situations where you don't want the things to be configured exactly how the
-the DHCP server wants. Here are some option that deal with turning these bits
-off.
+will try to do as much as it can by default.
+However, there are sometimes situations where you don't want the things to be
+configured exactly how the the DHCP server wants.
+Here are some option that deal with turning these bits off.
.Bl -tag -width indent
.It Fl A , -noarp
Don't request or claim the address by ARP.
.It Fl L , -noipv4ll
Don't use IPv4LL at all.
.It Fl O , -nooption Ar option
-Don't request the specified option. If no option given, then don't request
-any options other than those to configure the interface and routing.
+Don't request the specified option.
+If no option given, then don't request any options other than those to
+configure the interface and routing.
.It Fl T, -test
On receipt of discover messages we just call
.Pa @SCRIPT@
with the reason of TEST which echo's the DHCP variables found in the message
-to the console. The interface configuration isn't touched and neither are any
-configuration files.
+to the console.
+The interface configuration isn't touched and neither are any configuration
+files.
.It Fl V, -variables
Display a list of option codes and the associated variable for use in
.Xr dhcpcd.sh 8 .
Although
.Nm dhcpcd
can do everything from the command line, there are cases where it's just easier
-to do it once in a configuration file. Most of the options found in
+to do it once in a configuration file.
+Most of the options found in
.Xr dhcpcd 8
-can be used here. The first word on the line is the option and the rest of the
-line is the value. Leading and trailing whitespace for the option and value
-are trimmed. You can escape characters in the value using the \\ character.
+can be used here.
+The first word on the line is the option and the rest of the line is the value.
+Leading and trailing whitespace for the option and value are trimmed.
+You can escape characters in the value using the \\ character.
.Pp
Blank lines and lines starting with # are ignored.
.Pp
Here's a list of available options:
.Bl -tag -width indent
.It Ic classid Ar string
-Change the default classid sent from dhcpcd-version. If not set then none
-is sent.
+Change the default classid sent from dhcpcd-version.
+If not set then none is sent.
.It Ic clientid Ar string
Change the default clientid sent from the interface hardware address.
If the string is of the format 01:02:03 then it is encoded as hex.
.Rs
.%T "RFC 4361"
.Re
-compliant clientid. This requires persistent storage
-and not all DHCP servers work with it so it's not enabled by default.
+compliant clientid.
+This requires persistent storage and not all DHCP servers work with it so it's
+not enabled by default.
The duid generated will be held in
.Pa @SYSCONFDIR@/dhcpcd.duid
and should not be copied to other hosts.
Request a leasetime of
.Ar seconds .
.It Ic noarp
-Don't send any ARP requests. This also disables IPv4LL.
+Don't send any ARP requests.
+This also disables IPv4LL.
.It Ic nogateway
Don't install any default routes.
.It Ic noipv4ll
.It Ic option Ar dhcp-option
Requests the
.Ar dhcp-option
-from the server. It can be a variable to be used in
+from the server.
+It can be a variable to be used in
.Xr dhcpcd.sh 8
-or the numerical value. You can specify more seperated by commas, spaces or
-more option lines.
+or the numerical value.
+You can specify more seperated by commas, spaces or more option lines.
.It Ic script Ar script
Use
.Ar script
The default timeout for waiting for a DHCP response is 20 seconds which may
be too long or too short and can be changed here.
.It Ic userclass Ar string
-Tag the DHCP messages with the userclass. You can specify more than one.
+Tag the DHCP messages with the userclass.
+You can specify more than one.
.El
.Sh SEE ALSO
.Xr dhcpcd.sh 8 ,
.Ev $reason
is to the reason why
.Nm
-was invoked. DHCP information to be configured is held in variables starting
-with the word new_ and old DHCP information to be removed is held in variables
-starting with the word old_.
+was invoked.
+DHCP information to be configured is held in variables starting with the word
+new_ and old DHCP information to be removed is held in variables starting with
+the word old_.
.Nm dhcpcd
can display the full list of variables it knows how about by using the
.Fl V , -variables
dhcpcd failed to contact any DHCP servers but was able to use an old lease.
.It Dv TEST
dhcpcd received an OFFER from a DHCP server but will not configure the
-interface. This is primarily used to test the variables are filled correctly
-for the script to process them.
+interface.
+This is primarily used to test the variables are filled correctly for the
+script to process them.
.El
.Sh FILES
When
projects / thirdparty / dhcpcd.git / commitdiff
