source: basicnet/netprogs/net-tools.xml@ 061ec9d

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 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 061ec9d was 061ec9d, checked in by Randy McMurchy <randy@…>, 18 years ago

Added the 'User Notes' wiki link to each package page; changed all instances of .[so,a] to .{so,a} (brackets changed to braces); changed all replaceable tags to use angle brackets instead of square brackets to encapsulate the text - commit #1

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