Magellan Linux

  • Back to homepage
    • /[magellan-source]/tags/mkinitrd-6_5_2/mkinitrd.8

    Annotation of /tags/mkinitrd-6_5_2/mkinitrd.8

    Parent Directory Parent Directory | Revision Log Revision Log

    Revision 1522 - (hide annotations) (download)
    Wed Sep 7 18:40:16 2011 UTC (12 years, 8 months ago) by niro
    File size: 4152 byte(s) 
    tagged 'mkinitrd-6_5_2'
    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