iproute2.xml 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322
  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. <sect1 id="ch-system-iproute2" role="wrap">
  8. <?dbhtml filename="iproute2.html"?>
  9. <sect1info condition="script">
  10. <productname>iproute2</productname>
  11. <productnumber>&iproute2-version;</productnumber>
  12. <address>&iproute2-url;</address>
  13. </sect1info>
  14. <title>IPRoute2-&iproute2-version;</title>
  15. <indexterm zone="ch-system-iproute2">
  16. <primary sortas="a-IPRoute2">IPRoute2</primary>
  17. </indexterm>
  18. <sect2 role="package">
  19. <title/>
  20. <para>The IPRoute2 package contains programs for basic and advanced IPV4-based
  21. networking.</para>
  22. <segmentedlist>
  23. <segtitle>&buildtime;</segtitle>
  24. <segtitle>&diskspace;</segtitle>
  25. <seglistitem>
  26. <seg>&iproute2-fin-sbu;</seg>
  27. <seg>&iproute2-fin-du;</seg>
  28. </seglistitem>
  29. </segmentedlist>
  30. </sect2>
  31. <sect2 role="installation">
  32. <title>Installation of IPRoute2</title>
  33. <para>The <command>arpd</command> program included in this package will not
  34. be built since it is dependent on Berkeley DB, which is not installed in
  35. LFS. However, a directory for <command>arpd</command> and a man page will still
  36. be installed. Prevent this by running the commands below.
  37. If the <command>arpd</command> binary is needed,
  38. instructions for compiling Berkeley DB can be found in the BLFS Book at
  39. <ulink url="&blfs-book;server/db.html"/>.
  40. </para>
  41. <screen><userinput remap="pre">sed -i /ARPD/d Makefile
  42. rm -fv man/man8/arpd.8</userinput></screen>
  43. <para>It is also necessary to disable building two modules that
  44. require <ulink url="&blfs-book;postlfs/iptables.html"/>.</para>
  45. <screen><userinput remap="pre">sed -i 's/.m_ipt.o//' tc/Makefile</userinput></screen>
  46. <para>Compile the package:</para>
  47. <screen><userinput remap="make">make</userinput></screen>
  48. <para>This package does not have a working test suite.</para>
  49. <!-- currently not useful, no tests actually run
  50. <para>This package comes with a test suite, but due to assumptions it makes,
  51. it is not possible to reliably run these tests from within the chroot
  52. environment. If you wish to run these tests after booting into your new LFS
  53. system, ensure you enable <filename>/proc/config.gz</filename> support
  54. in your kernel (&quot;General setup&quot; -> &quot;Enable access to
  55. .config through /proc/config.gz&quot; [CONFIG_IKCONFIG_PROC]), then run
  56. 'make alltests' from the <filename class="directory">testsuite/</filename>
  57. subdirectory.</para>-->
  58. <para>Install the package:</para>
  59. <screen><userinput remap="install">make DOCDIR=/usr/share/doc/iproute2-&iproute2-version; install</userinput></screen>
  60. </sect2>
  61. <sect2 id="contents-iproute2" role="content">
  62. <title>Contents of IPRoute2</title>
  63. <segmentedlist>
  64. <segtitle>Installed programs</segtitle>
  65. <segtitle>Installed directories</segtitle>
  66. <seglistitem>
  67. <seg>bridge, ctstat (link to lnstat), genl, ifcfg, ifstat, ip, lnstat,
  68. nstat, routef, routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss,
  69. and tc</seg>
  70. <seg>/etc/iproute2, /usr/lib/tc, and /usr/share/doc/iproute2-&iproute2-version;,
  71. </seg>
  72. </seglistitem>
  73. </segmentedlist>
  74. <variablelist>
  75. <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  76. <?dbfo list-presentation="list"?>
  77. <?dbhtml list-presentation="table"?>
  78. <varlistentry id="bridge">
  79. <term><command>bridge</command></term>
  80. <listitem>
  81. <para>Configures network bridges</para>
  82. <indexterm zone="ch-system-iproute2 bridge">
  83. <primary sortas="b-bridge">bridge</primary>
  84. </indexterm>
  85. </listitem>
  86. </varlistentry>
  87. <varlistentry id="ctstat">
  88. <term><command>ctstat</command></term>
  89. <listitem>
  90. <para>Connection status utility</para>
  91. <indexterm zone="ch-system-iproute2 ctstat">
  92. <primary sortas="b-ctstat">ctstat</primary>
  93. </indexterm>
  94. </listitem>
  95. </varlistentry>
  96. <varlistentry id="genl">
  97. <term><command>genl</command></term>
  98. <listitem>
  99. <para>Generic netlink utility frontend</para>
  100. <indexterm zone="ch-system-iproute2 genl">
  101. <primary sortas="b-genl">genl</primary>
  102. </indexterm>
  103. </listitem>
  104. </varlistentry>
  105. <varlistentry id="ifcfg">
  106. <term><command>ifcfg</command></term>
  107. <listitem>
  108. <para>A shell script wrapper for the <command>ip</command> command
  109. [Note that it requires the <command>arping</command> and
  110. <command>rdisk</command> programs from the
  111. iputils package found at <ulink url="http://www.skbuff.net/iputils/"/>.]</para>
  112. <indexterm zone="ch-system-iproute2 ifcfg">
  113. <primary sortas="b-ifcfg">ifcfg</primary>
  114. </indexterm>
  115. </listitem>
  116. </varlistentry>
  117. <varlistentry id="ifstat">
  118. <term><command>ifstat</command></term>
  119. <listitem>
  120. <para>Shows the interface statistics, including the amount of
  121. transmitted and received packets by interface</para>
  122. <indexterm zone="ch-system-iproute2 ifstat">
  123. <primary sortas="b-ifstat">ifstat</primary>
  124. </indexterm>
  125. </listitem>
  126. </varlistentry>
  127. <varlistentry id="ip">
  128. <term><command>ip</command></term>
  129. <listitem>
  130. <para>The main executable. It has several different functions:</para>
  131. <para><command>ip link <replaceable>&lt;device&gt;</replaceable></command>
  132. allows users to look at the state of devices and to make changes</para>
  133. <para><command>ip addr</command> allows users to look at addresses and
  134. their properties, add new addresses, and delete old ones</para>
  135. <para><command>ip neighbor</command> allows users to look at neighbor
  136. bindings and their properties, add new neighbor entries, and delete
  137. old ones</para>
  138. <para><command>ip rule</command> allows users to look at the routing
  139. policies and change them</para>
  140. <para><command>ip route</command> allows users to look at the routing
  141. table and change routing table rules</para>
  142. <para><command>ip tunnel</command> allows users to look at the IP
  143. tunnels and their properties, and change them</para>
  144. <para><command>ip maddr</command> allows users to look at the multicast
  145. addresses and their properties, and change them</para>
  146. <para><command>ip mroute</command> allows users to set, change, or
  147. delete the multicast routing</para>
  148. <para><command>ip monitor</command> allows users to continuously monitor
  149. the state of devices, addresses and routes</para>
  150. <indexterm zone="ch-system-iproute2 ip">
  151. <primary sortas="b-ip">ip</primary>
  152. </indexterm>
  153. </listitem>
  154. </varlistentry>
  155. <varlistentry id="lnstat">
  156. <term><command>lnstat</command></term>
  157. <listitem>
  158. <para>Provides Linux network statistics; it is a generalized and more
  159. feature-complete replacement for the old <command>rtstat</command>
  160. program</para>
  161. <indexterm zone="ch-system-iproute2 lnstat">
  162. <primary sortas="b-lnstat">lnstat</primary>
  163. </indexterm>
  164. </listitem>
  165. </varlistentry>
  166. <varlistentry id="nstat">
  167. <term><command>nstat</command></term>
  168. <listitem>
  169. <para>Shows network statistics</para>
  170. <indexterm zone="ch-system-iproute2 nstat">
  171. <primary sortas="b-nstat">nstat</primary>
  172. </indexterm>
  173. </listitem>
  174. </varlistentry>
  175. <varlistentry id="routef">
  176. <term><command>routef</command></term>
  177. <listitem>
  178. <para>A component of <command>ip route</command>. This is for flushing
  179. the routing tables</para>
  180. <indexterm zone="ch-system-iproute2 routef">
  181. <primary sortas="b-routef">routef</primary>
  182. </indexterm>
  183. </listitem>
  184. </varlistentry>
  185. <varlistentry id="routel">
  186. <term><command>routel</command></term>
  187. <listitem>
  188. <para>A component of <command>ip route</command>. This is for listing
  189. the routing tables</para>
  190. <indexterm zone="ch-system-iproute2 routel">
  191. <primary sortas="b-routel">routel</primary>
  192. </indexterm>
  193. </listitem>
  194. </varlistentry>
  195. <varlistentry id="rtacct">
  196. <term><command>rtacct</command></term>
  197. <listitem>
  198. <para>Displays the contents of
  199. <filename>/proc/net/rt_acct</filename></para>
  200. <indexterm zone="ch-system-iproute2 rtacct">
  201. <primary sortas="b-rtacct">rtacct</primary>
  202. </indexterm>
  203. </listitem>
  204. </varlistentry>
  205. <varlistentry id="rtmon">
  206. <term><command>rtmon</command></term>
  207. <listitem>
  208. <para>Route monitoring utility</para>
  209. <indexterm zone="ch-system-iproute2 rtmon">
  210. <primary sortas="b-rtmon">rtmon</primary>
  211. </indexterm>
  212. </listitem>
  213. </varlistentry>
  214. <varlistentry id="rtpr">
  215. <term><command>rtpr</command></term>
  216. <listitem>
  217. <para>Converts the output of <command>ip -o</command> back into a
  218. readable form</para>
  219. <indexterm zone="ch-system-iproute2 rtpr">
  220. <primary sortas="b-rtpr">rtpr</primary>
  221. </indexterm>
  222. </listitem>
  223. </varlistentry>
  224. <varlistentry id="rtstat">
  225. <term><command>rtstat</command></term>
  226. <listitem>
  227. <para>Route status utility</para>
  228. <indexterm zone="ch-system-iproute2 rtstat">
  229. <primary sortas="b-rtstat">rtstat</primary>
  230. </indexterm>
  231. </listitem>
  232. </varlistentry>
  233. <varlistentry id="ss">
  234. <term><command>ss</command></term>
  235. <listitem>
  236. <para>Similar to the <command>netstat</command> command; shows active
  237. connections</para>
  238. <indexterm zone="ch-system-iproute2 ss">
  239. <primary sortas="b-ss">ss</primary>
  240. </indexterm>
  241. </listitem>
  242. </varlistentry>
  243. <varlistentry id="tc">
  244. <term><command>tc</command></term>
  245. <listitem>
  246. <para>Traffic Controlling Executable; this is for Quality Of Service
  247. (QOS) and Class Of Service (COS) implementations</para>
  248. <para><command>tc qdisc</command> allows users to setup the queueing
  249. discipline</para>
  250. <para><command>tc class</command> allows users to setup classes based
  251. on the queuing discipline scheduling</para>
  252. <para><command>tc estimator</command> allows users to estimate the
  253. network flow into a network</para>
  254. <para><command>tc filter</command> allows users to setup the QOS/COS
  255. packet filtering</para>
  256. <para><command>tc policy</command> allows users to setup the QOS/COS
  257. policies</para>
  258. <indexterm zone="ch-system-iproute2 ss">
  259. <primary sortas="b-tc">tc</primary>
  260. </indexterm>
  261. </listitem>
  262. </varlistentry>
  263. </variablelist>
  264. </sect2>
  265. </sect1>