source: BOOK/network/common/dhcpcd.xml@ 1274b62

systemd
Last change on this file since 1274b62 was 1ecf563, checked in by Chris Staub <chris@…>, 10 years ago

Use nodump to prevent jhalfs from processing network config commands

  • Property mode set to 100644
File size: 4.1 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 --prefix=/usr --sbindir=/sbin \
34 --sysconfdir=/etc --dbdir=/var/lib/dhcpcd --libexecdir=/usr/lib/dhcpcd</userinput></screen>
35
36 <para os="d">Compile the package:</para>
37
38<screen os="e" role="nodump"><userinput>make</userinput></screen>
39
40 <para os="f">This package does not come with a test suite.</para>
41
42 <para os="g">Install the package:</para>
43
44<screen os="h" role="nodump"><userinput>make install</userinput></screen>
45
46 </sect2>
47
48 <sect2 id="conf-dhcpcd" role="configuration">
49 <title>Creating the DHCP Network Interface Configuration File</title>
50
51 <para>The following is an example for the eth0 interface. Refer to the
52 dhcpcd.conf man page for more information. This step may be skipped if
53 default behavior of dhcpcd is required.</para>
54
55 <para>Create the <filename>/etc/dhcpcd.conf</filename> configuration file
56 using the following commands. Adjust appropriately for additional options:</para>
57
58<screen role="nodump"><userinput>cd /etc &amp;&amp;
59cat &gt; dhcpcd.conf &lt;&lt; "EOF"
60<literal># dhcpcd configuration eth0 interface
61# See dhcpcd.conf(5) for details.
62
63interface eth0
64# dhcpcd-run-hooks uses these options.
65option subnet_mask, routers, domain_name_servers
66
67# The default timeout for waiting for a DHCP response is 30 seconds
68# which may be too long or too short and can be changed here.
69timeout 16</literal>
70EOF</userinput></screen>
71
72 <para>To configure another Static Interface, Follow <xref linkend="ch-network-static"/>.</para>
73
74 </sect2>
75
76 <sect2>
77 <title>Configuring the Network Interface at boot</title>
78
79 <para>Enabling of the Network Interface configuration is
80 done per interface. To enable Network Interface
81 configuration at boot, run:</para>
82
83<screen role="nodump"><userinput>systemctl enable dhcpcd@eth0</userinput></screen>
84
85 <para>To disable previously enabled Network Interface
86 configuration at boot, run:</para>
87
88<screen role="nodump"><userinput>systemctl disable dhcpcd@eth0</userinput></screen>
89
90 <para>To manually start the Network Interface configuration,
91 run:</para>
92
93<screen role="nodump"><userinput>systemctl start dhcpcd@eth0</userinput></screen>
94
95 <para>Replace eth0 with the correct Network Interface
96 name as described on the beginning of this page.</para>
97
98 </sect2>
99
100 <sect2 id="contents-dhcpcd" role="content">
101 <title>Contents of dhcpcd</title>
102
103 <segmentedlist>
104 <segtitle>Installed files</segtitle>
105
106 <seglistitem>
107 <seg>dhcpcd</seg>
108 </seglistitem>
109 </segmentedlist>
110
111 <variablelist>
112 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
113 <?dbfo list-presentation="list"?>
114 <?dbhtml list-presentation="table"?>
115
116 <varlistentry id="dhcpcd">
117 <term><command>dhcpcd</command></term>
118 <listitem>
119 <para>dhcpcd is an implementation of the DHCP client specified in
120 RFC 2131. It gets the host information from a DHCP server and
121 configures the network interface automatically.</para>
122 <indexterm zone="ch-network-dhcpcd">
123 <primary sortas="e-dhcpcd">dhcpcd</primary>
124 </indexterm>
125 </listitem>
126 </varlistentry>
127
128 </variablelist>
129
130 </sect2>
131
132</sect1>
Note: See TracBrowser for help on using the repository browser.