source: networking/netprogs/net-tools.xml@ 6ca13da3

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 6ca13da3 was 09a464a, checked in by Douglas R. Reno <renodr@…>, 15 months ago

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