source: networking/netprogs/net-tools.xml@ 2c96c50

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 2c96c50 was 2c96c50, checked in by Bruce Dubbs <bdubbs@…>, 16 months ago

Remove reference to ifconfig in net-tools

  • Property mode set to 100644
File size: 10.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 "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 <!-- When building with MAKEFLAGS set to a -j value higher than 1, a race
124 condition will occur. -renodr -->
125
126 <para>
127 Install <application>Net-tools</application> by running the
128 following commands:
129 </para>
130
131<screen><userinput>export BINDIR='/usr/bin' SBINDIR='/usr/bin' &amp;&amp;
132yes "" | make -j1 &amp;&amp;
133make DESTDIR=$PWD/install -j1 install &amp;&amp;
134rm install/usr/bin/{nis,yp}domainname &amp;&amp;
135rm install/usr/bin/{hostname,dnsdomainname,domainname,ifconfig} &amp;&amp;
136rm -r install/usr/share/man/man1 &amp;&amp;
137rm install/usr/share/man/man8/ifconfig.8 &amp;&amp;
138unset BINDIR SBINDIR</userinput></screen>
139
140 <para>
141 This package does not come with a test suite.
142 </para>
143
144 <para>
145 Now, as the <systemitem class="username">root</systemitem> user:
146 </para>
147
148<screen role='root'><userinput>chown -R root:root install &amp;&amp;
149cp -a install/* /</userinput></screen>
150
151 </sect2>
152
153 <sect2 role="commands">
154 <title>Command Explanations</title>
155
156 <para>
157 <command>export BINDIR='/usr/bin' SBINDIR='/usr/bin'</command>:
158 Ensure the executables are installed in the correct location.
159 </para>
160
161 <para>
162 <command>yes "" | make </command>: Piping <command>yes</command>
163 to <command>make config</command> skips the interactive configuration and
164 accepts the defaults.
165 </para>
166
167 <para>
168 <command>rm ...</command>: Remove unneeded programs and man pages.
169 </para>
170
171 </sect2>
172
173 <sect2 role="content">
174 <title>Contents</title>
175
176 <segmentedlist>
177 <segtitle>Installed Programs</segtitle>
178 <segtitle>Installed Libraries</segtitle>
179 <segtitle>Installed Directories</segtitle>
180
181 <seglistitem>
182 <seg>arp,
183 ipconfig
184 ipmaddr,
185 iptunnel,
186 mii-tool,
187 nameif,
188 netstat,
189 plipconfig,
190 rarp,
191 route, and
192 slattach
193 </seg>
194 <seg>None</seg>
195 <seg>None</seg>
196 </seglistitem>
197 </segmentedlist>
198
199 <variablelist>
200 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
201 <?dbfo list-presentation="list"?>
202 <?dbhtml list-presentation="table"?>
203
204 <varlistentry id="arp">
205 <term><command>arp</command></term>
206 <listitem>
207 <para>
208 is used to manipulate the kernel's ARP cache, usually
209 to add or delete an entry, or to dump the entire cache
210 </para>
211 <indexterm zone="net-tools arp">
212 <primary sortas="b-arp">arp</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216
217 <varlistentry id="ipmaddr">
218 <term><command>ipmaddr</command></term>
219 <listitem>
220 <para>
221 adds, deletes and shows an interface's multicast addresses
222 </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>
233 adds, changes, deletes and shows an interface's tunnels
234 </para>
235 <indexterm zone="net-tools iptunnel">
236 <primary sortas="b-iptunnel">iptunnel</primary>
237 </indexterm>
238 </listitem>
239 </varlistentry>
240
241 <varlistentry id="mii-tool">
242 <term><command>mii-tool</command></term>
243 <listitem>
244 <para>
245 checks or sets the status of a network interface's Media
246 Independent Interface (MII) unit
247 </para>
248 <indexterm zone="net-tools mii-tool">
249 <primary sortas="b-mii-tool">mii-tool</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="nameif">
255 <term><command>nameif</command></term>
256 <listitem>
257 <para>
258 names network interfaces based on MAC addresses
259 </para>
260 <indexterm zone="net-tools nameif">
261 <primary sortas="b-nameif">nameif</primary>
262 </indexterm>
263 </listitem>
264 </varlistentry>
265
266 <varlistentry id="netstat">
267 <term><command>netstat</command></term>
268 <listitem>
269 <para>
270 is used to report network connections, routing tables, and
271 interface statistics
272 </para>
273 <indexterm zone="net-tools netstat">
274 <primary sortas="b-netstat">netstat</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="plipconfig">
280 <term><command>plipconfig</command></term>
281 <listitem>
282 <para>
283 is used to fine tune the PLIP device parameters, to
284 improve its performance
285 </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>
296 is used to manipulate the kernel's RARP table
297 </para>
298 <indexterm zone="net-tools rarp">
299 <primary sortas="b-rarp">rarp</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="route">
305 <term><command>route</command></term>
306 <listitem>
307 <para>
308 is used to manipulate the IP routing table
309 </para>
310 <indexterm zone="net-tools route">
311 <primary sortas="b-route">route</primary>
312 </indexterm>
313 </listitem>
314 </varlistentry>
315
316 <varlistentry id="slattach">
317 <term><command>slattach</command></term>
318 <listitem>
319 <para>
320 attaches a network interface to a serial line. This allows you to
321 use normal terminal lines for point-to-point links to others
322 computers
323 </para>
324 <indexterm zone="net-tools slattach">
325 <primary sortas="b-slattach">slattach</primary>
326 </indexterm>
327 </listitem>
328 </varlistentry>
329 </variablelist>
330
331 </sect2>
332
333</sect1>
Note: See TracBrowser for help on using the repository browser.