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 getty-pre.target
{% if HAVE_SYSV_COMPAT %}
After=rc-local.service
{% endif %}
Before=getty.target

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

[Service]
ExecStart=-{{AGETTY}} --noreset --noclear --issue-file=/etc/issue:/etc/issue.d:/run/issue.d:/usr/lib/issue.d --keep-baud 115200,57600,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
ImportCredential=tty.console.agetty.*:agetty.
ImportCredential=tty.console.login.*:login.
ImportCredential=agetty.*
ImportCredential=login.*
ImportCredential=shell.*

[Install]
WantedBy=getty.target
license: LGPL-2.1+ -> LGPL-2.1-or-later 2020-11-09 13:23:58 +09:00			`# SPDX-License-Identifier: LGPL-2.1-or-later`
Add SPDX license headers to unit files 2017-11-18 17:35:03 +01:00			`#`
container: spawn a getty instead of a sulogin in a container 2012-04-22 02:15:22 +02: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 18:30:56 +01:00			`Documentation=man:agetty(8) man:systemd-getty-generator(8)`
units: order getty units after getty-pre.target unconditionally Those two units had this ordering conditionalized on HAVE_SYSV_COMPAT. This seems strange. 45e27532971ac84e835a2879df510a581f933fcd added the ordering differently for those two files without any comment, and I think it was just pasted or scripted erroneously. 2023-05-19 15:05:30 +02:00			`After=systemd-user-sessions.service plymouth-quit-wait.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 11:55:36 +02:00			`{% if HAVE_SYSV_COMPAT %}`
units: order getty units after getty-pre.target unconditionally Those two units had this ordering conditionalized on HAVE_SYSV_COMPAT. This seems strange. 45e27532971ac84e835a2879df510a581f933fcd added the ordering differently for those two files without any comment, and I think it was just pasted or scripted erroneously. 2023-05-19 15:05:30 +02:00			`After=rc-local.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 11:55:36 +02:00			`{% endif %}`
container: spawn a getty instead of a sulogin in a container 2012-04-22 02:15:22 +02: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 14:43:41 +01: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 02:15:22 +02:00			`[Service]`
units/getty: use /usr/sbin/agetty Same way that we do it for quotaon and debug-shell by going through meson 2025-08-24 14:01:17 +02:00			`ExecStart=-{{AGETTY}} --noreset --noclear --issue-file=/etc/issue:/etc/issue.d:/run/issue.d:/usr/lib/issue.d --keep-baud 115200,57600,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 14:28:00 +02:00			`Type=idle`
container: spawn a getty instead of a sulogin in a container 2012-04-22 02:15:22 +02: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 13:54:31 +01:00			`StandardInput=tty`
			`StandardOutput=tty`
container: spawn a getty instead of a sulogin in a container 2012-04-22 02:15:22 +02: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 11:55:36 +02:00			`{% if not ENABLE_LOGIND %}`
container: spawn a getty instead of a sulogin in a container 2012-04-22 02:15:22 +02: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 11:55:36 +02:00			`{% endif %}`
container: spawn a getty instead of a sulogin in a container 2012-04-22 02:15:22 +02: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 01:54:59 +02:00			`SendSIGHUP=yes`
units: Import tty specific credentials for each getty unit As explained in the previous commit, this allows us to configure agetty and login for individual ttys instead of globally. 2024-07-30 16:22:34 +02:00			`ImportCredential=tty.console.agetty.*:agetty.`
			`ImportCredential=tty.console.login.*:login.`
units: Load agetty credentials in all getty units In it's latest release, agetty will support reading the agetty.autologin and login.noauth credentials, so let's make sure we import those in our getty units so they're available to agetty to read. 2023-07-27 16:50:58 +02:00			`ImportCredential=agetty.*`
			`ImportCredential=login.*`
shell: define three system credentials we can propagate into shell prompts and welcome messages 2024-09-06 16:30:54 +02:00			`ImportCredential=shell.*`
container: spawn a getty instead of a sulogin in a container 2012-04-22 02:15:22 +02:00
			`[Install]`
			`WantedBy=getty.target`