1SYSTEMD-GETTY-GENERATOR(8)  systemd-getty-generator SYSTEMD-GETTY-GENERATOR(8)
2
3
4

NAME

6       systemd-getty-generator - Generator for enabling getty instances on the
7       console
8

SYNOPSIS

10       /usr/lib/systemd/system-generators/systemd-getty-generator
11

DESCRIPTION

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

KERNEL COMMAND LINE

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

ENVIRONMENT

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

SYSTEM CREDENTIALS

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

SEE ALSO

59       systemd(1), kernel-command-line(7), systemd.system-credentials(7),
60       agetty(8)
61

NOTES

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)
Impressum