mirror of
https://salsa.debian.org/kernel-team/initramfs-tools.git
synced 2026-01-26 07:37:54 +00:00
We originally unpacked each cpio archive into its own subdirectory for security reasons. Since we are now able to stitch together multiple cpio archives to feed to a single cpio process, that concern no longer applies. We maintained the split up to the release of "trixie" out of concern for possible breakage of callers that relied on this split. Since that release is done, stop splitting and always unpack everything directly into the output directory. Signed-off-by: Ben Hutchings <benh@debian.org>
62 lines
1.3 KiB
Groff
62 lines
1.3 KiB
Groff
.TH UNMKINITRAMFS 8 "2025/03/20" "initramfs\-tools" "System Administration"
|
|
|
|
.SH NAME
|
|
unmkinitramfs \- extract content from an initramfs image
|
|
|
|
.SH SYNOPSIS
|
|
.B unmkinitramfs
|
|
.RB [ -v ]
|
|
.IR initramfs-file " " directory
|
|
.br
|
|
.BR unmkinitramfs " " -h
|
|
|
|
.SH DESCRIPTION
|
|
The
|
|
.B unmkinitramfs
|
|
command extracts the content of a given initramfs image using
|
|
.B cpio
|
|
and the appropriate decompressor command.
|
|
|
|
The initramfs image may be a single compressed cpio archive, or the
|
|
concatenation of any number of uncompressed cpio archives optionally
|
|
followed by a compressed cpio archive.
|
|
|
|
Earlier versions of this command would in some cases unpack an
|
|
initramfs consisting of multiple archives into multiple subdirectories
|
|
of the given directory.
|
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
|
.B -h
|
|
Display usage information and exit.
|
|
|
|
.TP
|
|
.B -v
|
|
Display verbose messages about extraction.
|
|
|
|
|
|
.SH USAGE EXAMPLES
|
|
|
|
Extract initramfs content of current running kernel:
|
|
|
|
.PP
|
|
.B unmkinitramfs /boot/initrd.img-$(uname -r) initramfs/
|
|
|
|
|
|
.SH BUGS
|
|
.BR unmkinitramfs
|
|
does not support initramfs images with more than one compressed cpio
|
|
archive.
|
|
|
|
.SH AUTHOR
|
|
The initramfs-tools are written by Maximilian Attems <maks@debian.org>
|
|
and numerous others.
|
|
|
|
.SH SEE ALSO
|
|
.BR
|
|
.IR initramfs-tools (7),
|
|
.IR lsinitramfs (8),
|
|
.IR mkinitramfs (8),
|
|
.IR update-initramfs (8).
|