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 systemd(1), kernel-command-line(7), agetty(8)
52
54 1. Container
55 Interface
56 https://systemd.io/CONTAINER_INTERFACE
57
58 2. The kernel's command-line parameters
59 https://docs.kernel.org/admin-guide/kernel-parameters.html
60
61 3. systemd for Administrators, Part XVI: Gettys on Serial Consoles
62 (and Elsewhere)
63 https://0pointer.de/blog/projects/serial-console.html
64
65
66
67systemd 253 SYSTEMD-GETTY-GENERATOR(8)