Contents of /tags/mkinitrd-6_3_3/mkinitrd.8
Parent Directory | Revision Log
Revision 532 -
(show annotations)
(download)
Sat Sep 1 22:45:15 2007 UTC (17 years, 1 month ago) by niro
Original Path: trunk/mkinitrd-magellan/mkinitrd.8
File size: 4152 byte(s)
Sat Sep 1 22:45:15 2007 UTC (17 years, 1 month ago) by niro
Original Path: trunk/mkinitrd-magellan/mkinitrd.8
File size: 4152 byte(s)
-import if magellan mkinitrd; it is a fork of redhats mkinitrd-5.0.8 with all magellan patches and features; deprecates magellan-src/mkinitrd
1 | .TH MKINITRD 8 "Tue Aug 10 2004" |
2 | .SH NAME |
3 | mkinitrd \- creates initial ramdisk images for preloading modules |
4 | .SH SYNOPSIS |
5 | \fBmkinitrd\fR [--version] [-v] [-f] |
6 | [--preload=\fImodule\fR] [--omit-scsi-modules] |
7 | [--omit-raid-modules] [--omit-lvm-modules] |
8 | [--with=\fImodule\fR] [--image-version] |
9 | [--fstab=\fIfstab\fR] [--nocompress] |
10 | [--builtin=\fImodule\fR] [--nopivot] |
11 | \fIimage\fR \fIkernel-version\fR |
12 | |
13 | .SH DESCRIPTION |
14 | \fBmkinitrd\fR creates an initial image used by the kernel for |
15 | preloading the block device modules (such as IDE, SCSI or RAID) |
16 | which are needed to access the root filesystem. \fBmkinitrd\fR |
17 | automatically loads filesystem modules (such as ext3 and jbd), IDE modules, all |
18 | \fIscsi_hostadapter\fR entries in \fI/etc/modprobe.conf\fR, and raid |
19 | modules if the system's root partition is on raid, which makes it simple |
20 | to build and use kernels using modular device drivers. |
21 | |
22 | Any module options specified in \fI/etc/modprobe.conf\fR are passed |
23 | to the modules as they are loaded by the initial ramdisk. |
24 | |
25 | The root filesystem used by the kernel is specified in the boot configuration |
26 | file, as always. The traditional \fBroot=/dev/hda1\fR style device |
27 | specification is allowed. If a label is used, as in \fBroot=LABEL=rootPart\fR |
28 | the initrd will search all available devices for an ext2 or ext3 filesystem |
29 | with the appropriate label, and mount that device as the root filesystem. |
30 | |
31 | .SH OPTIONS |
32 | .TP |
33 | \fB-\-builtin=\fR\fImodule\fR |
34 | Act as if \fImodule\fR is built into the kernel being used. \fBmkinitrd\fR |
35 | will not look for this module, and will not emit an error if it does not |
36 | exist. This option may be used multiple times. |
37 | |
38 | .TP |
39 | \fB-f\fR |
40 | Allows \fBmkinitrd\fR to overwrite an existing image file. |
41 | |
42 | .TP |
43 | \fB-\-fstab=\fR\fIfstab\fR |
44 | Use \fIfstab\fR to automatically determine what type of filesystem the |
45 | root device is on. Normally, \fB/etc/fstab\fR is used. |
46 | |
47 | .TP |
48 | \fB-\-image-version |
49 | The kernel version number is appended to the initrd image path before the image |
50 | is created. |
51 | |
52 | .TP |
53 | \fB-\-nocompress |
54 | Normally the created initrd image is compressed with \fBgzip\fR. If this |
55 | option is specified, the compression is skipped. |
56 | |
57 | .TP |
58 | \fB-\-nopivot |
59 | Do not use the \fBpivot_root\fR system call as part of the initrd. This |
60 | lets \fBmkinitrd\fR build proper images for Linux 2.2 kernels at the expense |
61 | of some features. In particular, some filesystems (such as ext3) will not |
62 | work properly and filesystem options will not be used to mount root. This |
63 | option is not recommended, and will be removed in future versions. |
64 | |
65 | .TP |
66 | \fB-\-omit-lvm-modules |
67 | Do not load any lvm modules, even if /etc/fstab expects them. |
68 | |
69 | .TP |
70 | \fB-\-omit-raid-modules |
71 | Do not load any raid modules, even if /etc/fstab and /etc/raidtab expect them. |
72 | |
73 | .TP |
74 | \fB-\-omit-scsi-modules |
75 | Do not load any scsi modules, including 'scsi_mod' and 'sd_mod' |
76 | modules, even if they are present. |
77 | |
78 | .TP |
79 | \fB-\-preload=\fR\fImodule\fR |
80 | Load the module \fImodule\fR in the initial ramdisk image. The module gets |
81 | loaded before any SCSI modules which are specified in \fI/etc/modprobe.conf\fR. |
82 | This option may be used as many times as necessary. |
83 | |
84 | .TP |
85 | \fB-v\fR |
86 | Prints out verbose information while creating the image (normally |
87 | the \fBmkinitrd\fR runs silently). |
88 | |
89 | .TP |
90 | \fB-\-version\fR |
91 | Prints the version of \fBmkinitrd\fR that's being used and then exits. |
92 | |
93 | .TP |
94 | \fB-\-with=\fR\fImodule\fR |
95 | Load the modules \fImodule\fR in the initial ramdisk image. The module |
96 | gets loaded after any SCSI modules which are specified in |
97 | \fI/etc/modprobe.conf\fR. This option may be used as many times as |
98 | necessary. |
99 | |
100 | .SH FILES |
101 | .PD 0 |
102 | .TP 20 |
103 | \fI/dev/loop*\fR |
104 | A block loopback device is used to create the image, which makes this |
105 | script useless on systems without block loopback support available |
106 | \fI(only used on kernels < 2.6)\fR |
107 | |
108 | .TP 20 |
109 | \fI/etc/modprobe.conf\fR |
110 | Specifies SCSI modules to be loaded and module options to be used. |
111 | |
112 | .TP 20 |
113 | \fI/etc/modules.conf\fR |
114 | Specifies SCSI modules to be loaded and module options to be used. |
115 | \fI(only used on kernels < 2.6)\fR |
116 | |
117 | .PD |
118 | .SH "SEE ALSO" |
119 | .BR fstab (5), |
120 | .BR insmod (1), |
121 | .BR kerneld (8), |
122 | .BR lilo (8) |
123 | |
124 | .SH AUTHOR |
125 | .nf |
126 | Erik Troan <ewt@redhat.com> |
127 | .fi |