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

10.0 10.1 11.0 11.1 8.4 9.0 9.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since b27a739 was b27a739, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21158 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 11.8 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 "&sources-anduin-http;/net-tools/net-tools-&net-tools-version;.tar.gz">
8 <!ENTITY net-tools-download-ftp "&sources-anduin-ftp;/net-tools/net-tools-&net-tools-version;.tar.gz">
9 <!ENTITY net-tools-md5sum "6be14ed473cacdd68edeaa9605adc469">
10 <!ENTITY net-tools-size "222 KB">
11 <!ENTITY net-tools-buildsize "7.0 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 <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 &lfs84_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>
64 Required patch:
65 <ulink url="&patch-root;/net-tools-&net-tools-version;-remove_dups-1.patch"/>
66 </para>
67 </listitem>
68 </itemizedlist>
69
70
71 <para condition="html" role="usernotes">User Notes:
72 <ulink url="&blfs-wiki;/net-tools"/></para>
73
74 </sect2>
75
76 <sect2 role="installation">
77 <title>Installation of Net-tools</title>
78
79 <para id="net-tools-automate-example" xreflabel="Net-tools">The
80 instructions below automate the configuration process by piping
81 <command>yes</command> to the <command>make config</command> command. If
82 you wish to run the interactive configuration process (by changing the
83 instruction to just <command>make config</command>), but you are not sure
84 how to answer all the questions, then just accept the defaults. This will
85 be just fine in the majority of cases. What you're asked here is a bunch of
86 questions about which network protocols you've enabled in your kernel. The
87 default answers will enable the tools from this package to work with the
88 most common protocols: TCP, PPP, and several others. You still need to
89 actually enable these protocols in the kernel&mdash;what you do here is
90 merely tell the package to include support for those protocols in its
91 programs, but it's up to the kernel to make the protocols available.</para>
92
93 <note><para>This package has several unneeded protocols and hardware device
94 specific functions that are obsolete. To only build the minimum needed for
95 your system, skip the <command>yes</command> command and answer each
96 question interactively. The minimum needed options are 'UNIX protocol
97 family' and 'INET (TCP/IP) protocol family'.</para></note>
98
99 <para>The patch below cleans up the installation so that it does not
100 overwrite the <application>ifconfig</application> and
101 <application>hostname</application> programs that were installed in LFS.</para>
102
103 <para>Install <application>Net-tools</application> by running the
104 following commands:</para>
105
106<screen><userinput>patch -Np1 -i ../net-tools-&net-tools-version;-remove_dups-1.patch &amp;&amp;
107sed -i '/#include &lt;netinet\/ip.h&gt;/d' iptunnel.c &amp;&amp;
108
109yes "" | make config &amp;&amp;
110make</userinput></screen>
111
112 <para>This package does not come with a test suite.</para>
113
114 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
115
116<screen role='root'><userinput>make update</userinput></screen>
117
118 </sect2>
119
120 <sect2 role="commands">
121 <title>Command Explanations</title>
122
123 <para><command>sed -i '/#include &lt;netinet\/ip.h&gt;/d' iptunnel.c</command>:
124 This fixes build breakage with linux-4.8 headers.</para>
125<!--
126 <para><command>sed -i -e '/Token/s/y$/n/' config.in</command>: Change the
127 default for building obsolete token ring support to no. This is a
128 simpler change than changing the location for the token ring headers.
129 </para>
130
131 <para><command>sed -i -e '/HAVE_HWSTRIP/s/y$/n/' config.in</command>:
132 Removes obsolete Metricom radio support that requires a header no longer
133 included in the kernel. </para>
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 </sect2>
140
141 <sect2 role="content">
142 <title>Contents</title>
143
144 <segmentedlist>
145 <segtitle>Installed Programs</segtitle>
146 <segtitle>Installed Libraries</segtitle>
147 <segtitle>Installed Directories</segtitle>
148
149 <seglistitem>
150 <seg>arp,
151 ipmaddr, iptunnel, mii-tool, nameif, netstat,
152 plipconfig, rarp, route, and slattach
153 </seg>
154 <seg>None</seg>
155 <seg>None</seg>
156 </seglistitem>
157 </segmentedlist>
158
159 <variablelist>
160 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
161 <?dbfo list-presentation="list"?>
162 <?dbhtml list-presentation="table"?>
163
164 <varlistentry id="arp">
165 <term><command>arp</command></term>
166 <listitem>
167 <para>is used to manipulate the kernel's ARP cache, usually
168 to add or delete an entry, or to dump the entire cache.</para>
169 <indexterm zone="net-tools arp">
170 <primary sortas="b-arp">arp</primary>
171 </indexterm>
172 </listitem>
173 </varlistentry>
174<!--
175 <varlistentry id="dnsdomainname">
176 <term><command>dnsdomainname</command></term>
177 <listitem>
178 <para>reports the system's DNS domain name.</para>
179 <indexterm zone="net-tools dnsdomainname">
180 <primary sortas="b-dnsdomainname">dnsdomainname</primary>
181 </indexterm>
182 </listitem>
183 </varlistentry>
184
185 <varlistentry id="domainname">
186 <term><command>domainname</command></term>
187 <listitem>
188 <para>reports or sets the system's NIS/YP domain name.</para>
189 <indexterm zone="net-tools domainname">
190 <primary sortas="b-domainname">domainname</primary>
191 </indexterm>
192 </listitem>
193 </varlistentry>
194
195 <varlistentry id="hostname">
196 <term><command>hostname</command></term>
197 <listitem>
198 <para>reports or sets the name of the current host system.</para>
199 <indexterm zone="net-tools hostname">
200 <primary sortas="b-hostname">hostname</primary>
201 </indexterm>
202 </listitem>
203 </varlistentry>
204
205 <varlistentry id="ifconfig">
206 <term><command>ifconfig</command></term>
207 <listitem>
208 <para>is the main utility for configuring network interfaces.</para>
209 <indexterm zone="net-tools ifconfig">
210 <primary sortas="b-ifconfig">ifconfig</primary>
211 </indexterm>
212 </listitem>
213 </varlistentry>
214-->
215 <varlistentry id="ipmaddr">
216 <term><command>ipmaddr</command></term>
217 <listitem>
218 <para>adds, deletes and shows an interface's multicast addresses.</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>adds, changes, deletes and shows an interface's tunnels.</para>
229 <indexterm zone="net-tools iptunnel">
230 <primary sortas="b-iptunnel">iptunnel</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="mii-tool">
236 <term><command>mii-tool</command></term>
237 <listitem>
238 <para>checks or sets the status of a network interface's Media Independent
239 Interface (MII) unit.</para>
240 <indexterm zone="net-tools mii-tool">
241 <primary sortas="b-mii-tool">mii-tool</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="nameif">
247 <term><command>nameif</command></term>
248 <listitem>
249 <para>names network interfaces based on MAC addresses.</para>
250 <indexterm zone="net-tools nameif">
251 <primary sortas="b-nameif">nameif</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 <varlistentry id="netstat">
257 <term><command>netstat</command></term>
258 <listitem>
259 <para>is used to report network connections, routing tables, and interface
260 statistics.</para>
261 <indexterm zone="net-tools netstat">
262 <primary sortas="b-netstat">netstat</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266<!--
267 <varlistentry id="nisdomainname">
268 <term><command>nisdomainname</command></term>
269 <listitem>
270 <para>does the same as <command>domainname</command>.</para>
271 <indexterm zone="net-tools nisdomainname">
272 <primary sortas="b-nisdomainname">nisdomainname</primary>
273 </indexterm>
274 </listitem>
275 </varlistentry>
276-->
277 <varlistentry id="plipconfig">
278 <term><command>plipconfig</command></term>
279 <listitem>
280 <para>is used to fine tune the PLIP device parameters, to
281 improve its performance.</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>is used to manipulate the kernel's RARP table.</para>
292 <indexterm zone="net-tools rarp">
293 <primary sortas="b-rarp">rarp</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry id="route">
299 <term><command>route</command></term>
300 <listitem>
301 <para>is used to manipulate the IP routing table.</para>
302 <indexterm zone="net-tools route">
303 <primary sortas="b-route">route</primary>
304 </indexterm>
305 </listitem>
306 </varlistentry>
307
308 <varlistentry id="slattach">
309 <term><command>slattach</command></term>
310 <listitem>
311 <para>attaches a network interface to a serial line. This allows you to use
312 normal terminal lines for point-to-point links to other computers.</para>
313 <indexterm zone="net-tools slattach">
314 <primary sortas="b-slattach">slattach</primary>
315 </indexterm>
316 </listitem>
317 </varlistentry>
318<!--
319 <varlistentry id="ypdomainname">
320 <term><command>ypdomainname</command></term>
321 <listitem>
322 <para>does the same as <command>domainname</command>.</para>
323 <indexterm zone="net-tools ypdomainname">
324 <primary sortas="b-ypdomainname">ypdomainname</primary>
325 </indexterm>
326 </listitem>
327 </varlistentry>
328-->
329 </variablelist>
330
331 </sect2>
332
333</sect1>
Note: See TracBrowser for help on using the repository browser.