NAME | SYNOPSIS | DESCRIPTION | KERNEL COMMAND LINE | ENVIRONMENT | SYSTEM CREDENTIALS | SEE ALSO | NOTES | COLOPHON |
|
|
SYSTEMD-...GENERATOR(8) systemd-getty-generator SYSTEMD-...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 [email protected] on the kernel consoles, if they can function as ttys and are not provided by the virtual console subsystem. It will also instantiate [email protected] 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 [email protected] 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. Added in version 250.
$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. Added in version 250.
getty.ttys.serial, getty.ttys.container These system credentials may be used to spawn additional login prompts on selected TTYs. The two credentials should contain a newline-separated list of TTY names to spawn instances of [email protected] (in case of getty.ttys.serial) and [email protected] (in case of getty.ttys.container) on. Added in version 254.
systemd(1), kernel-command-line(7), systemd.system-credentials(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) https://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 2024-06-14. (At that
time, the date of the most recent commit that was found in the
repository was 2024-06-13.) 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
[email protected]
systemd 257~devel SYSTEMD-...GENERATOR(8)
Pages that refer to this page: kernel-command-line(7), systemd.directives(7), systemd.generator(7), systemd.index(7), systemd.system-credentials(7)