- Timestamp:
- 04/30/2005 10:46:26 AM (19 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- c174c5f
- Parents:
- 17929f0
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
basicnet/netprogs/net-tools.xml
r17929f0 ra3dbd17b 16 16 17 17 <sect1 id="net-tools" xreflabel="Net-tools-&net-tools-version;"> 18 <sect1info> 19 <othername>$LastChangedBy$</othername> 20 <date>$Date$</date> 21 </sect1info> 22 <?dbhtml filename="net-tools.html"?> 23 <title>Net-tools-&net-tools-version;</title> 24 25 <sect2> 26 <title>Introduction to <application>Net-tools</application></title> 27 28 <para>The <application>Net-tools</application> package is a collection 29 of programs for controlling the network subsystem of the Linux 30 kernel.</para> 31 32 <sect3><title>Package information</title> 33 <itemizedlist spacing='compact'> 34 <listitem><para>Download (HTTP): 35 <ulink url="&net-tools-download-http;"/></para></listitem> 36 <listitem><para>Download (FTP): 37 <ulink url="&net-tools-download-ftp;"/></para></listitem> 38 <listitem><para>Download MD5 sum (HTTP): 39 &net-tools-md5sum-http;</para></listitem> 40 <listitem><para>Download MD5 sum (FTP): 41 &net-tools-md5sum-ftp;</para></listitem> 42 <listitem><para>Download size: &net-tools-size;</para></listitem> 43 <listitem><para>Estimated disk space required: 44 &net-tools-buildsize;</para></listitem> 45 <listitem><para>Estimated build time: 46 &net-tools-time;</para></listitem></itemizedlist> 47 </sect3> 48 49 <sect3><title>Additional downloads</title> 50 <itemizedlist spacing="compact"> 51 <listitem><para>Required Patch (if compiled using 52 <application>GCC</application>-3.4.x): <ulink 53 url="&patch-root;/net-tools-&net-tools-version;-gcc34-3.patch"/></para> 54 </listitem> 55 <listitem><para>Required Patch: <ulink 56 url="&patch-root;/net-tools-&net-tools-version;-kernel_headers-2.patch"/></para> 57 </listitem> 58 <listitem><para>Required Patch: <ulink 59 url="&patch-root;/net-tools-&net-tools-version;-mii_ioctl-1.patch"/></para> 60 </listitem></itemizedlist> 61 </sect3> 62 63 </sect2> 64 65 <sect2> 66 <title>Installation of <application>Net-tools</application></title> 67 68 <note><para>The <application>Net-tools</application> package installs a 69 <command>hostname</command> program which will overwrite the existing program 70 installed by <application>Coreutils</application> during a base 71 <acronym>LFS</acronym> installation. If, for whatever reason, you need to 72 reinstall the <application>Coreutils</application> package after installing 73 <application>Net-tools</application>, you should use the 74 <filename>coreutils-&lfs-coreutils-version;-suppress_hostname_uptime_kill_su-1.patch</filename> 75 patch if you wish to preserve the <application>Net-tools</application> 76 <command>hostname</command> program.</para></note> 77 78 <para>If you don't know what to answer to all the questions asked during 79 the <command>make config</command> phase below, then just accept the 80 defaults (the build command below automates this). This will be just fine 81 in the majority of cases. What you're 82 asked here is a bunch of questions about which network protocols you've 83 enabled in your kernel. The default answers will enable the tools from 84 this package to work with the most common protocols: 85 <acronym>TCP</acronym>, <acronym>PPP</acronym>, and several others. You 86 still need to actually enable these protocols in the kernel—what you 87 do here is merely telling the package to include support for those 88 protocols in its programs, but it's up to the kernel to make the 89 protocols available.</para> 90 91 <para>Install <application>Net-tools</application> by running the 92 following commands:</para> 93 94 <screen><userinput><command>patch -Np1 -i ../net-tools-&net-tools-version;-gcc34-3.patch && 18 <?dbhtml filename="net-tools.html"?> 19 20 <sect1info> 21 <othername>$LastChangedBy$</othername> 22 <date>$Date$</date> 23 </sect1info> 24 25 <title>Net-tools-&net-tools-version;</title> 26 27 <indexterm zone="net-tools"> 28 <primary sortas="a-Net-tools">Net-tools</primary> 29 </indexterm> 30 31 <sect2 role="package"> 32 <title>Introduction to Net-tools</title> 33 34 <para>The <application>Net-tools</application> package is a collection 35 of programs for controlling the network subsystem of the Linux 36 kernel.</para> 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 (HTTP): &net-tools-md5sum-http;</para> 48 </listitem> 49 <listitem> 50 <para>Download MD5 sum (FTP): &net-tools-md5sum-ftp;</para> 51 </listitem> 52 <listitem> 53 <para>Download size: &net-tools-size;</para> 54 </listitem> 55 <listitem> 56 <para>Estimated disk space required: &net-tools-buildsize;</para> 57 </listitem> 58 <listitem> 59 <para>Estimated build time: &net-tools-time;</para></listitem> 60 </itemizedlist> 61 62 <bridgehead renderas="sect3">Additional Downloads</bridgehead> 63 <itemizedlist spacing="compact"> 64 <listitem> 65 <para>Required Patch (if compiled using 66 <application>GCC</application>-3.4.x): <ulink 67 url="&patch-root;/net-tools-&net-tools-version;-gcc34-3.patch"/></para> 68 </listitem> 69 <listitem> 70 <para>Required Patch: <ulink 71 url="&patch-root;/net-tools-&net-tools-version;-kernel_headers-2.patch"/></para> 72 </listitem> 73 <listitem> 74 <para>Required Patch: <ulink 75 url="&patch-root;/net-tools-&net-tools-version;-mii_ioctl-1.patch"/></para> 76 </listitem> 77 </itemizedlist> 78 79 </sect2> 80 81 <sect2 role="installation"> 82 <title>Installation of Net-tools</title> 83 84 <note> 85 <para>The <application>Net-tools</application> package installs a 86 <command>hostname</command> program which will overwrite the existing program 87 installed by <application>Coreutils</application> during a base 88 LFS installation. If, for whatever reason, you need to 89 reinstall the <application>Coreutils</application> package after installing 90 <application>Net-tools</application>, you should use the 91 <filename>coreutils-&lfs-coreutils-version;-suppress_hostname_uptime_kill_su-1.patch</filename> 92 patch if you wish to preserve the <application>Net-tools</application> 93 <command>hostname</command> program.</para> 94 </note> 95 96 <para>If you don't know what to answer to all the questions asked during 97 the <command>make config</command> phase below, then just accept the 98 defaults (the build command below automates this). This will be just fine 99 in the majority of cases. What you're 100 asked here is a bunch of questions about which network protocols you've 101 enabled in your kernel. The default answers will enable the tools from 102 this package to work with the most common protocols: 103 TCP, PPP, and several others. You 104 still need to actually enable these protocols in the kernel—what you 105 do here is merely telling the package to include support for those 106 protocols in its programs, but it's up to the kernel to make the 107 protocols available.</para> 108 109 <para>Install <application>Net-tools</application> by running the 110 following commands:</para> 111 112 <screen><userinput>patch -Np1 -i ../net-tools-&net-tools-version;-gcc34-3.patch && 95 113 patch -Np1 -i ../net-tools-&net-tools-version;-kernel_headers-2.patch && 96 114 patch -Np1 -i ../net-tools-&net-tools-version;-mii_ioctl-1.patch && … … 101 119 -e 's|# HAVE_MII=0|HAVE_MII=1|g' config.make && 102 120 make && 103 make update</command></userinput></screen> 104 105 </sect2> 106 107 <sect2> 108 <title>Command explanations</title> 109 110 <para><command>yes "" | make config</command>: Piping <command>yes</command> 111 to <command>make config</command> skips the interactive configuration and 112 accepts the defaults.</para> 113 114 <para><command>sed -i -e ...</command>: These two <command>sed</command>s 115 change the configuration files to force building the 116 <command>ipmaddr</command>, <command>iptunnel</command> and 117 <command>mii-tool</command> programs.</para> 118 </sect2> 119 120 <sect2> 121 <title>Contents</title> 122 123 <para>The <application>Net-tools</application> package contains 124 <command>arp</command>, 125 <command>dnsdomainname</command>, 126 <command>domainname</command>, 127 <command>hostname</command>, 128 <command>ifconfig</command>, 129 <command>ipmaddr</command>, 130 <command>iptunnel</command>, 131 <command>mii-tool</command>, 132 <command>nameif</command>, 133 <command>netstat</command>, 134 <command>nisdomainname</command>, 135 <command>plipconfig</command>, 136 <command>rarp</command>, 137 <command>route</command>, 138 <command>slattach</command> and 139 <command>ypdomainname</command>.</para> 140 141 </sect2> 142 143 <sect2><title>Description</title> 144 145 <sect3><title>arp</title> 146 <para><command>arp</command> 147 is used to manipulate the kernel's <acronym>ARP</acronym> cache, usually 148 to add or delete an entry, or to dump the entire cache. 149 </para></sect3> 150 151 <sect3><title>dnsdomainname</title> 152 <para><command>dnsdomainname</command> 153 reports the system's <acronym>DNS</acronym> domain name. 154 </para></sect3> 155 156 <sect3><title>domainname</title> 157 <para><command>domainname</command> 158 reports or sets the system's 159 <acronym>NIS</acronym>/<acronym>YP</acronym> domain name. 160 </para></sect3> 161 162 <sect3><title>hostname</title> 163 <para><command>hostname</command> 164 reports or sets the name of the current host system. 165 </para></sect3> 166 167 <sect3><title>ifconfig</title> 168 <para><command>ifconfig</command> 169 is the main utility for configuring network interfaces. 170 </para></sect3> 171 172 <sect3><title>ipmaddr</title> 173 <para><command>ipmaddr</command> 174 adds, deletes and shows an interface's multicast addresses. 175 </para></sect3> 176 177 <sect3><title>iptunnel</title> 178 <para><command>iptunnel</command> 179 adds, changes, deletes and shows an interface's tunnels. 180 </para></sect3> 181 182 <sect3><title>mii-tool</title> 183 <para><command>mii-tool</command> 184 checks or sets the status of a network interface's Media Independent 185 Interface (<acronym>MII</acronym>) unit. 186 </para></sect3> 187 188 <sect3><title>nameif</title> 189 <para><command>nameif</command> 190 names network interfaces based on <acronym>MAC</acronym> addresses. 191 </para></sect3> 192 193 <sect3><title>netstat</title> 194 <para><command>netstat</command> 195 is used to report network connections, routing tables, and interface 196 statistics. 197 </para></sect3> 198 199 <sect3><title>nisdomainname</title> 200 <para><command>nisdomainname</command> 201 does the same as <command>domainname</command>. 202 </para></sect3> 203 204 <sect3><title>plipconfig</title> 205 <para><command>plipconfig</command> 206 is used to fine tune the <acronym>PLIP</acronym> device parameters, to 207 improve its performance. 208 </para></sect3> 209 210 <sect3><title>rarp</title> 211 <para><command>rarp</command> 212 is used to manipulate the kernel's <acronym>RARP</acronym> table. 213 </para></sect3> 214 215 <sect3><title>route</title> 216 <para><command>route</command> 217 is used to manipulate the <acronym>IP</acronym> routing table. 218 </para></sect3> 219 220 <sect3><title>slattach</title> 221 <para><command>slattach</command> 222 attaches a network interface to a serial line. This allows you to use 223 normal terminal lines for point-to-point links to other computers. 224 </para></sect3> 225 226 <sect3><title>ypdomainname</title> 227 <para><command>ypdomainname</command> 228 does the same as <command>domainname</command>. 229 </para></sect3> 230 231 </sect2> 232 121 make update</userinput></screen> 122 123 </sect2> 124 125 <sect2 role="commands"> 126 <title>Command Explanations</title> 127 128 <para><command>yes "" | make config</command>: Piping <command>yes</command> 129 to <command>make config</command> skips the interactive configuration and 130 accepts the defaults.</para> 131 132 <para><command>sed -i -e ...</command>: These two <command>sed</command>s 133 change the configuration files to force building the 134 <command>ipmaddr</command>, <command>iptunnel</command> and 135 <command>mii-tool</command> programs.</para> 136 137 </sect2> 138 139 <sect2 role="content"> 140 <title>Contents</title> 141 142 <segmentedlist> 143 <segtitle>Installed Programs</segtitle> 144 <segtitle>Installed Libraries</segtitle> 145 <segtitle>Installed Directories</segtitle> 146 147 <seglistitem> 148 <seg>arp, dnsdomainname, domainname, hostname, 149 ifconfig, ipmaddr, iptunnel, mii-tool, nameif, netstat, 150 nisdomainname, plipconfig, rarp, route, slattach, and 151 ypdomainname</seg> 152 <seg>None</seg> 153 <seg>None</seg> 154 </seglistitem> 155 </segmentedlist> 156 157 <variablelist> 158 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 159 <?dbfo list-presentation="list"?> 160 <?dbhtml list-presentation="table"?> 161 162 <varlistentry id="arp"> 163 <term><command>arp</command></term> 164 <listitem> 165 <para>is used to manipulate the kernel's ARP cache, usually 166 to add or delete an entry, or to dump the entire cache.</para> 167 <indexterm zone="net-tools arp"> 168 <primary sortas="b-arp">arp</primary> 169 </indexterm> 170 </listitem> 171 </varlistentry> 172 173 <varlistentry id="dnsdomainname"> 174 <term><command>dnsdomainname</command></term> 175 <listitem> 176 <para>reports the system's DNS domain name.</para> 177 <indexterm zone="net-tools dnsdomainname"> 178 <primary sortas="b-dnsdomainname">dnsdomainname</primary> 179 </indexterm> 180 </listitem> 181 </varlistentry> 182 183 <varlistentry id="domainname"> 184 <term><command>domainname</command></term> 185 <listitem> 186 <para>reports or sets the system's NIS/YP domain name.</para> 187 <indexterm zone="net-tools domainname"> 188 <primary sortas="b-domainname">domainname</primary> 189 </indexterm> 190 </listitem> 191 </varlistentry> 192 193 <varlistentry id="hostname"> 194 <term><command>hostname</command></term> 195 <listitem> 196 <para>reports or sets the name of the current host system.</para> 197 <indexterm zone="net-tools hostname"> 198 <primary sortas="b-hostname">hostname</primary> 199 </indexterm> 200 </listitem> 201 </varlistentry> 202 203 <varlistentry id="ifconfig"> 204 <term><command>ifconfig</command></term> 205 <listitem> 206 <para>is the main utility for configuring network interfaces.</para> 207 <indexterm zone="net-tools ifconfig"> 208 <primary sortas="b-ifconfig">ifconfig</primary> 209 </indexterm> 210 </listitem> 211 </varlistentry> 212 213 <varlistentry id="ipmaddr"> 214 <term><command>ipmaddr</command></term> 215 <listitem> 216 <para>adds, deletes and shows an interface's multicast addresses.</para> 217 <indexterm zone="net-tools ipmaddr"> 218 <primary sortas="b-ipmaddr">ipmaddr</primary> 219 </indexterm> 220 </listitem> 221 </varlistentry> 222 223 <varlistentry id="iptunnel"> 224 <term><command>iptunnel</command></term> 225 <listitem> 226 <para>adds, changes, deletes and shows an interface's tunnels.</para> 227 <indexterm zone="net-tools iptunnel"> 228 <primary sortas="b-iptunnel">iptunnel</primary> 229 </indexterm> 230 </listitem> 231 </varlistentry> 232 233 <varlistentry id="mii-tool"> 234 <term><command>mii-tool</command></term> 235 <listitem> 236 <para>checks or sets the status of a network interface's Media Independent 237 Interface (MII) unit.</para> 238 <indexterm zone="net-tools mii-tool"> 239 <primary sortas="b-mii-tool">mii-tool</primary> 240 </indexterm> 241 </listitem> 242 </varlistentry> 243 244 <varlistentry id="nameif"> 245 <term><command>nameif</command></term> 246 <listitem> 247 <para>names network interfaces based on MAC addresses.</para> 248 <indexterm zone="net-tools nameif"> 249 <primary sortas="b-nameif">nameif</primary> 250 </indexterm> 251 </listitem> 252 </varlistentry> 253 254 <varlistentry id="netstat"> 255 <term><command>netstat</command></term> 256 <listitem> 257 <para>is used to report network connections, routing tables, and interface 258 statistics.</para> 259 <indexterm zone="net-tools netstat"> 260 <primary sortas="b-netstat">netstat</primary> 261 </indexterm> 262 </listitem> 263 </varlistentry> 264 265 <varlistentry id="nisdomainname"> 266 <term><command>nisdomainname</command></term> 267 <listitem> 268 <para>does the same as <command>domainname</command>.</para> 269 <indexterm zone="net-tools nisdomainname"> 270 <primary sortas="b-nisdomainname">nisdomainname</primary> 271 </indexterm> 272 </listitem> 273 </varlistentry> 274 275 <varlistentry id="plipconfig"> 276 <term><command>plipconfig</command></term> 277 <listitem> 278 <para>is used to fine tune the PLIP device parameters, to 279 improve its performance.</para> 280 <indexterm zone="net-tools plipconfig"> 281 <primary sortas="b-plipconfig">plipconfig</primary> 282 </indexterm> 283 </listitem> 284 </varlistentry> 285 286 <varlistentry id="rarp"> 287 <term><command>rarp</command></term> 288 <listitem> 289 <para>is used to manipulate the kernel's RARP table.</para> 290 <indexterm zone="net-tools rarp"> 291 <primary sortas="b-rarp">rarp</primary> 292 </indexterm> 293 </listitem> 294 </varlistentry> 295 296 <varlistentry id="route"> 297 <term><command>route</command></term> 298 <listitem> 299 <para>is used to manipulate the IP routing table.</para> 300 <indexterm zone="net-tools route"> 301 <primary sortas="b-route">route</primary> 302 </indexterm> 303 </listitem> 304 </varlistentry> 305 306 <varlistentry id="slattach"> 307 <term><command>slattach</command></term> 308 <listitem> 309 <para>attaches a network interface to a serial line. This allows you to use 310 normal terminal lines for point-to-point links to other computers.</para> 311 <indexterm zone="net-tools slattach"> 312 <primary sortas="b-slattach">slattach</primary> 313 </indexterm> 314 </listitem> 315 </varlistentry> 316 317 <varlistentry id="ypdomainname"> 318 <term><command>ypdomainname</command></term> 319 <listitem> 320 <para>does the same as <command>domainname</command>.</para> 321 <indexterm zone="net-tools ypdomainname"> 322 <primary sortas="b-ypdomainname">ypdomainname</primary> 323 </indexterm> 324 </listitem> 325 </varlistentry> 326 327 </variablelist> 328 329 </sect2> 330 233 331 </sect1>
Note:
See TracChangeset
for help on using the changeset viewer.