Blob Blame History Raw
'\" t
.\"     Title: mkinitrd
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 10/09/2018
.\"    Manual: dracut
.\"    Source: dracut
.\"  Language: English
.\"
.TH "MKINITRD" "8" "10/09/2018" "dracut" "dracut"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
mkinitrd \- is a compat wrapper, which calls dracut to generate an initramfs
.SH "SYNOPSIS"
.sp
\fBmkinitrd\fR [\fIOPTION\&...\fR] [<initrd\-image>] <kernel\-version>
.SH "DESCRIPTION"
.sp
mkinitrd creates an initramfs image <initrd\-image> for the kernel with version <kernel\-version> by calling "dracut"\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBImportant\fR
.ps -1
.br
.sp
If a more fine grained control over the resulting image is needed, "dracut" should be called directly\&.
.sp .5v
.RE
.SH "OPTIONS"
.PP
\fB\-\-version\fR
.RS 4
print info about the version
.RE
.PP
\fB\-v, \-\-verbose\fR
.RS 4
increase verbosity level
.RE
.PP
\fB\-f, \-\-force\fR
.RS 4
overwrite existing initramfs file\&.
.RE
.PP
\fB*\-\-image\-version\fR
.RS 4
append the kernel version to the target image <initrd\-image>\-<kernel\-version>\&.
.RE
.PP
\fB\-\-with=<module>\fR
.RS 4
add the kernel module <module> to the initramfs\&.
.RE
.PP
\fB\-\-preload=<module>\fR
.RS 4
preload the kernel module <module> in the initramfs before any other kernel modules are loaded\&. This can be used to ensure a certain device naming, which should in theory be avoided and the use of symbolic links in /dev is encouraged\&.
.RE
.PP
\fB\-\-nocompress\fR
.RS 4
do not compress the resulting image\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
print a help message and exit\&.
.RE
.SH "AVAILABILITY"
.sp
The mkinitrd command is part of the dracut package and is available from \m[blue]\fBhttps://dracut\&.wiki\&.kernel\&.org\fR\m[]
.SH "AUTHORS"
.sp
Harald Hoyer
.SH "SEE ALSO"
.sp
\fBdracut\fR(8)