summaryrefslogtreecommitdiff
path: root/mkinitramfs.8
blob: 79ce777410da12a859a6e13545c967ff1e842068 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
.TH MKINITRAMFS 8  "$Date: 2005/12/06 $" "" "mkinitramfs manual"

.SH NAME
mkinitramfs \- generate an initramfs image

.SH SYNOPSIS
.B mkinitramfs
.RB [ \-d 
.IR confdir ] 
.RB [ \-k ] 
.RB [ \-o 
.IR outfile ] 
.RB [ \-r 
.IR root ] 
.RI [ version ]
.B mkinitramfs
.RB [ \-\-supported-host-version=
.IR hversion ]
.RB [ \-\-supported-target-version=
.IR tversion ]

.SH DESCRIPTION
The
.B mkinitramfs 
script generates an initramfs image.
The initramfs is an cpio archive. The archive can be used on a different
box of the same arch with the corresponding Linux kernel.
.B mkinitramfs
is meant for advanced usage. On your local box 
.B update-initramfs
should do all necessary steps.

At boot time, the kernel unpacks that archive into ram disk, mounts and 
uses it as initial root file system. All finding of the root device 
happens in this early userspace.

.SH OPTIONS
.TP
\fB \-d \fI confdir
Set an alternate configuration directory.

.TP
\fB \-k
Keep the temporary directory used to make the image.

.TP
\fB \-o \fI outfile
Write the image to 
.IR outfile .

.TP
\fB \-r \fI root
Override the 
.B ROOT 
setting in 
.IR mkinitramfs.conf .

.TP
\fB\-\-supported-host-version=\fIhversion
This option queries if mkinitramfs can create ramdisks on a running kernel of version
.IR hversion .

.TP
\fB\-\-supported-target-version=\fItversion
This option queries if mkinitramfs can create ramdisks for kernel version
.IR tversion .

.SH FILES
.TP
.I /etc/mkinitramfs/initramfs.conf
The default configuration file for the script. See
.BR initramfs.conf (5)
for a description of the available configuration parameter.

.TP
.I /etc/mkinitramfs/modules
Specified modules will be put in the generated image and loaded when the system boots. The format - one per line - is identical to that of
.I /etc/modules,
which is described in
.BR modules (5).

.TP
.I /etc/mkinitramfs/DSDT.aml
If this file exists, it will be appended to the initramfs in a way that causes
it to be loaded by ACPI.


.SH AUTHOR
The initramfs-tools are written by Jeff Bailey <jbailey@ubuntu.com>.
This manual is maintained by Maximilian Attems <maks@sternwelten.at>.

.SH SEE ALSO

.BR initramfs.conf (5), initramfs-tools (8), update-initramfs (8)