|
NAME | SYNOPSIS | DESCRIPTION | KERNEL COMMAND LINE | ENVIRONMENT | SEE ALSO | NOTES | COLOPHON |
|
|
|
SYSTEMD-GETTY-GENERATOR(8)ystemd-getty-generatorSTEMD-GETTY-GENERATOR(8)
systemd-getty-generator - Generator for enabling getty instances
on the console
/usr/lib/systemd/system-generators/systemd-getty-generator
systemd-getty-generator is a generator that automatically
instantiates serial-getty@.service on the kernel consoles, if
they can function as ttys and are not provided by the virtual
console subsystem. It will also instantiate serial-getty@.service
instances for virtualizer consoles, if execution in a virtualized
environment is detected. If execution in a container environment
is detected, it will instead enable console-getty.service for
/dev/console, and container-getty@.service instances for
additional container pseudo TTYs as requested by the container
manager (see Container Interface[1]). 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 console= to get both kernel messages and a
getty prompt on a serial TTY. See The kernel's command-line
parameters[2] for more information on the console= kernel
parameter.
systemd-getty-generator implements systemd.generator(7).
Further information about configuration of gettys can be found in
systemd for Administrators, Part XVI: Gettys on Serial Consoles
(and Elsewhere)[3].
systemd-getty-generator understands the following
kernel-command-line(7) parameters:
systemd.getty_auto=
this options take an optional boolean argument, and default
to yes. The generator is enabled by default, and a false
value may be used to disable it.
$SYSTEMD_GETTY_AUTO
This variable takes an optional boolean argument, and default
to yes. The generator is enabled by default, and a false
value may be used to disable it.
systemd(1), kernel-command-line(7), agetty(8)
1. Container
Interface
https://systemd.io/CONTAINER_INTERFACE
2. The kernel's command-line parameters
https://docs.kernel.org/admin-guide/kernel-parameters.html
3. systemd for Administrators, Part XVI: Gettys on Serial
Consoles (and Elsewhere)
http://0pointer.de/blog/projects/serial-console.html
This page is part of the systemd (systemd system and service
manager) project. Information about the project can be found at
⟨http://www.freedesktop.org/wiki/Software/systemd⟩. If you have
a bug report for this manual page, see
⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.
This page was obtained from the project's upstream Git repository
⟨https://github.com/systemd/systemd.git⟩ on 2022-12-17. (At that
time, the date of the most recent commit that was found in the
repository was 2022-12-16.) If you discover any rendering
problems in this HTML version of the page, or you believe there
is a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
man-pages@man7.org
systemd 252 SYSTEMD-GETTY-GENERATOR(8)
Pages that refer to this page: kernel-command-line(7), systemd.directives(7), systemd.generator(7), systemd.index(7)