module-init-tools.xml 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  3. <!ENTITY % general-entities SYSTEM "../general.ent">
  4. <!ENTITY % patches-entities SYSTEM "../patches.ent">
  5. %general-entities;
  6. %patches-entities;
  7. ]>
  8. <sect1 id="ch-system-module-init-tools" role="wrap">
  9. <title>Module-Init-Tools-&module-init-tools-version;</title>
  10. <?dbhtml filename="module-init-tools.html"?>
  11. <indexterm zone="ch-system-module-init-tools"><primary sortas="a-Module-Init-Tools">Module-Init-Tools</primary></indexterm>
  12. <sect2 role="package"><title/>
  13. <para>The Module-Init-Tools package contains programs for handling kernel
  14. modules in Linux kernels greater than or equal to version 2.5.47.</para>
  15. <segmentedlist>
  16. <segtitle>&buildtime;</segtitle>
  17. <segtitle>&diskspace;</segtitle>
  18. <seglistitem><seg>0.1 SBU</seg><seg>4.9 MB</seg></seglistitem>
  19. </segmentedlist>
  20. <segmentedlist>
  21. <segtitle>&dependencies;</segtitle>
  22. <seglistitem><seg>Bash, Binutils, Bison,
  23. Coreutils, Diffutils, Flex, GCC, Glibc, Grep, M4, Make, and Sed</seg></seglistitem>
  24. </segmentedlist>
  25. </sect2>
  26. <sect2 role="installation">
  27. <title>Installation of Module-Init-Tools</title>
  28. <para>Module-Init-Tools attempts to rewrite its
  29. <filename>modprobe.conf</filename> man page during the build process. This is
  30. unnecessary and also relies on <command>docbook2man</command> &mdash; which is not
  31. installed in LFS. Run the following command to avoid this:</para>
  32. <screen><userinput>touch modprobe.conf.5</userinput></screen>
  33. <para>Prepare Module-Init-Tools for compilation:</para>
  34. <screen><userinput>./configure --prefix="" --enable-zlib</userinput></screen>
  35. <para>Compile the package:</para>
  36. <screen><userinput>make</userinput></screen>
  37. <para>To test the results, issue:
  38. <userinput>make check</userinput>.</para>
  39. <para>Install the package:</para>
  40. <screen><userinput>make install</userinput></screen>
  41. </sect2>
  42. <sect2 id="contents-module-init-tools" role="content"><title>Contents of Module-Init-Tools</title>
  43. <segmentedlist>
  44. <segtitle>Installed programs</segtitle>
  45. <seglistitem><seg>depmod, insmod,
  46. insmod.static, lsmod (link to insmod), modinfo, modprobe (link to
  47. insmod), and rmmod (link to insmod)</seg></seglistitem>
  48. </segmentedlist>
  49. <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
  50. <?dbfo list-presentation="list"?>
  51. <?dbhtml list-presentation="table"?>
  52. <varlistentry id="depmod">
  53. <term><command>depmod</command></term>
  54. <listitem>
  55. <para>Creates a dependency file based on the symbols it finds in the
  56. existing set of modules; this dependency file is used by <command>modprobe</command> to
  57. automatically load the required modules</para>
  58. <indexterm zone="ch-system-module-init-tools depmod"><primary sortas="b-depmod">depmod</primary></indexterm>
  59. </listitem>
  60. </varlistentry>
  61. <varlistentry id="insmod">
  62. <term><command>insmod</command></term>
  63. <listitem>
  64. <para>Installs a loadable module in the running kernel</para>
  65. <indexterm zone="ch-system-module-init-tools insmod"><primary sortas="b-insmod">insmod</primary></indexterm>
  66. </listitem>
  67. </varlistentry>
  68. <varlistentry id="insmod.static">
  69. <term><command>insmod.static</command></term>
  70. <listitem>
  71. <para>A statically compiled version of <command>insmod</command></para>
  72. <indexterm zone="ch-system-module-init-tools insmod.static"><primary
  73. sortas="b-insmod.static">insmod.static</primary></indexterm>
  74. </listitem>
  75. </varlistentry>
  76. <varlistentry id="lsmod">
  77. <term><command>lsmod</command></term>
  78. <listitem>
  79. <para>Lists currently loaded modules</para>
  80. <indexterm zone="ch-system-module-init-tools lsmod"><primary sortas="b-lsmod">lsmod</primary></indexterm>
  81. </listitem>
  82. </varlistentry>
  83. <varlistentry id="modinfo">
  84. <term><command>modinfo</command></term>
  85. <listitem>
  86. <para>Examines an object file associated with a kernel module and
  87. displays any information that it can glean</para>
  88. <indexterm zone="ch-system-module-init-tools modinfo"><primary sortas="b-modinfo">modinfo</primary></indexterm>
  89. </listitem>
  90. </varlistentry>
  91. <varlistentry id="modprobe">
  92. <term><command>modprobe</command></term>
  93. <listitem>
  94. <para>Uses a dependency file, created by
  95. <command>depmod</command>, to automatically load relevant modules</para>
  96. <indexterm zone="ch-system-module-init-tools modprobe"><primary sortas="b-modprobe">modprobe</primary></indexterm>
  97. </listitem>
  98. </varlistentry>
  99. <varlistentry id="rmmod">
  100. <term><command>rmmod</command></term>
  101. <listitem>
  102. <para>Unloads modules from the running kernel</para>
  103. <indexterm zone="ch-system-module-init-tools rmmod"><primary sortas="b-rmmod">rmmod</primary></indexterm>
  104. </listitem>
  105. </varlistentry>
  106. </variablelist>
  107. </sect2>
  108. </sect1>