source: BOOK/network/common/dhcpcd.xml@ 7ddb05f

sysvinit
Last change on this file since 7ddb05f was b27081c4, checked in by Chris Staub <chris@…>, 9 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.