systemd/units/console-getty.service.in

#  SPDX-License-Identifier: LGPL-2.1-or-later
#
#  This file is part of systemd.
#
#  systemd is free software; you can redistribute it and/or modify it
#  under the terms of the GNU Lesser General Public License as published by
#  the Free Software Foundation; either version 2.1 of the License, or
#  (at your option) any later version.

[Unit]
Description=Console Getty
Documentation=man:agetty(8) man:systemd-getty-generator(8)
After=systemd-user-sessions.service plymouth-quit-wait.service
{% if HAVE_SYSV_COMPAT %}
After=rc-local.service getty-pre.target
{% endif %}
Before=getty.target

# OCI containers may be run without a console
ConditionPathExists=/dev/console

[Service]
# The '-o' option value tells agetty to replace 'login' arguments with an
# option to preserve environment (-p), followed by '--' for safety, and then
# the entered username.
ExecStart=-/sbin/agetty -o '-p -- \\u' --noclear --keep-baud - 115200,38400,9600 $TERM
Type=idle
Restart=always
UtmpIdentifier=cons
StandardInput=tty
StandardOutput=tty
TTYPath=/dev/console
TTYReset=yes
TTYVHangup=yes
{% if not ENABLE_LOGIND %}
KillMode=process
{% endif %}
IgnoreSIGPIPE=no
SendSIGHUP=yes

[Install]
WantedBy=getty.target
license: LGPL-2.1+ -> LGPL-2.1-or-later 2020-11-09 07:23:58 +03:00			`# SPDX-License-Identifier: LGPL-2.1-or-later`
Add SPDX license headers to unit files 2017-11-18 19:35:03 +03:00			`#`
container: spawn a getty instead of a sulogin in a container 2012-04-22 04:15:22 +04:00			`# This file is part of systemd.`
			`#`
			`# systemd is free software; you can redistribute it and/or modify it`
			`# under the terms of the GNU Lesser General Public License as published by`
			`# the Free Software Foundation; either version 2.1 of the License, or`
			`# (at your option) any later version.`

			`[Unit]`
			`Description=Console Getty`
man/systemd-getty-generator fix/update * Containers don't use serial-getty@console.service, they use console-getty.service instead, and suppress scanning for kernel or virtualizer consoles. * Nowadays gettys are started on all configured kernel consoles. * except for the line printer console, because that's not a tty. (Seriously. Search CONFIG_LP_CONSOLE). 2017-08-07 20:30:56 +03:00			`Documentation=man:agetty(8) man:systemd-getty-generator(8)`
container: spawn a getty instead of a sulogin in a container 2012-04-22 04:15:22 +04:00			`After=systemd-user-sessions.service plymouth-quit-wait.service`
meson: use jinja2 for unit templates We don't need two (and half) templating systems anymore, yay! I'm keeping the changes minimal, to make the diff manageable. Some enhancements due to a better templating system might be possible in the future. For handling of '## ' — see the next commit. 2021-05-16 12:55:36 +03:00			`{% if HAVE_SYSV_COMPAT %}`
units: order container and console getty units after getty-pre.target 2017-09-05 15:53:25 +03:00			`After=rc-local.service getty-pre.target`
meson: use jinja2 for unit templates We don't need two (and half) templating systems anymore, yay! I'm keeping the changes minimal, to make the diff manageable. Some enhancements due to a better templating system might be possible in the future. For handling of '## ' — see the next commit. 2021-05-16 12:55:36 +03:00			`{% endif %}`
container: spawn a getty instead of a sulogin in a container 2012-04-22 04:15:22 +04:00			`Before=getty.target`

units/console-getty.service: comment reason for ConditionPathExists Currently we have 4 getty services. 1 has a BindsTo dependency on a device unit. 3 have ConditionPathExists, but the reason is different in every single one. * Add comment to console-getty@.service (see commit 1b41981d) * getty@.service is already commented * container-getty.service is not strictly correct, as I realized while trying to compose a comment. Reported as #6584. 2017-08-09 16:43:41 +03:00			`# OCI containers may be run without a console`
			`ConditionPathExists=/dev/console`

container: spawn a getty instead of a sulogin in a container 2012-04-22 04:15:22 +04:00			`[Service]`
units: Tell login to preserve environment (#6023) Make agetty started by getty units pass '-p' option to "login", so it doesn't clear the environment and passes whatever was setup by systemd to shells. This is needed especially for programs which are specified as user shells, but won't read locale settings from anywhere but environment. [zj: cherry-pick just the second patch from the series, see discussion on the pull request.] 2017-05-24 14:58:01 +03:00			`# The '-o' option value tells agetty to replace 'login' arguments with an`
			`# option to preserve environment (-p), followed by '--' for safety, and then`
			`# the entered username.`
getty: Pass tty to use by agetty via stdin If the tty arg is set to "-", agetty uses the stdin fd as the tty. Let's pass the tty this way so that we keep an fd open to the tty at all times. If all fd's to a tty are closed, the kernel might reset the tty which we want to avoid. 2021-10-29 15:54:31 +03:00			`ExecStart=-/sbin/agetty -o '-p -- \\u' --noclear --keep-baud - 115200,38400,9600 $TERM`
service: introduce Type=idle and use it for gettys Type=idle is much like Type=simple, however between the fork() and the exec() in the child we wait until PID 1 informs us that no jobs are left. This is mostly a cosmetic fix to make gettys appear only after all boot output is finished and complete. Note that this does not impact the normal job logic as we do not delay the completion of any jobs. We just delay the invocation of the actual binary, and only for services that otherwise would be of Type=simple. 2012-04-24 16:28:00 +04:00			`Type=idle`
container: spawn a getty instead of a sulogin in a container 2012-04-22 04:15:22 +04:00			`Restart=always`
			`UtmpIdentifier=cons`
getty: Pass tty to use by agetty via stdin If the tty arg is set to "-", agetty uses the stdin fd as the tty. Let's pass the tty this way so that we keep an fd open to the tty at all times. If all fd's to a tty are closed, the kernel might reset the tty which we want to avoid. 2021-10-29 15:54:31 +03:00			`StandardInput=tty`
			`StandardOutput=tty`
container: spawn a getty instead of a sulogin in a container 2012-04-22 04:15:22 +04:00			`TTYPath=/dev/console`
			`TTYReset=yes`
			`TTYVHangup=yes`
meson: use jinja2 for unit templates We don't need two (and half) templating systems anymore, yay! I'm keeping the changes minimal, to make the diff manageable. Some enhancements due to a better templating system might be possible in the future. For handling of '## ' — see the next commit. 2021-05-16 12:55:36 +03:00			`{% if not ENABLE_LOGIND %}`
container: spawn a getty instead of a sulogin in a container 2012-04-22 04:15:22 +04:00			`KillMode=process`
meson: use jinja2 for unit templates We don't need two (and half) templating systems anymore, yay! I'm keeping the changes minimal, to make the diff manageable. Some enhancements due to a better templating system might be possible in the future. For handling of '## ' — see the next commit. 2021-05-16 12:55:36 +03:00			`{% endif %}`
container: spawn a getty instead of a sulogin in a container 2012-04-22 04:15:22 +04:00			`IgnoreSIGPIPE=no`
core: optionally send SIGHUP in addition to the configured kill signal This is useful to fake session ends for processes like shells. 2013-07-30 03:54:59 +04:00			`SendSIGHUP=yes`
container: spawn a getty instead of a sulogin in a container 2012-04-22 04:15:22 +04:00
			`[Install]`
			`WantedBy=getty.target`