update-tirfs(8)

update-tirfs8

Generate a tiny-initramfs image

Usage

update-tirfs [-k kernel-version]

Overview

The update-tirfs script generates initramfs images that contains the tiny-initramfs init binary and place them in the standard Debian location so that the boot loader may find them. It will call mktirfs(8) to create the actual image. When called, all initramfs images in /boot for matching kernel versions will be replaced.

Please read /usr/share/doc/tiny-initramfs-core/README.md for an overview of the use cases tiny-initramfs was designed for and the features it supports.

Options

-k, --kernel-version=kernel-version

Which kernel version to generate the initramfs image for. By default, the special value all is assumed, which indicates that the initramfs image should be regenerated for all installed kernel versions.

Configuration

If present, the configuration file /etc/tiny-initramfs/tiny-initramfs.conf can modify the behavior of mktirfs(8) in how the initramfs image is constructed. Please refer to the documentation of the mktirfs utility for details.

Examples

Update all initramfs images:
        update-tirfs
Update the initramfs image for a specific kernel version:
        update-tirfs -k 4.2.0

Debian maintainer scripts

Please do not call this utility from Debian maintainer scripts. Use the update-initramfs trigger instead, as that will not depend on the initramfs implementation.

Files

/etc/tiny-initramfs/tiny-initramfs.conf

If present, values in there will be used as defaults for the command line arguments of mktirfs.

/usr/share/doc/tiny-initramfs-core/tiny-initramfs.conf.example

An example configuration file that may be copied to the above location.

Releases

Unchanged in 5 releases since Debian 9 (Stretch).

  1. 9–13

Authors

Christian Seiler <[email protected]>

From tiny-initramfs 0.1-6.1 in Debian 13 (Trixie). Parsed by carta from the page's man source.