aboutsummaryrefslogtreecommitdiffstats
path: root/chapter06/net-tools.xml
blob: d45fd004b101c091724fcc931d53d93efae52e6b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>
<sect1 id="ch-system-net-tools" xreflabel="Net-tools" role="wrap">
<title>Net-tools-&net-tools-version;</title>
<?dbhtml filename="net-tools.html"?>

<indexterm zone="ch-system-net-tools"><primary sortas="a-Net-tools">Net-tools</primary></indexterm>

<sect2 role="package"><title/>
<para>The Net-tools package contains programs for basic networking.</para>

<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>9.4 MB</seg></seglistitem>
</segmentedlist>

<segmentedlist>
<segtitle>Net-tools installation depends on</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, GCC,
Glibc, Make</seg></seglistitem>
</segmentedlist>
</sect2>

<sect2 role="installation">
<title>Installation of Net-tools</title>

<para>If you don't know what to answer to all the questions asked during the
<command>make config</command> phase below, then just accept the defaults.
This will be just fine in the majority of cases. What you're asked here is a
bunch of questions about which network protocols you've enabled in your
kernel. The default answers will enable the tools from this package to work
with the most common protocols: TCP, PPP, and several others. You still need
to actually enable these protocols in the kernel -- what you do here is merely
telling the package to include support for those protocols in its programs,
but it's up to the kernel to make the protocols available.</para>

<para>This package also has issues with being compiled by GCC 3.4, which we
fix by applying the following patch:</para>

<screen><userinput>patch -Np1 -i ../net-tools-&net-tools-version;-gcc34-2.patch</userinput></screen>

<para>Net-tools has issues with the Linux 2.6 kernel series - fix these issues
by applying the following patch:</para>

<screen><userinput>patch -Np1 -i ../net-tools-&net-tools-version;-kernel-headers-1.patch</userinput></screen>

<para>Now prepare Net-tools for compilation (if you intend to accept the
defaults, you can skip all the questions by running <userinput>yes "" |
make config</userinput> instead):</para>

<screen><userinput>make config</userinput></screen>

<para>Compile the package:</para>

<screen><userinput>make</userinput></screen>

<para>Now install it:</para>

<screen><userinput>make update</userinput></screen>

</sect2>


<sect2 id="contents-net" role="content"><title>Contents of Net-tools</title>

<segmentedlist>
<segtitle>Installed programs</segtitle>
<seglistitem><seg>arp, dnsdomainname (link to hostname), domainname (link to 
hostname), hostname, ifconfig, nameif, netstat, nisdomainname (link to hostname), 
plipconfig, rarp, route, slattach and ypdomainname (link to hostname)</seg></seglistitem>
</segmentedlist>

<variablelist><title>Short descriptions</title>

<varlistentry>
<term id="arp"><command>arp</command></term>
<listitem>
<indexterm zone="ch-system-net-tools arp"><primary sortas="b-arp">arp</primary></indexterm>
<para>is used to manipulate the kernel's ARP cache,
usually to add or delete an entry, or to dump the entire cache.</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="dnsdomainname"><command>dnsdomainname</command></term>
<listitem>
<indexterm zone="ch-system-net-tools dnsdomainname"><primary sortas="b-dnsdomainname">dnsdomainname</primary></indexterm>
<para>reports the system's DNS (Domain Name Server) domain name.</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="domainname"><command>domainname</command></term>
<listitem>
<indexterm zone="ch-system-net-tools domainname"><primary sortas="b-domainname">domainname</primary></indexterm>
<para>reports or sets the system's NIS/YP domain name.</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="hostname"><command>hostname</command></term>
<listitem>
<indexterm zone="ch-system-net-tools hostname"><primary sortas="b-hostname">hostname</primary></indexterm>
<para>reports or sets the name of the current host system.</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="ifconfig"><command>ifconfig</command></term>
<listitem>
<indexterm zone="ch-system-net-tools ifconfig"><primary sortas="b-ifconfig">ifconfig</primary></indexterm>
<para>is the main utility for configuring network interfaces.</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="nameif"><command>nameif</command></term>
<listitem>
<indexterm zone="ch-system-net-tools nameif"><primary sortas="b-nameif">nameif</primary></indexterm>
<para>names network interfaces based on MAC addresses.</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="netstat"><command>netstat</command></term>
<listitem>
<indexterm zone="ch-system-net-tools netstat"><primary sortas="b-netstat">netstat</primary></indexterm>
<para>is used to report network connections, routing tables, and interface 
statistics..</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="nisdomainname"><command>nisdomainname</command></term>
<listitem>
<indexterm zone="ch-system-net-tools nisdomainname"><primary sortas="b-nisdomainname">nisdomainname</primary></indexterm>
<para>does the same as domainname.</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="plipconfig"><command>plipconfig</command></term>
<listitem>
<indexterm zone="ch-system-net-tools plipconfig"><primary sortas="b-plipconfig">plipconfig</primary></indexterm>
<para>is used to fine tune the PLIP device parameters, to improve its performance.</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="rarp"><command>rarp</command></term>
<listitem>
<indexterm zone="ch-system-net-tools rarp"><primary sortas="b-rarp">rarp</primary></indexterm>
<para>is used to manipulate the kernel's RARP table.</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="route"><command>route</command></term>
<listitem>
<indexterm zone="ch-system-net-tools route"><primary sortas="b-route">route</primary></indexterm>
<para>is used to manipulate the IP routing table.</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="slattach"><command>slattach</command></term>
<listitem>
<indexterm zone="ch-system-net-tools slattach"><primary sortas="b-slattach">slattach</primary></indexterm>
<para>attaches a network interface to a serial line. This allows you to use normal 
terminal lines for point-to-point links to other computers.</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="ypdomainname"><command>ypdomainname</command></term>
<listitem>
<indexterm zone="ch-system-net-tools ypdomainname"><primary sortas="b-ypdomainname">ypdomainname</primary></indexterm>
<para>does the same as domainname.</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>