2010-02-25 04:07:57 +01:00
|
|
|
.TH UPDATE-INITRAMFS 8 "2010/02/25" "Linux" "update\-initramfs manual"
|
2009-10-09 03:11:09 +02:00
|
|
|
|
|
|
|
.SH NAME
|
|
|
|
update\-initramfs \- generate an initramfs image
|
|
|
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B update\-initramfs
|
|
|
|
.RB \-c | \-d | \-u
|
|
|
|
.RB [ \-k
|
|
|
|
.IR version ]
|
|
|
|
.RB [ \-t ]
|
|
|
|
.RB [ \-v ]
|
2010-02-25 04:07:57 +01:00
|
|
|
.RB [ \-V ]
|
2009-10-09 03:11:09 +02:00
|
|
|
.RB [ \-b ]
|
2010-02-25 04:07:57 +01:00
|
|
|
.RB [ \-B ]
|
2009-10-09 03:11:09 +02:00
|
|
|
.RB [ \-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 kernel versions, that are already known
|
|
|
|
to
|
|
|
|
.B update\-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 \-t
|
|
|
|
Allows to take over an custom initramfs with a newer one.
|
|
|
|
|
|
|
|
.TP
|
|
|
|
\fB \-v
|
|
|
|
This option increases the amount of information you are given during
|
|
|
|
the chosen action.
|
|
|
|
|
2010-02-25 04:07:57 +01:00
|
|
|
.TP
|
|
|
|
\fB \-V
|
|
|
|
Prints the current initramfs-tools version.
|
|
|
|
|
2009-10-09 03:11:09 +02:00
|
|
|
.TP
|
|
|
|
\fB \-b
|
|
|
|
Set an different bootdir for the image creation.
|
|
|
|
|
2010-02-25 04:07:57 +01:00
|
|
|
.TP
|
|
|
|
\fB \-B
|
|
|
|
Do not update the boot configuration file (grub.cfg for grub2) after
|
|
|
|
building successfully the initramfs.
|
|
|
|
|
2009-10-09 03:11:09 +02:00
|
|
|
.TP
|
|
|
|
\fB \-h
|
|
|
|
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
|
2010-02-25 04:07:57 +01:00
|
|
|
The initramfs-tools available in XBPS are maintained by
|
|
|
|
Juan Romero Pardines <xtraeme@gmail.com>, they diverged substantially
|
|
|
|
from the original implementation comming from Debian.
|
|
|
|
|
|
|
|
The initramfs-tools from Debian are written by Maximilian Attems <maks@debian.org>,
|
2009-10-09 03:11:09 +02:00
|
|
|
Jeff Bailey <jbailey@raspberryginger.com> and numerous others.
|
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
.BR
|
|
|
|
.IR initramfs.conf (5),
|
|
|
|
.IR initramfs-tools (8),
|
|
|
|
.IR mkinitramfs (8).
|