OS Manuals

systemd-ssh-issue(1)

SYSTEMD-SSH-ISSUE(1) systemd-ssh-issue SYSTEMD-SSH-ISSUE(1)


.SH "NAME" systemd-ssh-issue - Generator for SSH login prompt drop-ins


.SH "SYNOPSIS"


.HP 840u


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


.HP 840u


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


.SH "DESCRIPTION"


.PP systemd-ssh-issue is a small tool that generates (when called with make-vsock) and removes (when called with rm-vsock) a /run/issue.d/50-ssh-vsock.issue drop-in file in case AF_VSOCK support is available in the kernel and the VM environment. The file contains brief information about how to contact the local system via SSH-over-AF_VSOCK, in particular it reports the system's AF_VSOCK CID. The file is typically read and displayed by agetty(8) on console or serial login prompts.


.PP This tool is automatically used by systemd-ssh-generator(8) in the AF_VSOCK socket units it generates.


.SH "OPTIONS"


.PP The following options are understood:


.PP --issue-path=


Changes the path to the issue file to write to/remove. If not specified, defaults to /run/issue.d/50-ssh-vsock.issue. If specified as empty string or - writes the issue file contents to standard output.


Added in version 258.


.RE


.PP -h, --help


Print a short help text and exit.


.RE
.PP --version


Print a short version string and exit.


.RE


.SH "EXIT STATUS"


.PP On success, 0 is returned, a non-zero failure code otherwise.


.SH "SEE ALSO"


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

systemd 262.2

systemd 262.2-r1 · os · ingested 2026-11-06