Annotation of /trunk/mkinitrd-magellan/mkinitrd.8
Parent Directory | Revision Log
Revision 532 -
(hide annotations)
(download)
Sat Sep 1 22:45:15 2007 UTC (17 years, 2 months ago) by niro
File size: 4152 byte(s)
Sat Sep 1 22:45:15 2007 UTC (17 years, 2 months ago) by niro
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 | niro | 532 | .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 |