source: basicnet/netprogs/net-tools.xml@ 6f67372

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gimp3 gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 6f67372 was 1080241, checked in by Randy McMurchy <randy@…>, 18 years ago

Renamed the 'unpacking' page in Chapter 2 to 'building-notes' as this more accurately reflects the page and added a new section 'Automated Building Procedures' to the 'building-notes' page

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5615 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 12.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY net-tools-download-http "http://www.tazenda.demon.co.uk/phil/net-tools/net-tools-&net-tools-version;.tar.bz2">
8 <!ENTITY net-tools-download-ftp "ftp://ftp.ibiblio.org/pub/Linux/distributions/rootlinux/rootlinux-1.3/source/base/net-tools/net-tools-&net-tools-version;.tar.gz">
9 <!ENTITY net-tools-md5sum-http "888774accab40217dde927e21979c165">
10 <!ENTITY net-tools-md5sum-ftp "e1e83a4d4cdd72d35bcf90d76a16206f">
11 <!ENTITY net-tools-size "194 KB">
12 <!ENTITY net-tools-buildsize "4.3 MB">
13 <!ENTITY net-tools-time "0.1 SBU">
14 <!ENTITY lfs-coreutils-version "5.93">
15]>
16
17<sect1 id="net-tools" xreflabel="Net-tools-&net-tools-version;">
18 <?dbhtml filename="net-tools.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 <keywordset>
24 <keyword role="package">net-tools-&net-tools-version;.tar</keyword>
25 <keyword role="ftpdir">net-tools</keyword>
26 </keywordset>
27 </sect1info>
28
29 <title>Net-tools-&net-tools-version;</title>
30
31 <indexterm zone="net-tools">
32 <primary sortas="a-Net-tools">Net-tools</primary>
33 </indexterm>
34
35 <sect2 role="package">
36 <title>Introduction to Net-tools</title>
37
38 <para>The <application>Net-tools</application> package is a collection
39 of programs for controlling the network subsystem of the Linux
40 kernel.</para>
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>Download (HTTP): <ulink url="&net-tools-download-http;"/></para>
46 </listitem>
47 <listitem>
48 <para>Download (FTP): <ulink url="&net-tools-download-ftp;"/></para>
49 </listitem>
50 <listitem>
51 <para>Download MD5 sum (HTTP): &net-tools-md5sum-http;</para>
52 </listitem>
53 <listitem>
54 <para>Download MD5 sum (FTP): &net-tools-md5sum-ftp;</para>
55 </listitem>
56 <listitem>
57 <para>Download size: &net-tools-size;</para>
58 </listitem>
59 <listitem>
60 <para>Estimated disk space required: &net-tools-buildsize;</para>
61 </listitem>
62 <listitem>
63 <para>Estimated build time: &net-tools-time;</para>
64 </listitem>
65 </itemizedlist>
66
67 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
68 <itemizedlist spacing="compact">
69 <listitem>
70 <para>Required Patch: <ulink
71 url="&patch-root;/net-tools-&net-tools-version;-gcc34-3.patch"/></para>
72 </listitem>
73 <listitem>
74 <para>Required Patch: <ulink
75 url="&patch-root;/net-tools-&net-tools-version;-kernel_headers-2.patch"/></para>
76 </listitem>
77 <listitem>
78 <para>Required Patch: <ulink
79 url="&patch-root;/net-tools-&net-tools-version;-mii_ioctl-1.patch"/></para>
80 </listitem>
81 </itemizedlist>
82
83 </sect2>
84
85 <sect2 role="installation">
86 <title>Installation of Net-tools</title>
87
88 <note>
89 <para>The <application>Net-tools</application> package installs a
90 <command>hostname</command> program which will overwrite the existing
91 program installed by <application>Coreutils</application> during a base
92 LFS installation. If, for whatever reason, you need to reinstall the
93 <application>Coreutils</application> package after installing
94 <application>Net-tools</application>, you should apply the
95 <filename>coreutils-&lfs-coreutils-version;-suppress_hostname-1.patch</filename>
96 patch (after the other patches) if you wish to preserve the
97 <application>Net-tools</application> <command>hostname</command>
98 program.</para>
99 </note>
100
101 <para id="net-tools-automate-example" xreflabel="Net-tools">The
102 instructions below automate the configuration process by piping
103 <command>yes</command> to the <command>make config</command> command. If
104 you wish to run the interactive configuration process (by changing the
105 instruction to just <command>make config</command>), but you are not sure
106 how to answer all the questions, then just accept the defaults. This will
107 be just fine in the majority of cases. What you're asked here is a bunch of
108 questions about which network protocols you've enabled in your kernel. The
109 default answers will enable the tools from this package to work with the
110 most common protocols: TCP, PPP, and several others. You still need to
111 actually enable these protocols in the kernel&mdash;what you do here is
112 merely tell the package to include support for those protocols in its
113 programs, but it's up to the kernel to make the protocols available.</para>
114
115 <para>Install <application>Net-tools</application> by running the
116 following commands:</para>
117
118<screen><userinput>patch -Np1 -i ../net-tools-&net-tools-version;-gcc34-3.patch &amp;&amp;
119patch -Np1 -i ../net-tools-&net-tools-version;-kernel_headers-2.patch &amp;&amp;
120patch -Np1 -i ../net-tools-&net-tools-version;-mii_ioctl-1.patch &amp;&amp;
121yes "" | make config &amp;&amp;
122sed -i -e 's|HAVE_IP_TOOLS 0|HAVE_IP_TOOLS 1|g' \
123 -e 's|HAVE_MII 0|HAVE_MII 1|g' config.h &amp;&amp;
124sed -i -e 's|# HAVE_IP_TOOLS=0|HAVE_IP_TOOLS=1|g' \
125 -e 's|# HAVE_MII=0|HAVE_MII=1|g' config.make &amp;&amp;
126make</userinput></screen>
127
128 <para>This package does not come with a test suite.</para>
129
130 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
131
132<screen role='root'><userinput>make update</userinput></screen>
133
134 </sect2>
135
136 <sect2 role="commands">
137 <title>Command Explanations</title>
138
139 <para><command>yes "" | make config</command>: Piping <command>yes</command>
140 to <command>make config</command> skips the interactive configuration and
141 accepts the defaults.</para>
142
143 <para><command>sed -i -e ...</command>: These two <command>sed</command>s
144 change the configuration files to force building the
145 <command>ipmaddr</command>, <command>iptunnel</command> and
146 <command>mii-tool</command> programs.</para>
147
148 </sect2>
149
150 <sect2 role="content">
151 <title>Contents</title>
152
153 <segmentedlist>
154 <segtitle>Installed Programs</segtitle>
155 <segtitle>Installed Libraries</segtitle>
156 <segtitle>Installed Directories</segtitle>
157
158 <seglistitem>
159 <seg>arp, dnsdomainname, domainname, hostname,
160 ifconfig, ipmaddr, iptunnel, mii-tool, nameif, netstat,
161 nisdomainname, plipconfig, rarp, route, slattach, and
162 ypdomainname</seg>
163 <seg>None</seg>
164 <seg>None</seg>
165 </seglistitem>
166 </segmentedlist>
167
168 <variablelist>
169 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
170 <?dbfo list-presentation="list"?>
171 <?dbhtml list-presentation="table"?>
172
173 <varlistentry id="arp">
174 <term><command>arp</command></term>
175 <listitem>
176 <para>is used to manipulate the kernel's ARP cache, usually
177 to add or delete an entry, or to dump the entire cache.</para>
178 <indexterm zone="net-tools arp">
179 <primary sortas="b-arp">arp</primary>
180 </indexterm>
181 </listitem>
182 </varlistentry>
183
184 <varlistentry id="dnsdomainname">
185 <term><command>dnsdomainname</command></term>
186 <listitem>
187 <para>reports the system's DNS domain name.</para>
188 <indexterm zone="net-tools dnsdomainname">
189 <primary sortas="b-dnsdomainname">dnsdomainname</primary>
190 </indexterm>
191 </listitem>
192 </varlistentry>
193
194 <varlistentry id="domainname">
195 <term><command>domainname</command></term>
196 <listitem>
197 <para>reports or sets the system's NIS/YP domain name.</para>
198 <indexterm zone="net-tools domainname">
199 <primary sortas="b-domainname">domainname</primary>
200 </indexterm>
201 </listitem>
202 </varlistentry>
203
204 <varlistentry id="hostname">
205 <term><command>hostname</command></term>
206 <listitem>
207 <para>reports or sets the name of the current host system.</para>
208 <indexterm zone="net-tools hostname">
209 <primary sortas="b-hostname">hostname</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 <varlistentry id="ifconfig">
215 <term><command>ifconfig</command></term>
216 <listitem>
217 <para>is the main utility for configuring network interfaces.</para>
218 <indexterm zone="net-tools ifconfig">
219 <primary sortas="b-ifconfig">ifconfig</primary>
220 </indexterm>
221 </listitem>
222 </varlistentry>
223
224 <varlistentry id="ipmaddr">
225 <term><command>ipmaddr</command></term>
226 <listitem>
227 <para>adds, deletes and shows an interface's multicast addresses.</para>
228 <indexterm zone="net-tools ipmaddr">
229 <primary sortas="b-ipmaddr">ipmaddr</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="iptunnel">
235 <term><command>iptunnel</command></term>
236 <listitem>
237 <para>adds, changes, deletes and shows an interface's tunnels.</para>
238 <indexterm zone="net-tools iptunnel">
239 <primary sortas="b-iptunnel">iptunnel</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 <varlistentry id="mii-tool">
245 <term><command>mii-tool</command></term>
246 <listitem>
247 <para>checks or sets the status of a network interface's Media Independent
248 Interface (MII) unit.</para>
249 <indexterm zone="net-tools mii-tool">
250 <primary sortas="b-mii-tool">mii-tool</primary>
251 </indexterm>
252 </listitem>
253 </varlistentry>
254
255 <varlistentry id="nameif">
256 <term><command>nameif</command></term>
257 <listitem>
258 <para>names network interfaces based on MAC addresses.</para>
259 <indexterm zone="net-tools nameif">
260 <primary sortas="b-nameif">nameif</primary>
261 </indexterm>
262 </listitem>
263 </varlistentry>
264
265 <varlistentry id="netstat">
266 <term><command>netstat</command></term>
267 <listitem>
268 <para>is used to report network connections, routing tables, and interface
269 statistics.</para>
270 <indexterm zone="net-tools netstat">
271 <primary sortas="b-netstat">netstat</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 <varlistentry id="nisdomainname">
277 <term><command>nisdomainname</command></term>
278 <listitem>
279 <para>does the same as <command>domainname</command>.</para>
280 <indexterm zone="net-tools nisdomainname">
281 <primary sortas="b-nisdomainname">nisdomainname</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="plipconfig">
287 <term><command>plipconfig</command></term>
288 <listitem>
289 <para>is used to fine tune the PLIP device parameters, to
290 improve its performance.</para>
291 <indexterm zone="net-tools plipconfig">
292 <primary sortas="b-plipconfig">plipconfig</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296
297 <varlistentry id="rarp">
298 <term><command>rarp</command></term>
299 <listitem>
300 <para>is used to manipulate the kernel's RARP table.</para>
301 <indexterm zone="net-tools rarp">
302 <primary sortas="b-rarp">rarp</primary>
303 </indexterm>
304 </listitem>
305 </varlistentry>
306
307 <varlistentry id="route">
308 <term><command>route</command></term>
309 <listitem>
310 <para>is used to manipulate the IP routing table.</para>
311 <indexterm zone="net-tools route">
312 <primary sortas="b-route">route</primary>
313 </indexterm>
314 </listitem>
315 </varlistentry>
316
317 <varlistentry id="slattach">
318 <term><command>slattach</command></term>
319 <listitem>
320 <para>attaches a network interface to a serial line. This allows you to use
321 normal terminal lines for point-to-point links to other computers.</para>
322 <indexterm zone="net-tools slattach">
323 <primary sortas="b-slattach">slattach</primary>
324 </indexterm>
325 </listitem>
326 </varlistentry>
327
328 <varlistentry id="ypdomainname">
329 <term><command>ypdomainname</command></term>
330 <listitem>
331 <para>does the same as <command>domainname</command>.</para>
332 <indexterm zone="net-tools ypdomainname">
333 <primary sortas="b-ypdomainname">ypdomainname</primary>
334 </indexterm>
335 </listitem>
336 </varlistentry>
337
338 </variablelist>
339
340 </sect2>
341
342</sect1>
Note: See TracBrowser for help on using the repository browser.