1
0

module-init-tools.xml 6.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185
  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-module-init-tools" role="wrap">
  8. <?dbhtml filename="module-init-tools.html"?>
  9. <sect1info condition="script">
  10. <productname>module-init-tools</productname>
  11. <productnumber>&module-init-tools-version;</productnumber>
  12. <address>&module-init-tools-url;</address>
  13. </sect1info>
  14. <title>Module-Init-Tools-&module-init-tools-version;</title>
  15. <indexterm zone="ch-system-module-init-tools">
  16. <primary sortas="a-Module-Init-Tools">Module-Init-Tools</primary>
  17. </indexterm>
  18. <sect2 role="package">
  19. <title/>
  20. <para>The Module-Init-Tools package contains programs for handling kernel
  21. modules in Linux kernels greater than or equal to version 2.5.47.</para>
  22. <segmentedlist>
  23. <segtitle>&buildtime;</segtitle>
  24. <segtitle>&diskspace;</segtitle>
  25. <seglistitem>
  26. <seg>&module-init-tools-ch6-sbu;</seg>
  27. <seg>&module-init-tools-ch6-du;</seg>
  28. </seglistitem>
  29. </segmentedlist>
  30. </sect2>
  31. <sect2 role="installation">
  32. <title>Installation of Module-Init-Tools</title>
  33. <para>Apply a patch that contains the generated man pages that were missing
  34. from the released source tarball:</para>
  35. <screen><userinput remap="pre">patch -Np1 -i ../&module-init-tools-man-patch;</userinput></screen>
  36. <para>The test suite of this package is geared towards the needs of its
  37. Maintainer. The command <command>make check</command> builds a specially
  38. wrapped version of modprobe which is useless for normal operation. To run
  39. this (about 0.2 SBU), issue the following commands (note that the
  40. <command>make clean</command> command is required to clean up the source
  41. tree before recompiling for normal use):</para>
  42. <screen><userinput remap="test">DOCBOOKTOMAN=/bin/true ./configure
  43. make check
  44. sed -i -e 's@../../configure@DOCBOOKTOMAN=/bin/true &amp;@' tests/runtests
  45. ./tests/runtests
  46. make clean</userinput></screen>
  47. <para>Prepare Module-Init-Tools for compilation:</para>
  48. <screen><userinput remap="configure">DOCBOOKTOMAN=/bin/true ./configure --prefix=/ \
  49. --enable-zlib-dynamic --mandir=/usr/share/man</userinput></screen>
  50. <para>Compile the package:</para>
  51. <screen><userinput remap="make">make</userinput></screen>
  52. <para>Install the package:</para>
  53. <screen><userinput remap="install">make INSTALL=install install</userinput></screen>
  54. <variablelist>
  55. <title>The meaning of the make parameter:</title>
  56. <varlistentry>
  57. <term><parameter>INSTALL=install</parameter></term>
  58. <listitem>
  59. <para>Normally, <command>make install</command> will not install the
  60. binaries if they already exist. This option overrides that behavior by
  61. calling <command>install</command> instead of using the default
  62. wrapper script.</para>
  63. </listitem>
  64. </varlistentry>
  65. </variablelist>
  66. </sect2>
  67. <sect2 id="contents-module-init-tools" role="content">
  68. <title>Contents of Module-Init-Tools</title>
  69. <segmentedlist>
  70. <segtitle>Installed programs</segtitle>
  71. <seglistitem>
  72. <seg>depmod, insmod, insmod.static, lsmod, modinfo, modprobe, and rmmod</seg>
  73. </seglistitem>
  74. </segmentedlist>
  75. <variablelist>
  76. <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  77. <?dbfo list-presentation="list"?>
  78. <?dbhtml list-presentation="table"?>
  79. <varlistentry id="depmod">
  80. <term><command>depmod</command></term>
  81. <listitem>
  82. <para>Creates a dependency file based on the symbols it finds in the
  83. existing set of modules; this dependency file is used by
  84. <command>modprobe</command> to automatically load the required
  85. modules</para>
  86. <indexterm zone="ch-system-module-init-tools depmod">
  87. <primary sortas="b-depmod">depmod</primary>
  88. </indexterm>
  89. </listitem>
  90. </varlistentry>
  91. <varlistentry id="insmod">
  92. <term><command>insmod</command></term>
  93. <listitem>
  94. <para>Installs a loadable module in the running kernel</para>
  95. <indexterm zone="ch-system-module-init-tools insmod">
  96. <primary sortas="b-insmod">insmod</primary>
  97. </indexterm>
  98. </listitem>
  99. </varlistentry>
  100. <varlistentry id="insmod.static">
  101. <term><command>insmod.static</command></term>
  102. <listitem>
  103. <para>A statically compiled version of <command>insmod</command></para>
  104. <indexterm zone="ch-system-module-init-tools insmod.static">
  105. <primary sortas="b-insmod.static">insmod.static</primary>
  106. </indexterm>
  107. </listitem>
  108. </varlistentry>
  109. <varlistentry id="lsmod">
  110. <term><command>lsmod</command></term>
  111. <listitem>
  112. <para>Lists currently loaded modules</para>
  113. <indexterm zone="ch-system-module-init-tools lsmod">
  114. <primary sortas="b-lsmod">lsmod</primary>
  115. </indexterm>
  116. </listitem>
  117. </varlistentry>
  118. <varlistentry id="modinfo">
  119. <term><command>modinfo</command></term>
  120. <listitem>
  121. <para>Examines an object file associated with a kernel module and
  122. displays any information that it can glean</para>
  123. <indexterm zone="ch-system-module-init-tools modinfo">
  124. <primary sortas="b-modinfo">modinfo</primary>
  125. </indexterm>
  126. </listitem>
  127. </varlistentry>
  128. <varlistentry id="modprobe">
  129. <term><command>modprobe</command></term>
  130. <listitem>
  131. <para>Uses a dependency file, created by
  132. <command>depmod</command>, to automatically load relevant modules</para>
  133. <indexterm zone="ch-system-module-init-tools modprobe">
  134. <primary sortas="b-modprobe">modprobe</primary>
  135. </indexterm>
  136. </listitem>
  137. </varlistentry>
  138. <varlistentry id="rmmod">
  139. <term><command>rmmod</command></term>
  140. <listitem>
  141. <para>Unloads modules from the running kernel</para>
  142. <indexterm zone="ch-system-module-init-tools rmmod">
  143. <primary sortas="b-rmmod">rmmod</primary>
  144. </indexterm>
  145. </listitem>
  146. </varlistentry>
  147. </variablelist>
  148. </sect2>
  149. </sect1>