source: basicnet/netprogs/net-tools.xml@ 9f12e36

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

Removed 'keywordset' blocks and extra spaces from the XML files (note this was by accident as I meant to do just in the gnome directory but I was in the root of BOOK when I ran the script, but this was going to happen anyway so I don't think it is a big deal)

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