systemd/units/console-getty.service.m4

#  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
m4_ifdef(`HAVE_SYSV_COMPAT',
After=rc-local.service getty-pre.target
)m4_dnl
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 console 115200,38400,9600 $TERM
Type=idle
Restart=always
UtmpIdentifier=cons
TTYPath=/dev/console
TTYReset=yes
TTYVHangup=yes
m4_ifdef(`ENABLE_LOGIND',,
KillMode=process
)m4_dnl
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`
units: drop distro specific stuff from units Since rc-local is now enabled via the SysV compatibility we should only refer to it based on that too. 2013-01-05 01:36:48 +04:00			m4_ifdef(`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`
container: spawn a getty instead of a sulogin in a container 2012-04-22 04:15:22 +04:00			`)m4_dnl`
			`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.`
			`ExecStart=-/sbin/agetty -o '-p -- \\u' --noclear --keep-baud console 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`
			`TTYPath=/dev/console`
			`TTYReset=yes`
			`TTYVHangup=yes`
units: remove KillMode=process in our regular gettys In our regular gettys the actual shell commands live the the session scope anyway (as long as logind is used). Hence, let's avoid KillMode=process, it serves no purpose and is simply unsafe since it disables systemd's own process lifecycle management. 2020-05-26 15:12:56 +03:00			m4_ifdef(`ENABLE_LOGIND',,
container: spawn a getty instead of a sulogin in a container 2012-04-22 04:15:22 +04:00			`KillMode=process`
units: remove KillMode=process in our regular gettys In our regular gettys the actual shell commands live the the session scope anyway (as long as logind is used). Hence, let's avoid KillMode=process, it serves no purpose and is simply unsafe since it disables systemd's own process lifecycle management. 2020-05-26 15:12:56 +03:00			`)m4_dnl`
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`