source: basicnet/netprogs/net-tools.xml@ 46441976

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.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 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 46441976 was 46441976, checked in by David Jensen <djensen@…>, 19 years ago

separated user/root in Fetchmail, Mutt, Slrn, Net-tools, NTP and Enscript.

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