source: networking/netprogs/net-tools.xml@ 9e9cd2a2

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 9e9cd2a2 was 9e9cd2a2, checked in by Bruce Dubbs <bdubbs@…>, 12 years ago

Update book title and copyright date.

Remove portmap and nfs-utils at least until upstream gets their act together.
Stable NIS and NFS headers and functions not currently available from any
source.

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