summaryrefslogtreecommitdiffstats
path: root/update-initramfs.8
blob: acbbf3ce8c4508c1c08b0192122dca9bddbda746 (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 UPDATE-INITRAMFS 8  "2014/10/16" "initramfs\-tools" "System Administration"

.SH NAME
update\-initramfs \- generate an initramfs image

.SH SYNOPSIS
.B update\-initramfs
.RB { \-c | \-d | \-u }
.RB [ \-k
.IR version ]
.RB [ \-v ]
.RB [ \-b
.IR directory ]
.br
.BR update\-initramfs " " \-h
.SH DESCRIPTION
The
.B update\-initramfs
script manages your initramfs images on your local box.
It keeps track of the existing initramfs archives in /boot.
There are three modes of operation create, update or delete.
You must at least specify one of those modes.

The initramfs is a gzipped cpio archive.
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\-k \fI version
Set the specific kernel version for whom the initramfs will be generated.
For example the output of uname \-r for your currently running kernel.
This argument is optional for update. The default is the latest kernel version.

The use of "all" for the
.I version
string specifies
.B update\-initramfs
to execute the chosen action for all installed kernel versions that already
have an initramfs.

.TP
\fB\-c
This mode creates a new initramfs.

.TP
\fB\-u
This mode updates an existing initramfs.

.TP
\fB\-d
This mode removes an existing initramfs.

.TP
\fB\-v
This option increases the amount of information you are given during
the chosen action.

.TP
\fB\-b \fI directory
Set an different bootdir for the image creation.

.TP
\fB\-h\fR, \fB--help\fR
Print a short help page describing the available options in
.B update\-initramfs.

.SH EXAMPLES

Update the initramfs of the newest kernel:

.PP
.B update\-initramfs -u


Create the initramfs for a specific kernel:

.PP
.B update\-initramfs -c -k 2.6.18-1-686

.SH FILES
/etc/initramfs-tools/update-initramfs.conf

.SH AUTHOR
The initramfs-tools are written by Maximilian Attems <maks@debian.org>,
Jeff Bailey <jbailey@raspberryginger.com> and numerous others.

.SH SEE ALSO
.BR
.IR initramfs.conf (5),
.IR initramfs-tools (7),
.IR mkinitramfs (8),
.IR lsinitramfs (8).