-.TH MKINITRD 8 "Thu Nov 14 2000"
+.TH GENINITRD 8 "Wed Jul 27 2001"
.UC 4
.SH NAME
-mkinitrd \- creates initial ramdisk images for preloading modules
+geninitrd \- creates initial ramdisk images for preloading modules
.SH SYNOPSIS
-\fBmkinitrd\fR [-fv] [--with=\fImodule\fR] [--preload=\fImodule\fR]
+\fBgeninitrd\fR [-fv] [--with=\fImodule\fR] [--preload=\fImodule\fR]
[--omit-scsi-modules] [--omit-raid-modules]
[--omit-ide-modules] [--version] [--fstab=\fIfstab\fR]
[--fs=rom|ext2|cram] \fIimage\fR \fIkernel-version\fR
.SH DESCRIPTION
-\fBmkinitrd\fR creates filesystem images which are suitable for use
+\fBgeninitrd\fR creates filesystem images which are suitable for use
as Linux initial ramdisk (initrd) images. Such images are often
used for preloading the block device modules (such as IDE, SCSI or RAID)
-which are needed to access the root filesystem. \fBmkinitrd\fR
+which are needed to access the root filesystem. \fBgeninitrd\fR
automatically loads all \fIscsi_hostadapter\fR entries in
-\fI/etc/conf.modules\fR when it finds that root fs is mounted on SCSI device,
+\fI/etc/modules.conf\fR when it finds that root fs is mounted on SCSI device,
which makes it simple to build and use kernels using modular SCSI devices.
It will also load IDE and RAID modules when needed.
-Any module options specified in \fI/etc/conf.modules\fR are passed
+Any module options specified in \fI/etc/modules.conf\fR are passed
to the modules as they are loaded by the initial ramdisk.
If the root filesystem is modular, initrd will automatically add the
filesystem's modules to the initrd image.
-If the root device is on a loop device (such as /dev/loop0), \fBmkinitrd\fR
-will attempt to build an initrd which sets up the loopback file properly.
-To do this, the fstab must contain a comment of the form:
-
-# LOOP0: /dev/hda1 vfat /linux/rootfs
-
-LOOP0 must be the name of the loop device which needs to be configured, in
-all capital lettes. The parameters after the color are the device which
-contains the filesystem with the loopback image on it, the filesystem which
-is on the device, and the full path to the loopback image.
+.\" If the root device is on a loop device (such as /dev/loop0), \fBgeninitrd\fR
+.\" will attempt to build an initrd which sets up the loopback file properly.
+.\" To do this, the fstab must contain a comment of the form:
+.\"
+.\" # LOOP0: /dev/hda1 vfat /linux/rootfs
+.\"
+.\" LOOP0 must be the name of the loop device which needs to be configured, in
+.\" all capital lettes. The parameters after the color are the device which
+.\" contains the filesystem with the loopback image on it, the filesystem which
+.\" is on the device, and the full path to the loopback image.
.SH OPTIONS
.TP
\fB-f\fR
-Allows \fBmkinitrd\fR to overwrite an existing image file.
+Allows \fBgeninitrd\fR to overwrite an existing image file.
.TP
\fB-\-fstab=\fR\fIfstab\fR
Only builds the image if their are modules that need to be loaded at boot
time.
+.TP
+\fB-\-image-version
+Append kernel version to initrd name.
+
+.TP
+\fB-\-nocompress
+Don't compress initrd.
+
+.TP
+\fB-\-no-bsp
+Don't use Braindamaged Script Processor (/bin/bsp) and use /bin/trash instead.
+
.TP
\fB-\-omit-scsi-modules
Do not load any scsi modules, including 'scsi_mod' and 'sd_mod'
.TP
\fB-\-preload=\fR\fImodule\fR
+\fB-\-with=\fR\fImodule\fR
Load the module \fImodule\fR in the initial ramdisk image. The module gets
-loaded before any SCSI modules which are specified in \fI/etc/conf.modules\fR.
+loaded before any SCSI modules which are specified in \fI/etc/modules.conf\fR.
This option may be used as many times as necessary.
.TP
\fB-v\fR
Prints out verbose information while creating the image (normally
-the \fBmkinitrd\fR runs silently).
+the \fBgeninitrd\fR runs silently).
.TP
\fB-\-version\fR
-Prints the version of \fBmkinitrd\fR that's being used and then exits.
-
-.TP
-\fB-\-with=\fR\fImodule\fR
-Load the modules \fImodule\fR in the initial ramdisk image. The module
-gets loaded after any SCSI modules which are specified in
-\fI/etc/conf.modules\fR. This option may be used as many times as
-necessary.
+Prints the version of \fBgeninitrd\fR that's being used and then exits.
.TP
\fB-\-fs=\fBext2\fR|\fBrom\fR|\fBcram\fR
.SH FILES
.PD 0
.TP 20
-\fI/etc/sysconfig/mkinitrd\fR
+\fI/etc/sysconfig/geninitrd\fR
Configuraton file with default options. Putting proper options there
helps automatic creation of initrd eg. on kernel upgrade
script useless on systems without block loopback support available.
.TP 20
-\fI/etc/conf.modules\fR
+\fI/etc/modules.conf\fR
Specified SCSI modules to be loaded and module options to be used.
.PD
.SH "SEE ALSO"
.BR fstab (5),
.BR insmod (1),
-.BR kerneld (8),
-.BR lilo (8)
+.BR grub (8),
+.BR lilo (8),
+.BR genromfs (8)
+
-.SH AUTHOR
+.SH AUTHORS
.nf
-Erik Troan <ewt@redhat.com>
+geninitrd is based on mkinitrd by Erik Troan <ewt@redhat.com> and
+contributors:
+ Elliot Lee <sopwith@cuc.edu>
+ Miguel de Icaza <miguel@nuclecu.unam.mx>
+ Christian 'Dr. Disk' Hechelmann <drdisk@ds9.au.s.shuttle.de>
+ Michael K. Johnson <johnsonm@redhat.com>
+ Pierre Habraken <Pierre.Habraken@ujf-grenoble.fr>
+ Jakub Jelinek <jj@ultra.linux.cz>
+ Carlo Arenas Belon (carenas@chasqui.lared.net.pe>
+
+geninitrd is writen by Jacek Konieczny <jajcus@pld.org.pl> and
+contributors (in alphabetic order):
+ Artur Frysiak <wiget@pld.org.pl>
+ Dariusz Karolczak <inglod@pld.org.pl>
+ Tomasz K³oczko <kloczek@pld.org.pl>
+ Arkadiusz Mi¶kiewicz <misiek@pld.org.pl>
+ Micha³ Moskal <malekith@pld.org.pl>
+ Jan Rêkorajski <baggins@pld.org.pl>
+ Sebastian Zagrodzki <zagrodzki@pld.org.pl>
+ Micha³ Zawalich <michuz@pld.org.pl>
+
+Manual page for geninitrd is based on mkinitrd.8 by Erik Troan
+<ewt@redhat.com> and writen by Jacek Konieczny <jajcus@pld.org.pl>
+and contributors.
.fi
projects / projects / geninitrd.git / commitdiff