source: BOOK/network/common/dhcpcd.xml @ b27081c4

sysvinit
Last change on this file since b27081c4 was b27081c4, checked in by Chris Staub <chris@…>, 8 years ago

Put one configure option per line

  • Property mode set to 100644
File size: 3.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  %general-entities;
6]>
7
8<sect1 id="ch-network-dhcpcd" role="wrap">
9  <?dbhtml filename="dhcpcd.html"?>
10
11  <title>DHCPCD-&dhcpcd-version;</title>
12
13  <indexterm zone="ch-network-dhcpcd">
14    <primary sortas="a-DHCPCD">DHCPCD</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
20    <para>The DHCPCD package provides a DHCP Client for network configuration.</para>
21
22  </sect2>
23
24  <sect2 role="installation">
25    <title>Installation of DHCPCD</title>
26
27    <para os="a">If you wish to configure your network to connect to a DHCP
28      server, you will first need to install a DHCP client. CLFS uses the
29      DHCPCD package for this.</para>
30
31    <para os="b">Prepare DHCPCD for compilation:</para>
32
33<screen os="c" role="nodump"><userinput>./configure \
34    --prefix=/usr \
35    --sbindir=/sbin \
36    --sysconfdir=/etc \
37    --dbdir=/var/lib/dhcpcd \
38    --libexecdir=/usr/lib/dhcpcd</userinput></screen>
39
40    <para os="d">Compile the package:</para>
41
42<screen os="e" role="nodump"><userinput>make</userinput></screen>
43
44    <para os="f">This package does not come with a test suite.</para>
45
46    <para os="g">Install the package:</para>
47
48<screen os="h" role="nodump"><userinput>make install</userinput></screen>
49
50  </sect2>
51
52  <sect2 id="conf-dhcpcd" role="configuration">
53    <title>Creating the DHCP Network Interface Configuration Files</title>
54
55    <para>First install the service from the CLFS Bootscripts package:</para>
56
57<screen role="nodump"><userinput>tar -xvf bootscripts-cross-lfs-&bootscripts-clfs-version;.tar.xz
58cd bootscripts-cross-lfs-&bootscripts-clfs-version;
59make install-service-dhcpcd</userinput></screen>
60
61    <para>Finally, create the
62    <filename>/etc/sysconfig/network-devices/ifconfig.eth0/dhcpcd</filename>
63    configuration file using the following commands. Adjust appropriately for
64    additional interfaces:</para>
65
66<screen role="nodump"><userinput>cd /etc/sysconfig/network-devices &amp;&amp;
67mkdir -v ifconfig.eth0 &amp;&amp;
68cat &gt; ifconfig.eth0/dhcpcd &lt;&lt; "EOF"
69<literal>ONBOOT="yes"
70SERVICE="dhcpcd"
71
72# Start Command for DHCPCD
73DHCP_START="-q"
74
75# Stop Command for DHCPCD
76DHCP_STOP="-k"</literal>
77EOF</userinput></screen>
78
79    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
80    href="static.xml"
81    xpointer="xpointer(//*[@os='var-ob'])"/>
82
83    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
84    href="static.xml"
85    xpointer="xpointer(//*[@os='var-s'])"/>
86
87    <para>The <envar>DHCP_START</envar> and <envar>DHCP_STOP</envar> variables
88    arguments that are passed onto <filename>dhcpcd</filename> when starting
89    and stoppping the service. More information about what can be passed can
90    be found in the <filename>dhcpcd(8)</filename> man page.</para>
91
92    <para>To configure another Static Interface, Follow <xref linkend="ch-network-static"/>.</para>
93
94  </sect2>
95
96  <sect2 id="contents-dhcpcd" role="content">
97    <title>Contents of dhcpcd</title>
98
99    <segmentedlist>
100      <segtitle>Installed files</segtitle>
101
102      <seglistitem>
103        <seg>dhcpcd</seg>
104      </seglistitem>
105    </segmentedlist>
106
107    <variablelist>
108      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
109      <?dbfo list-presentation="list"?>
110      <?dbhtml list-presentation="table"?>
111
112      <varlistentry id="dhcpcd">
113        <term><command>dhcpcd</command></term>
114        <listitem>
115          <para>dhcpcd is an implementation of the DHCP client specified in
116          RFC 2131. It gets the host information from a DHCP server and
117          configures the network interface automatically.</para>
118          <indexterm zone="ch-network-dhcpcd">
119            <primary sortas="e-dhcpcd">dhcpcd</primary>
120          </indexterm>
121        </listitem>
122      </varlistentry>
123
124    </variablelist>
125
126  </sect2>
127
128</sect1>
Note: See TracBrowser for help on using the repository browser.