initramfs-tools/unmkinitramfs.8
Ben Hutchings 810421833a unmkinitramfs: Stop splitting into "early" and "main" subdirectories
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>
2025-04-22 03:10:23 +02:00

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).