source: networking/netprogs/net-tools.xml@ 4f68434f

11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 4f68434f was 4f68434f, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tags and a couple of tweaks.
  • 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 <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 &lfs110_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 ipmaddr,
184 iptunnel,
185 mii-tool,
186 nameif,
187 netstat,
188 plipconfig,
189 rarp,
190 route, and
191 slattach
192 </seg>
193 <seg>None</seg>
194 <seg>None</seg>
195 </seglistitem>
196 </segmentedlist>
197
198 <variablelist>
199 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
200 <?dbfo list-presentation="list"?>
201 <?dbhtml list-presentation="table"?>
202
203 <varlistentry id="arp">
204 <term><command>arp</command></term>
205 <listitem>
206 <para>
207 is used to manipulate the kernel's ARP cache, usually
208 to add or delete an entry, or to dump the entire cache
209 </para>
210 <indexterm zone="net-tools arp">
211 <primary sortas="b-arp">arp</primary>
212 </indexterm>
213 </listitem>
214 </varlistentry>
215
216 <varlistentry id="ipmaddr">
217 <term><command>ipmaddr</command></term>
218 <listitem>
219 <para>
220 adds, deletes and shows an interface's multicast addresses
221 </para>
222 <indexterm zone="net-tools ipmaddr">
223 <primary sortas="b-ipmaddr">ipmaddr</primary>
224 </indexterm>
225 </listitem>
226 </varlistentry>
227
228 <varlistentry id="iptunnel">
229 <term><command>iptunnel</command></term>
230 <listitem>
231 <para>
232 adds, changes, deletes and shows an interface's tunnels
233 </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>
244 checks or sets the status of a network interface's Media
245 Independent Interface (MII) unit
246 </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>
257 names network interfaces based on MAC addresses
258 </para>
259 <indexterm zone="net-tools nameif">
260 <primary sortas="b-nameif">nameif</primary>
261 </indexterm>
262 </listitem>
263 </varlistentry>
264
265 <varlistentry id="netstat">
266 <term><command>netstat</command></term>
267 <listitem>
268 <para>
269 is used to report network connections, routing tables, and
270 interface statistics
271 </para>
272 <indexterm zone="net-tools netstat">
273 <primary sortas="b-netstat">netstat</primary>
274 </indexterm>
275 </listitem>
276 </varlistentry>
277
278 <varlistentry id="plipconfig">
279 <term><command>plipconfig</command></term>
280 <listitem>
281 <para>
282 is used to fine tune the PLIP device parameters, to
283 improve its performance
284 </para>
285 <indexterm zone="net-tools plipconfig">
286 <primary sortas="b-plipconfig">plipconfig</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="rarp">
292 <term><command>rarp</command></term>
293 <listitem>
294 <para>
295 is used to manipulate the kernel's RARP table
296 </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>
307 is used to manipulate the IP routing table
308 </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>
319 attaches a network interface to a serial line. This allows you to
320 use normal terminal lines for point-to-point links to others
321 computers
322 </para>
323 <indexterm zone="net-tools slattach">
324 <primary sortas="b-slattach">slattach</primary>
325 </indexterm>
326 </listitem>
327 </varlistentry>
328 </variablelist>
329
330 </sect2>
331
332</sect1>
Note: See TracBrowser for help on using the repository browser.