SYSTEMD-SSH-ISSUE(1)

💖 SYSTEMD-SSH-ISSUE(1) 💖

okay bestie, so this is systemd-ssh-issue — the little generator for SSH login prompt drop-ins, part of the systemd fam (manual section 1, the user commands girlies 🎀). she's small, she's focused, and she's literally just here to make your login prompt tell people how to SSH into you over AF_VSOCK. no cap.

---

✨ SYNOPSIS ✨

/usr/lib/systemd/systemd-ssh-issue [OPTIONS...] make-vsock

/usr/lib/systemd/systemd-ssh-issue [OPTIONS...] rm-vsock

---

🦋 DESCRIPTION 🦋

okay so picture this: systemd-ssh-issue is a tiny tool with exactly two moods 💅

• call it with make-vsock and she generates a drop-in file
• call it with rm-vsock and she removes it

the file in question is /run/issue.d/50-ssh-vsock.issue, and she only does any of this if AF_VSOCK support is available in the kernel and the VM environment. like, if the vibe check fails, there's nothing to do, iykyk.

what's inside the file? brief info about how to contact the local system via SSH-over-AF_VSOCK — and most importantly it reports the system's AF_VSOCK CID ✨ so people can actually reach you.

that file is typically read and displayed by agetty(8) on console or serial login prompts. so it's the little message you see before you log in. main character energy, honestly 👑

and the tea: this tool is automatically used by systemd-ssh-generator(8) in the AF_VSOCK socket units it generates. so you probably don't even need to call her yourself — she's out here working behind the scenes 🫶

---

🌸 OPTIONS 🌸

here's everything she understands, bestie:

• --issue-path= — changes the path to the issue file to write to/remove. if you don't specify it, it defaults to /run/issue.d/50-ssh-vsock.issue. and if you pass it as an empty string or -, she writes the issue file contents to standard output instead 🖨️

✨ Added in version 258.

• -h, --help — print a short help text and exit. your girl is helpful like that 💖
• --version — print a short version string and exit. quick lil flex ⭐

---

💀 EXIT STATUS 💀

on success, 0 is returned — slay. a non-zero failure code otherwise 😭 (not slay, but we move).

---

🌈 SEE ALSO 🌈

go read these when you're done, fr fr:

systemd(1), systemd-ssh-generator(8), vsock(7), ssh(1), sshd(8), agetty(8)

---

k bye ily, this was systemd version 262.1 writing to you from the SYSTEMD-SSH-ISSUE(1) page 🧚💜 mwah 💅