SYSTEMD-BSOD.SERVICE(8)

💙 SYSTEMD-BSOD.SERVICE(8) — the systemd-bsod manual, bestie edition

okay so bestie, gather round, because we're talking about systemd-bsod — the systemd manual page that lives at section 8, iykyk. it's giving "your boot went sideways and we're gonna tell you about it in the most dramatic way possible." let's get into it 💅

---

✨ NAME ✨

systemd-bsod.service, systemd-bsod — literally just here to display a boot-time emergency log message in full screen. that's the whole job. icon behavior fr fr 🫶

---

🌸 SYNOPSIS 🌸

systemd-bsod.service

/usr/lib/systemd/systemd-bsod [OPTIONS...]

so you can either poke the unit, or call the binary directly with some options. choose your own adventure, babe ✨

---

🦋 DESCRIPTION 🦋

systemd-bsod.service is the moment your boot said "no ❤️" and now the whole screen is blue. it displays a blue screen containing a message all about the boot failure, and — this is the iconic part — it includes a QR code 🎀 that you can scan to get helpful information about the failure. yes, your crash now has a scannable glow-up. no cap.

---

👑 OPTIONS 👑

here's everything systemd-bsod understands, no skips, no cap:

• -h, --help — prints a short help text and then dips out. that's it, that's the vibe.
• --version — prints a short version string and exits. quick lil flex of which version you're running.
• -c, --continuous — when you specify this, systemd-bsod waits continuously for changes in the journal if it doesn't find any emergency messages on the initial attempt. so it doesn't just give up after one peek — it keeps watching. main character energy, honestly. 💖

Added in version 255.

• --tty= — specify the TTY to output to. by default, systemd-bsod will automatically find a free VT to display the message on. but if you specify this option, a TTY may be selected explicitly. and yes, pro tip incoming: use --tty=/dev/tty to direct output to the terminal the command is invoked on. 🌈

Added in version 256.

---

💀 EXIT STATUS 💀

on success — meaning the journal message got displayed successfully — 0 is returned. literally slaying. ✨

otherwise? a non-zero failure code. so if it's not 0, something's up and the vibe check failed. 😭

---

🔥 SEE ALSO 🔥

• systemd(1) — go read the big one, bestie, it knows everything about everything 💜

---

okay that's the whole page, you ate that. we were reading from systemd 262.1 — version of the manual, dated whenever this shipped, and honestly? iconic. go forth and read your blue screens with confidence. mwah 🫶💅🎀