systemd-getty-generator(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | KERNEL COMMAND LINE | ENVIRONMENT | SEE ALSO | NOTES | COLOPHON

SYSTEMD-GETTY-GENERATOR(8)ystemd-getty-generatorSTEMD-GETTY-GENERATOR(8)

NAME         top

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

SYNOPSIS         top

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

DESCRIPTION         top

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

KERNEL COMMAND LINE         top

       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.

ENVIRONMENT         top

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

SEE ALSO         top

       systemd(1), kernel-command-line(7), agetty(8)

NOTES         top

        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

COLOPHON         top

       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 2023-06-23.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2023-06-23.)  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 253                                   SYSTEMD-GETTY-GENERATOR(8)

Pages that refer to this page: kernel-command-line(7)systemd.directives(7)systemd.generator(7)systemd.index(7)