1SYSTEMD-GETTY-GENERATOR(8) systemd-getty-generator SYSTEMD-GETTY-GENERATOR(8)
2
3
4
6 systemd-getty-generator - Generator for enabling getty instances on the
7 console
8
10 /usr/lib/systemd/system-generators/systemd-getty-generator
11
13 systemd-getty-generator is a generator that automatically instantiates
14 serial-getty@.service on the kernel consoles, if they can function as
15 ttys and are not provided by the virtual console subsystem. It will
16 also instantiate serial-getty@.service instances for virtualizer
17 consoles, if execution in a virtualized environment is detected. If
18 execution in a container environment is detected, it will instead
19 enable console-getty.service for /dev/console, and
20 container-getty@.service instances for additional container pseudo TTYs
21 as requested by the container manager (see Container Interface[1]).
22 This should ensure that the user is shown a login prompt at the right
23 place, regardless of which environment the system is started in. For
24 example, it is sufficient to redirect the kernel console with a kernel
25 command line argument such as console= to get both kernel messages and
26 a getty prompt on a serial TTY. See The kernel's command-line
27 parameters[2] for more information on the console= kernel parameter.
28
29 systemd-getty-generator implements systemd.generator(7).
30
31 Further information about configuration of gettys can be found in
32 systemd for Administrators, Part XVI: Gettys on Serial Consoles (and
33 Elsewhere)[3].
34
36 systemd-getty-generator understands the following kernel-command-
37 line(7) parameters:
38
39 systemd.getty_auto=
40 this options take an optional boolean argument, and default to yes.
41 The generator is enabled by default, and a false value may be used
42 to disable it.
43
45 $SYSTEMD_GETTY_AUTO
46 This variable takes an optional boolean argument, and default to
47 yes. The generator is enabled by default, and a false value may be
48 used to disable it.
49
51 getty.ttys.serial, getty.ttys.container
52 These system credentials may be used to spawn additional login
53 prompts on selected TTYs. The two credentials should contain a
54 newline-separated list of TTY names to spawn instances of
55 serial-getty@.service (in case of getty.ttys.serial) and
56 container-getty@.service (in case of getty.ttys.container) on.
57
59 systemd(1), kernel-command-line(7), systemd.system-credentials(7),
60 agetty(8)
61
63 1. Container
64 Interface
65 https://systemd.io/CONTAINER_INTERFACE
66
67 2. The kernel's command-line parameters
68 https://docs.kernel.org/admin-guide/kernel-parameters.html
69
70 3. systemd for Administrators, Part XVI: Gettys on Serial Consoles
71 (and Elsewhere)
72 https://0pointer.de/blog/projects/serial-console.html
73
74
75
76systemd 254 SYSTEMD-GETTY-GENERATOR(8)