source: BOOK/final-system/common/module-init-tools.xml@ 1756a6e

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 1756a6e was 26529ea, checked in by Jim Gifford <clfs@…>, 16 years ago

Updated Module Init Tools to 3.9

  • Property mode set to 100644
File size: 6.4 KB
Line 
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
8<sect1 id="ch-system-module-init-tools" role="wrap">
9 <?dbhtml filename="module-init-tools.html"?>
10
11 <title>Module-Init-Tools-&module-init-tools-version;</title>
12
13 <indexterm zone="ch-system-module-init-tools">
14 <primary sortas="a-Module-Init-Tools">Module-Init-Tools</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
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
23 </sect2>
24
25 <sect2 role="installation">
26 <title>Installation of Module-Init-Tools</title>
27
28 <para os="c">Issue the following commands to perform the tests</para>
29
30 <note os="cc">
31 <para>The <command>make clean</command> command is required to clean up
32 the source tree, otherwise the code built for testing will be installed,
33 and the test version of <command>modprobe</command> does not function
34 outside the test environment.</para>
35 </note>
36
37<screen os="d"><userinput>./configure &amp;&amp;
38make check &amp;&amp;
39make clean</userinput></screen>
40
41 <para os="e">Prepare Module-Init-Tools for compilation:</para>
42
43<screen os="f"><userinput>./configure --prefix=/usr \
44 --bindir=/bin --sbindir=/sbin \
45 --enable-zlib</userinput></screen>
46
47 <variablelist os="g">
48 <title>The meaning of the configure option:</title>
49
50 <varlistentry>
51 <term><parameter>--enable-zlib</parameter></term>
52 <listitem>
53 <para>This allows the Module-Init-Tools package to handle compressed
54 kernel modules.</para>
55 </listitem>
56 </varlistentry>
57
58 </variablelist>
59
60 <para os="h">Compile the package:</para>
61
62<screen os="i"><userinput>make DOCBOOKTOMAN=""</userinput></screen>
63
64 <para os="j">Install the package:</para>
65
66<screen os="k"><userinput>make INSTALL=install install</userinput></screen>
67
68 <variablelist os="l">
69 <title>The meaning of the make install parameter:</title>
70 <varlistentry>
71 <term><parameter>INSTALL=install</parameter></term>
72 <listitem>
73 <para>Normally, <command>make install</command> will not install the binaries if they
74 already exist. This option overrides that behavior by calling
75 <command>install</command> instead of using the default wrapper
76 script.</para>
77 </listitem>
78 </varlistentry>
79 </variablelist>
80
81 </sect2>
82
83 <sect2 id="contents-module-init-tools" role="content">
84 <title>Contents of Module-Init-Tools</title>
85
86 <segmentedlist>
87 <segtitle>Installed programs</segtitle>
88
89 <seglistitem>
90 <seg>depmod, generate-modprobe.conf, insmod, insmod.static,
91 lsmod (link to insmod), modinfo, modprobe (link to insmod), and
92 rmmod (link to insmod)</seg>
93 </seglistitem>
94 </segmentedlist>
95
96 <variablelist>
97 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
98 <?dbfo list-presentation="list"?>
99 <?dbhtml list-presentation="table"?>
100
101 <varlistentry id="depmod">
102 <term><command>depmod</command></term>
103 <listitem>
104 <para>Creates a dependency file based on the symbols it finds in
105 the existing set of modules; this dependency file is used by
106 <command>modprobe</command> to automatically load the required
107 modules</para>
108 <indexterm zone="ch-system-module-init-tools depmod">
109 <primary sortas="b-depmod">depmod</primary>
110 </indexterm>
111 </listitem>
112 </varlistentry>
113
114 <varlistentry id="generate-modprobe.conf">
115 <term><command>generate-modprobe.conf</command></term>
116 <listitem>
117 <para>Creates a modprobe.conf file from an existing 2.2 or 2.4
118 module setup</para>
119 <indexterm zone="ch-system-module-init-tools generate-modprobe.conf">
120 <primary sortas="b-generate-modprobe.conf">generate-modprobe.conf</primary>
121 </indexterm>
122 </listitem>
123 </varlistentry>
124
125 <varlistentry id="insmod">
126 <term><command>insmod</command></term>
127 <listitem>
128 <para>Installs a loadable module in the running kernel</para>
129 <indexterm zone="ch-system-module-init-tools insmod">
130 <primary sortas="b-insmod">insmod</primary>
131 </indexterm>
132 </listitem>
133 </varlistentry>
134
135 <varlistentry id="insmod.static">
136 <term><command>insmod.static</command></term>
137 <listitem>
138 <para>A statically compiled version of <command>insmod</command></para>
139 <indexterm zone="ch-system-module-init-tools insmod.static">
140 <primary sortas="b-insmod.static">insmod.static</primary>
141 </indexterm>
142 </listitem>
143 </varlistentry>
144
145 <varlistentry id="lsmod">
146 <term><command>lsmod</command></term>
147 <listitem>
148 <para>Lists currently loaded modules</para>
149 <indexterm zone="ch-system-module-init-tools lsmod">
150 <primary sortas="b-lsmod">lsmod</primary>
151 </indexterm>
152 </listitem>
153 </varlistentry>
154
155 <varlistentry id="modinfo">
156 <term><command>modinfo</command></term>
157 <listitem>
158 <para>Examines an object file associated with a kernel module and
159 displays any information that it can glean</para>
160 <indexterm zone="ch-system-module-init-tools modinfo">
161 <primary sortas="b-modinfo">modinfo</primary>
162 </indexterm>
163 </listitem>
164 </varlistentry>
165
166 <varlistentry id="modprobe">
167 <term><command>modprobe</command></term>
168 <listitem>
169 <para>Uses a dependency file, created by <command>depmod</command>,
170 to automatically load relevant modules</para>
171 <indexterm zone="ch-system-module-init-tools modprobe">
172 <primary sortas="b-modprobe">modprobe</primary>
173 </indexterm>
174 </listitem>
175 </varlistentry>
176
177 <varlistentry id="rmmod">
178 <term><command>rmmod</command></term>
179 <listitem>
180 <para>Unloads modules from the running kernel</para>
181 <indexterm zone="ch-system-module-init-tools rmmod">
182 <primary sortas="b-rmmod">rmmod</primary>
183 </indexterm>
184 </listitem>
185 </varlistentry>
186
187 </variablelist>
188
189 </sect2>
190
191</sect1>
Note: See TracBrowser for help on using the repository browser.