Revise DHCP section to mention "SYNCDHCP" option.

Approved by:	gjb (mentor)
This commit is contained in:
Warren Block 2011-10-16 17:28:18 +00:00
parent d3dcf6d039
commit 5de58ec282
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=37834

View file

@ -2645,22 +2645,44 @@ nis_client_flags="-S <replaceable>NIS domain</replaceable>,<replaceable>server</
</note>
</listitem>
<listitem>
<para>Edit your <filename>/etc/rc.conf</filename> to
include the following:</para>
<para>By default, DHCP configuration on &os; runs in the
background, or <firstterm>asynchronously</firstterm>.
Other startup scripts continue to run while DHCP
completes, speeding up system startup.</para>
<programlisting>ifconfig_fxp0="DHCP"</programlisting>
<para>Background DHCP works well when the DHCP server
responds quickly to requests and the DHCP configuration
process goes quickly. However, DHCP may take a long time
to complete on some systems. If network services attempt
to run before DHCP has completed, they will fail. Using
DHCP in <firstterm>synchronous</firstterm> mode prevents
the problem, pausing startup until DHCP configuration has
completed.</para>
<para>To connect to a DHCP server in the background while
other startup continues (asynchronous mode), use the
<quote><literal>DHCP</literal></quote> value in
<filename>/etc/rc.conf</filename>:</para>
<programlisting>ifconfig_<replaceable>fxp0</replaceable>="DHCP"</programlisting>
<para>To pause startup while DHCP completes, use synchronous
mode with the <quote><literal>SYNCDHCP</literal></quote>
value:</para>
<programlisting>ifconfig_<replaceable>fxp0</replaceable>="SYNCDHCP"</programlisting>
<note>
<para>Be sure to replace <literal>fxp0</literal> with the
designation for the interface that you wish to dynamically
configure, as described in
<para>Replace the <replaceable>fxp0</replaceable> shown in
these examples with the name of the interface to be
dynamically configured, as described in
<xref linkend="config-network-setup">.</para>
</note>
<para>If you are using a different location for
<command>dhclient</command>, or if you wish to pass additional
flags to <command>dhclient</command>, also include the
following (editing as necessary):</para>
flags to <command>dhclient</command>, also include
(editing as necessary):</para>
<programlisting>dhclient_program="/sbin/dhclient"
dhclient_flags=""</programlisting>