systemd-getty-generator (original) (raw)

Name

systemd-getty-generator — Generator for enabling getty instances on the console

Synopsis

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

Description¶

systemd-getty-generator is a generator that automatically instantiatesserial-getty@.service on the kernel consoles, if they can function as ttys and are not provided by the virtual console subsystem. It will also instantiateserial-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, andcontainer-getty@.service instances for additional container pseudo TTYs as requested by the container manager (see Container Interface). 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 for more information on the console= kernel parameter.

systemd-getty-generator implementssystemd.generator(7).

Further information about configuration of gettys can be found insystemd for Administrators, Part XVI: Gettys on Serial Consoles (and Elsewhere).

Kernel Command Line¶

systemd-getty-generator understands the followingkernel-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.

Environment¶

$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.

System Credentials¶

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 ofserial-getty@.service (in case of getty.ttys.serial) andcontainer-getty@.service (in case of getty.ttys.container) on.

Added in version 254.