]>
Commit | Line | Data |
---|---|---|
14228c0d | 1 | '\" t |
f47781d8 | 2 | .TH "SYSTEMD\-GETTY\-GENERATOR" "8" "" "systemd 218" "systemd-getty-generator" |
14228c0d MB |
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-getty-generator \- Generator for enabling getty instances on the console | |
24 | .SH "SYNOPSIS" | |
25 | .PP | |
26 | /usr/lib/systemd/system\-generators/systemd\-getty\-generator | |
27 | .SH "DESCRIPTION" | |
28 | .PP | |
29 | systemd\-getty\-generator | |
30 | is a generator that automatically instantiates | |
31 | serial\-getty@\&.service | |
32 | on the kernel console | |
33 | /dev/console | |
34 | if that is not directed to the virtual console subsystem\&. It will also instantiate | |
35 | serial\-getty@\&.service | |
60f067b4 JS |
36 | instances for virtualizer consoles, if execution in a virtualized environment is detected\&. Finally, it will instantiate |
37 | container\-getty@\&.service | |
38 | instances for additional container pseudo TTYs as requested by the container manager (see | |
39 | \m[blue]\fBContainer Interface\fR\m[]\&\s-2\u[1]\d\s+2)\&. This should ensure that the user is shown a login prompt at the right place, regardless of which environment the system is started in\&. For example, it is sufficient to redirect the kernel console with a kernel command line argument such as | |
14228c0d MB |
40 | \fIconsole=\fR |
41 | to get both kernel messages and a getty prompt on a serial TTY\&. See | |
60f067b4 | 42 | \m[blue]\fBkernel\-parameters\&.txt\fR\m[]\&\s-2\u[2]\d\s+2 |
14228c0d MB |
43 | for more information on the |
44 | \fIconsole=\fR | |
45 | kernel parameter\&. | |
46 | .PP | |
47 | systemd\-getty\-generator | |
48 | implements the | |
60f067b4 | 49 | \m[blue]\fBgenerator specification\fR\m[]\&\s-2\u[3]\d\s+2\&. |
14228c0d MB |
50 | .PP |
51 | Further information about configuration of gettys you may find in | |
60f067b4 | 52 | \m[blue]\fBsystemd for Administrators, Part XVI: Gettys on Serial Consoles (and Elsewhere)\fR\m[]\&\s-2\u[4]\d\s+2\&. |
14228c0d MB |
53 | .SH "SEE ALSO" |
54 | .PP | |
55 | \fBsystemd\fR(1), | |
56 | \fBagetty\fR(8) | |
57 | .SH "NOTES" | |
58 | .IP " 1." 4 | |
60f067b4 JS |
59 | Container Interface |
60 | .RS 4 | |
61 | \%http://www.freedesktop.org/wiki/Software/systemd/ContainerInterface/ | |
62 | .RE | |
63 | .IP " 2." 4 | |
14228c0d MB |
64 | kernel-parameters.txt |
65 | .RS 4 | |
66 | \%https://www.kernel.org/doc/Documentation/kernel-parameters.txt | |
67 | .RE | |
60f067b4 | 68 | .IP " 3." 4 |
14228c0d MB |
69 | generator specification |
70 | .RS 4 | |
71 | \%http://www.freedesktop.org/wiki/Software/systemd/Generators | |
72 | .RE | |
60f067b4 | 73 | .IP " 4." 4 |
14228c0d MB |
74 | systemd for Administrators, Part XVI: Gettys on Serial Consoles (and Elsewhere) |
75 | .RS 4 | |
76 | \%http://0pointer.de/blog/projects/serial-console.html | |
77 | .RE |