Debian Codegraph @

upstream/debian-unstable/man1/systemd-ssh-issue.1

raw
1 '\" t
2 .TH "SYSTEMD\-SSH\-ISSUE" "1" "" "systemd 261~rc3" "systemd-ssh-issue"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-ssh-issue \- Generator for SSH login prompt drop\-ins
24 .SH "SYNOPSIS"
25 .HP \w'\fB/usr/lib/systemd/systemd\-ssh\-issue\fR\ 'u
26 \fB/usr/lib/systemd/systemd\-ssh\-issue\fR [OPTIONS...] make\-vsock
27 .HP \w'\fB/usr/lib/systemd/systemd\-ssh\-issue\fR\ 'u
28 \fB/usr/lib/systemd/systemd\-ssh\-issue\fR [OPTIONS...] rm\-vsock
29 .SH "DESCRIPTION"
30 .PP
31 \fBsystemd\-ssh\-issue\fR
32 is a small tool that generates (when called with
33 \fBmake\-vsock\fR) and removes (when called with
34 \fBrm\-vsock\fR) a
35 /run/issue\&.d/50\-ssh\-vsock\&.issue
36 drop\-in file in case
37 \fBAF_VSOCK\fR
38 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\-\fBAF_VSOCK\fR, in particular it reports the system\*(Aqs
39 \fBAF_VSOCK\fR
40 CID\&. The file is typically read and displayed by
41 \fBagetty\fR(8)
42 on console or serial login prompts\&.
43 .PP
44 This tool is automatically used by
45 \fBsystemd-ssh-generator\fR(8)
46 in the
47 \fBAF_VSOCK\fR
48 socket units it generates\&.
49 .SH "OPTIONS"
50 .PP
51 The following options are understood:
52 .PP
53 \fB\-\-issue\-path=\fR
54 .RS 4
55 Changes the path to the issue file to write to/remove\&. If not specified, defaults to
56 /run/issue\&.d/50\-ssh\-vsock\&.issue\&. If specified as empty string or
57 "\-"
58 writes the issue file contents to standard output\&.
59 .sp
60 Added in version 258\&.
61 .RE
62 .PP
63 \fB\-h\fR, \fB\-\-help\fR
64 .RS 4
65 Print a short help text and exit\&.
66 .RE
67 .PP
68 \fB\-\-version\fR
69 .RS 4
70 Print a short version string and exit\&.
71 .RE
72 .SH "EXIT STATUS"
73 .PP
74 On success, 0 is returned, a non\-zero failure code otherwise\&.
75 .SH "SEE ALSO"
76 .PP
77 \fBsystemd\fR(1), \fBsystemd-ssh-generator\fR(8), \fBvsock\fR(7), \fBssh\fR(1), \fBsshd\fR(8), \fBagetty\fR(8)