man7.org > Linux > man-pages

Linux/UNIX system programming training

systemd-ssh-issue(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | SEE ALSO | COLOPHON 

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

NAME         top

       systemd-ssh-issue - Generator for SSH login prompt drop-ins

SYNOPSIS         top


       /usr/lib/systemd/systemd-ssh-issue
                                                                                                    --make-vsock/usr/lib/systemd/systemd-ssh-issue
                                                                                                    --rm-vsock

DESCRIPTION         top

       systemd-ssh-issue is a small tool that generates 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.

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

OPTIONS         top

       The following options are understood:

       --make-vsock
           Generates the issue file. This command has no effect if called
           on systems lacking AF_VSOCK support.

           Added in version 258.

       --rm-vsock
           Removes the issue file if it exists.

           Added in version 258.

       --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.

       -h, --help
           Print a short help text and exit.

       --version
           Print a short version string and exit.

EXIT STATUS         top

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

SEE ALSO         top

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

COLOPHON         top

       This page is part of the systemd (systemd system and service
       manager) project.  Information about the project can be found at
       ⟨http://www.freedesktop.org/wiki/Software/systemd⟩.  If you have a
       bug report for this manual page, see
       ⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/systemd/systemd.git⟩ on 2025-08-11.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2025-08-11.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

systemd 258~rc2                                      SYSTEMD-SSH-ISSUE(1)

Pages that refer to this page: systemd.directives(7),  systemd.index(7)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI