1 <?xml version="1.0" encoding="utf-8"?>
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3 "file:///usr/share/sgml/docbook/xml-dtd-4.1.2/docbookx.dtd">
7 <refentrytitle>geninitrd</refentrytitle>
8 <manvolnum>8</manvolnum>
9 <refmiscinfo class="software">PLD</refmiscinfo>
10 <refmiscinfo class="date">$Date: 2002/03/07 09:57:36 $</refmiscinfo>
13 <refname>geninitrd</refname>
15 creates initial ramdisk images for preloading modules
20 <command>geninitrd</command>
23 <arg rep="repeat">--with=module</arg>
24 <arg rep="repeat">--preload=module</arg>
25 <arg>--fstab=fstab</arg>
26 <arg>--raidtab=raidtab</arg>
27 <arg>--modules-conf=modules.conf</arg>
28 <arg>--fs=rom|ext2|cram</arg>
29 <arg choice="req">image</arg>
30 <arg choice="req">kernel-version</arg>
33 <command>geninitrd</command>
39 <title>Description</title>
41 <application>geninitrd</application> creates filesystem images
42 which are suitable for use as Linux initial ramdisk (initrd)
43 images. Such images are often used for preloading the block
44 device modules (such as IDE, SCSI or RAID) which are needed to
45 access the root filesystem. <application>geninitrd</application>
46 automatically loads all <varname>scsi_hostadapter</varname>
47 entries in <filename>/etc/modules.conf</filename> when it finds
48 that root fs is mounted on SCSI device, which makes it simple to
49 build and use kernels using modular SCSI devices. It will also
50 load IDE and RAID modules when needed. </para>
51 <para>Any module options specified in
52 <filename>/etc/modules.conf</filename> are passed to the modules
53 as they are loaded by the initial ramdisk. </para>
54 <para>If the root filesystem is modular, initrd will automatically
55 add the filesystem's modules to the initrd image.</para>
57 <!-- <para>If the root device is on a loop device (such as
58 <filename>/dev/loop0</filename>), <application>geninitrd</application>
59 will attempt to build an initrd which sets up the loopback file
60 properly. To do this, the fstab must contain a comment of the form:
62 # LOOP0: /dev/hda1 vfat /linux/rootfs
64 LOOP0 must be the name of the loop device which needs to be configured, in
65 all capital lettes. The parameters after the color are the device which
66 contains the filesystem with the loopback image on it, the filesystem which
67 is on the device, and the full path to the loopback image.
71 <title>Options</title>
77 <para>Allows <application>geninitrd</application> to
78 overwrite an existing image file.</para>
82 <term>--fstab=<filename>fstab</filename></term>
84 <para>Use <filename>fstab</filename> to automatically
85 determine what type of filesystem the root device is on.
86 Normally, <filename>/etc/fstab</filename> is used.</para>
90 <term>--raidtab=<filename>raidtab</filename></term>
92 <para>Use <filename>raidtab</filename> to automatically
93 determine raid settings of the root device. Normally,
94 <filename>/etc/raidtab</filename> is used.</para>
98 <term>--ifneeded</term>
100 <para>Only builds the image if their are modules that need
101 to be loaded at boot time.</para>
105 <term>--image-version</term>
107 <para>Append kernel version to initrd name.</para>
111 <term>--nocompress</term>
113 <para>Don't compress initrd.</para>
117 <term>--no-bsp</term>
119 <para>Don't use Braindamaged Script Processor (/bin/bsp) and use /bin/trash instead.</para>
123 <term>--preload=<filename>module</filename></term>
125 <para>Load the module <filename>module</filename> in the
126 initial ramdisk image. The module gets loaded before any
127 SCSI modules which are specified in
128 <filename>/etc/modules.conf</filename>. This option may be
129 used as many times as necessary.
134 <term>--with=<filename>module</filename></term>
136 <para>Alias to --preload.</para>
142 <para>Prints out verbose information while creating the
143 image (normally the <application>geninitrd</application>
149 <term>--version</term>
151 <para>Prints the version of
152 <application>geninitrd</application> that's being used and
157 <term>--initrdfs=<filename>ext2|rom|cram</filename></term>
159 <para>Filesystem type to be used for the image. Only
160 selected filesystem should always be compiled into
170 <term><filename>/etc/sysconfig/geninitrd</filename></term>
172 <para>Configuraton file with default options. Putting proper
173 options there helps in automatic creation of initrd eg. on
180 class="devicefile">/dev/loop*</filename></term>
182 <para>A block loopback device is used to create the image,
183 which makes this script useless on systems without block
184 loopback support available.
189 <term><filename>/etc/modules.conf</filename></term>
191 <para>Specified SCSI modules to be loaded and module options
198 <title>SEE ALSO</title>
200 <refentrytitle>fstab</refentrytitle>
201 <manvolnum>5</manvolnum>
204 <refentrytitle>insmod</refentrytitle>
205 <manvolnum>1</manvolnum>
208 <refentrytitle>grub</refentrytitle>
209 <manvolnum>8</manvolnum>
212 <refentrytitle>lilo</refentrytitle>
213 <manvolnum>8</manvolnum>
216 <refentrytitle>genromfs</refentrytitle>
217 <manvolnum>8</manvolnum>
223 <title>Authors</title>
224 <para><application>geninitrd</application> is based on mkinitrd by
225 Erik Troan <email>ewt@redhat.com</email> and contributors:
227 <member>Elliot Lee <email>sopwith@cuc.edu</email></member>
228 <member> Miguel de Icaza
229 <email>miguel@nuclecu.unam.mx</email></member>
230 <member>Christian 'Dr. Disk' Hechelmann
231 <email>drdisk@ds9.au.s.shuttle.de</email></member>
232 <member>Michael K. Johnson
233 <email>johnsonm@redhat.com</email></member>
234 <memeber>Pierre Habraken
235 <email>Pierre.Habraken@ujf-grenoble.fr</email></memeber>
236 <member>Jakub Jelinek
237 <email>jj@ultra.linux.cz</email></member>
238 <member>Carlo Arenas Belon
239 <email>carenas@chasqui.lared.net.pe</email></member>
242 <para><application>geninird</application> is writen by Jacek
243 Konieczny <email>jajcus@pld.org.pl</email> and contributors (in
244 alphabetic order): <simplelist>
245 <member>Artur Frysiak <email>wiget@pld.org.pl</email></member>
246 <member>Dariusz Karolczak
247 <email>inglod@pld.org.pl</email></member>
248 <member>Tomasz Kłoczko
249 <email>kloczek@pld.org.pl</email></member>
250 <member>Arkadiusz Miśkiewicz
251 <email>misiek@pld.org.pl</email></member>
252 <member>Michał Moskal
253 <email>malekith@pld.org.pl</email></member>
254 <member>Jan Rękorajski
255 <email>baggins@pld.org.pl</email></member>
256 <member>Sebastian Zagrodzki
257 <email>zagrodzki@pld.org.pl</email></member>
258 <member>Michał Zawalich
259 <email>michuz@pld.org.pl</email></member>
262 <para> Manual page for <application>geninitrd</application> is
263 based on mkinitrd.8 by Erik Troan <email>ewt@redhat.com</email>
264 and writen by Jacek Konieczny
265 <email>jajcus@pld.org.pl</email>and contributors.</para>