source: networking/netprogs/net-tools.xml@ a3b94fc

11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since a3b94fc was a3b94fc, checked in by Bruce Dubbs <bdubbs@…>, 16 months ago

Update to net-tools-2.10.

  • Property mode set to 100644
File size: 10.4 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 "https://downloads.sourceforge.net/project/net-tools//net-tools-&net-tools-version;.tar.xz">
8 <!ENTITY net-tools-download-ftp " ">
9 <!ENTITY net-tools-md5sum "78aae762c95e2d731faf88d482e4cde5">
10 <!ENTITY net-tools-size "228 KB">
11 <!ENTITY net-tools-buildsize "7.5 MB">
12 <!ENTITY net-tools-time "less than 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 <date>$Date$</date>
20 </sect1info>
21
22 <title>Net-tools-&net-tools-version;</title>
23
24 <indexterm zone="net-tools">
25 <primary sortas="a-Net-tools">Net-tools</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to Net-tools</title>
30
31 <para>
32 The <application>Net-tools</application> package is a collection
33 of programs for controlling the network subsystem of the Linux kernel.
34 </para>
35
36 &lfs101_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>
42 Download (HTTP): <ulink url="&net-tools-download-http;"/>
43 </para>
44 </listitem>
45 <listitem>
46 <para>
47 Download (FTP): <ulink url="&net-tools-download-ftp;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download MD5 sum: &net-tools-md5sum;
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &net-tools-size;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Estimated disk space required: &net-tools-buildsize;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated build time: &net-tools-time;
68 </para>
69 </listitem>
70 </itemizedlist>
71<!--
72 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
73 <itemizedlist spacing="compact">
74 <listitem>
75 <para>
76 Required patch:
77 <ulink url="&patch-root;/net-tools-&net-tools-version;-remove_dups-1.patch"/>
78 </para>
79 </listitem>
80 </itemizedlist>
81-->
82
83 <para condition="html" role="usernotes">User Notes:
84 <ulink url="&blfs-wiki;/net-tools"/></para>
85
86 </sect2>
87
88 <sect2 role="installation">
89 <title>Installation of Net-tools</title>
90
91 <para id="net-tools-automate-example" xreflabel="Net-tools">
92 The instructions below automate the configuration process by piping
93 <command>yes</command> to the <command>make</command> command.
94 If you wish to run the interactive configuration process (by changing
95 the instruction to just <command>make</command>), but you are
96 not sure how to answer all the questions, then just accept the defaults.
97 This will be just fine in the majority of cases. What you're asked here
98 is a bunch of questions about which network protocols you've enabled
99 in your kernel. The default answers will enable the tools from this
100 package to work with the most common protocols: TCP, PPP, and several
101 others. You still need to actually enable these protocols in the
102 kernel&mdash;what you do here is merely tell the package to include
103 support for those protocols in its programs, but it's up to the kernel
104 to make the protocols available.
105 </para>
106
107 <note>
108 <para>
109 This package has several unneeded protocols and hardware device
110 specific functions that are obsolete. To only build the minimum needed
111 for your system, skip the <command>yes</command> command and answer
112 each question interactively. The minimum needed options are 'UNIX
113 protocol family' and 'INET (TCP/IP) protocol family'.
114 </para>
115 </note>
116
117 <para>
118 For this package, we use the DESTDIR method of installation in order
119 to easily remove files from the build that overwrite those that we want
120 to keep or are not appropriate for our system.
121 </para>
122
123 <para>
124 Install <application>Net-tools</application> by running the
125 following commands:
126 </para>
127
128<screen><userinput>export BINDIR='/usr/bin' SBINDIR='/usr/bin' &amp;&amp;
129yes "" | make &amp;&amp;
130make DESTDIR=$PWD/install install &amp;&amp;
131rm install/usr/bin/{nis,yp}domainname &amp;&amp;
132rm install/usr/bin/{hostname,dnsdomainname,domainname} &amp;&amp;
133rm -r install/usr/share/man/man1 &amp;&amp;
134unset BINDIR SBINDIR</userinput></screen>
135
136 <para>
137 This package does not come with a test suite.
138 </para>
139
140 <para>
141 Now, as the <systemitem class="username">root</systemitem> user:
142 </para>
143
144<screen role='root'><userinput>chown -R root:root install &amp;&amp;
145cp -a install/* /</userinput></screen>
146
147 </sect2>
148
149 <sect2 role="commands">
150 <title>Command Explanations</title>
151
152 <para>
153 <command>export BINDIR='/usr/bin' SBINDIR='/usr/bin'</command>:
154 Ensure the executables are installed in the correct location.
155 </para>
156
157 <para>
158 <command>yes "" | make </command>: Piping <command>yes</command>
159 to <command>make config</command> skips the interactive configuration and
160 accepts the defaults.
161 </para>
162
163 <para>
164 <command>rm ...</command>: Remove unneeded programs and man pages.
165 </para>
166
167 </sect2>
168
169 <sect2 role="content">
170 <title>Contents</title>
171
172 <segmentedlist>
173 <segtitle>Installed Programs</segtitle>
174 <segtitle>Installed Libraries</segtitle>
175 <segtitle>Installed Directories</segtitle>
176
177 <seglistitem>
178 <seg>arp,
179 ipconfig
180 ipmaddr,
181 iptunnel,
182 mii-tool,
183 nameif,
184 netstat,
185 plipconfig,
186 rarp,
187 route, and
188 slattach
189 </seg>
190 <seg>None</seg>
191 <seg>None</seg>
192 </seglistitem>
193 </segmentedlist>
194
195 <variablelist>
196 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
197 <?dbfo list-presentation="list"?>
198 <?dbhtml list-presentation="table"?>
199
200 <varlistentry id="arp">
201 <term><command>arp</command></term>
202 <listitem>
203 <para>
204 is used to manipulate the kernel's ARP cache, usually
205 to add or delete an entry, or to dump the entire cache
206 </para>
207 <indexterm zone="net-tools arp">
208 <primary sortas="b-arp">arp</primary>
209 </indexterm>
210 </listitem>
211 </varlistentry>
212
213 <varlistentry id="ifconfig">
214 <term><command>ifconfig</command></term>
215 <listitem>
216 <para>
217 is a tool for configuring network interfaces.
218 </para>
219 <indexterm zone="net-tools ifconfig">
220 <primary sortas="b-ifconfig">ifconfig</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="ipmaddr">
226 <term><command>ipmaddr</command></term>
227 <listitem>
228 <para>
229 adds, deletes and shows an interface's multicast addresses
230 </para>
231 <indexterm zone="net-tools ipmaddr">
232 <primary sortas="b-ipmaddr">ipmaddr</primary>
233 </indexterm>
234 </listitem>
235 </varlistentry>
236
237 <varlistentry id="iptunnel">
238 <term><command>iptunnel</command></term>
239 <listitem>
240 <para>
241 adds, changes, deletes and shows an interface's tunnels
242 </para>
243 <indexterm zone="net-tools iptunnel">
244 <primary sortas="b-iptunnel">iptunnel</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="mii-tool">
250 <term><command>mii-tool</command></term>
251 <listitem>
252 <para>
253 checks or sets the status of a network interface's Media
254 Independent Interface (MII) unit
255 </para>
256 <indexterm zone="net-tools mii-tool">
257 <primary sortas="b-mii-tool">mii-tool</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="nameif">
263 <term><command>nameif</command></term>
264 <listitem>
265 <para>
266 names network interfaces based on MAC addresses
267 </para>
268 <indexterm zone="net-tools nameif">
269 <primary sortas="b-nameif">nameif</primary>
270 </indexterm>
271 </listitem>
272 </varlistentry>
273
274 <varlistentry id="netstat">
275 <term><command>netstat</command></term>
276 <listitem>
277 <para>
278 is used to report network connections, routing tables, and
279 interface statistics
280 </para>
281 <indexterm zone="net-tools netstat">
282 <primary sortas="b-netstat">netstat</primary>
283 </indexterm>
284 </listitem>
285 </varlistentry>
286
287 <varlistentry id="plipconfig">
288 <term><command>plipconfig</command></term>
289 <listitem>
290 <para>
291 is used to fine tune the PLIP device parameters, to
292 improve its performance
293 </para>
294 <indexterm zone="net-tools plipconfig">
295 <primary sortas="b-plipconfig">plipconfig</primary>
296 </indexterm>
297 </listitem>
298 </varlistentry>
299
300 <varlistentry id="rarp">
301 <term><command>rarp</command></term>
302 <listitem>
303 <para>
304 is used to manipulate the kernel's RARP table
305 </para>
306 <indexterm zone="net-tools rarp">
307 <primary sortas="b-rarp">rarp</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 <varlistentry id="route">
313 <term><command>route</command></term>
314 <listitem>
315 <para>
316 is used to manipulate the IP routing table
317 </para>
318 <indexterm zone="net-tools route">
319 <primary sortas="b-route">route</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 <varlistentry id="slattach">
325 <term><command>slattach</command></term>
326 <listitem>
327 <para>
328 attaches a network interface to a serial line. This allows you to
329 use normal terminal lines for point-to-point links to others
330 computers
331 </para>
332 <indexterm zone="net-tools slattach">
333 <primary sortas="b-slattach">slattach</primary>
334 </indexterm>
335 </listitem>
336 </varlistentry>
337 </variablelist>
338
339 </sect2>
340
341</sect1>
Note: See TracBrowser for help on using the repository browser.