UPDATE-TIRFS(8)

💖 UPDATE-TIRFS 💖

ok so bestie, welcome to the tiny-initramfs corner of the manual, section 8, and today's main character is update-tirfs — the little script that builds you a whole initramfs image. no cap. let's get into it 🎀

---

✨ NAME ✨

update-tirfs — generate a tiny-initramfs image 🦋

---

✨ SYNOPSIS ✨

update-tirfs [-k kernel-version]

that's it. that's the whole vibe. one optional flag, zero drama 💅

---

✨ DESCRIPTION ✨

so like, the update-tirfs script generates initramfs images that contain the tiny-initramfs init binary, and it drops them right into the standard Debian location so your boot loader can actually find them. it doesn't do the heavy lifting itself though — it calls mktirfs(8) to create the actual image, like the bestie that delegates 💁‍♀️

when you call it, all initramfs images in /boot for matching kernel versions get replaced. all of them. gone, replaced, slay ✨

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. fr fr, go read it, it's giving essential context 📖

---

✨ 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. yes, every single one. it's giving thorough 🌈

---

✨ CONFIGURATION ✨

if it exists, the config file /etc/tiny-initramfs/tiny-initramfs.conf can modify the behavior of mktirfs(8) in how the initramfs image is constructed. so it's not update-tirfs that reads it directly — it's mktirfs doing the reading. please refer to the documentation of the mktirfs utility for the details, iykyk 🔍

---

✨ EXAMPLE ✨

update all initramfs images:

update-tirfs

update the initramfs image for a specific kernel version:

update-tirfs -k 4.2.0

see? cute, simple, iconic 👑

---

✨ DEBIAN MAINTAINER SCRIPTS ✨

please do not call this utility from Debian maintainer scripts. use the update-initramfs trigger instead, because that one will not depend on the initramfs implementation. like, it's literally the whole point. don't do it bestie, i'm begging 🙈

---

✨ 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. copy-paste core 🍓

---

✨ SEE ALSO ✨

• mktirfs(8)

---

✨ AUTHORS ✨

Christian Seiler <christian@iwakd.de> — ty for your service king 🫶

---

and that's the whole page, bestie!! this one's from the tiny-initramfs Manual, dated Jan 2016, and you just read the entire thing. no notes. periodt 💜