systemd/units/serial-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=Serial Getty on %I
Documentation=man:agetty(8) man:systemd-getty-generator(8)
Documentation=http://0pointer.de/blog/projects/serial-console.html
BindsTo=dev-%i.device
After=dev-%i.device systemd-user-sessions.service plymouth-quit-wait.service getty-pre.target
m4_ifdef(`HAVE_SYSV_COMPAT',
After=rc-local.service
)m4_dnl

# If additional gettys are spawned during boot then we should make
# sure that this is synchronized before getty.target, even though
# getty.target didn't actually pull it in.
Before=getty.target
IgnoreOnIsolate=yes

# IgnoreOnIsolate causes issues with sulogin, if someone isolates
# rescue.target or starts rescue.service from multi-user.target or
# graphical.target.
Conflicts=rescue.service
Before=rescue.service

[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' --keep-baud 115200,57600,38400,9600 %I $TERM
Type=idle
Restart=always
UtmpIdentifier=%I
TTYPath=/dev/%I
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 12:23:58 +08:00			`# SPDX-License-Identifier: LGPL-2.1-or-later`
Add SPDX license headers to unit files 2017-11-19 00:35:03 +08:00			`#`
serial: use seperate getty template for serial ttys 2010-08-25 09:09:57 +08:00			`# This file is part of systemd.`
			`#`
			`# systemd is free software; you can redistribute it and/or modify it`
relicense to LGPLv2.1 (with exceptions) We finally got the OK from all contributors with non-trivial commits to relicense systemd from GPL2+ to LGPL2.1+. Some udev bits continue to be GPL2+ for now, but we are looking into relicensing them too, to allow free copy/paste of all code within systemd. The bits that used to be MIT continue to be MIT. The big benefit of the relicensing is that closed source code may now link against libsystemd-login.so and friends. 2012-04-12 06:20:58 +08:00			`# 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`
serial: use seperate getty template for serial ttys 2010-08-25 09:09:57 +08:00			`# (at your option) any later version.`

			`[Unit]`
			`Description=Serial Getty on %I`
man: document systemd-update-generator 2012-06-27 21:12:29 +08:00			`Documentation=man:agetty(8) man:systemd-getty-generator(8)`
unit: link up getty configuration from man page and unit files 2012-11-21 03:09:38 +08:00			`Documentation=http://0pointer.de/blog/projects/serial-console.html`
unit: rename BindTo= to BindsTo= all other dependencies are in 3rd person. Change BindTo= accordingly to BindsTo=. Of course, the dependency is widely used, hence we parse the old name too for compatibility. 2012-07-14 05:34:40 +08:00			`BindsTo=dev-%i.device`
units: introduce getty-pre.target (#6667) This new target is a passive unit, hence it is supposed to be pulled in to the transaction by the service that wants to block login on the console (e.g. text version of initial-setup). Now both getty and serial-getty are ordered after this target. https://lists.freedesktop.org/archives/systemd-devel/2015-July/033754.html 2017-08-31 17:20:14 +08:00			`After=dev-%i.device systemd-user-sessions.service plymouth-quit-wait.service getty-pre.target`
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 05:36:48 +08:00			m4_ifdef(`HAVE_SYSV_COMPAT',
Add Mageia support This patch adds support for the Mageia Linux distribution: http://www.mageia.org/ Mageia is a fork of Mandriva although some divergence has already occured and thus inclusion of these changes upstream allow us to (hopefully) migrate more rapidly to the new standard approaches systemd offers. Indeed, we already use the preferred mechanism of OS identification via the /etc/os-release file rather than a distro specific variation. This patch mostly mirrors the patch added previously for Mandriva support. In addition to those original authors, this patch was mostly written by Dexter Morgan with help from Colin Guthrie and Eugeni Dodonov. 2011-10-29 01:16:33 +08:00			`After=rc-local.service`
			`)m4_dnl`
serial: use seperate getty template for serial ttys 2010-08-25 09:09:57 +08:00
units: enable utmp for serial gettys too 2010-10-09 00:22:44 +08:00			`# If additional gettys are spawned during boot then we should make`
			`# sure that this is synchronized before getty.target, even though`
			`# getty.target didn't actually pull it in.`
serial: use seperate getty template for serial ttys 2010-08-25 09:09:57 +08:00			`Before=getty.target`
units: exclude gettys from isolate requests gettys are nowadays mostly autospawned and hence usually subject to being shut down on isolate requests, since they are no dependency of any other unit. This is a bad idea if the user isolates between multi-user.graphical and graphical.target, hence exclude them from the isolation. This has the effect that gettys no longer cleaned up when emergency.target is isolated, which might actualy be considered a feature, even though it is a change from previous behaviour... Note that the one getty that really matters (the one on tty1) is still removed when isolating to emergency.target since it conflicts with emergency.service. 2012-04-12 03:58:33 +08:00			`IgnoreOnIsolate=yes`
serial: use seperate getty template for serial ttys 2010-08-25 09:09:57 +08:00
serial-getty@.service.m4: add Conflicts=/Before= against rescue.service (#5632) Commit 5ed020d8d10fc100c68edddb519f085b7397a45c already fixed this issue for getty@.service but forgot serial console. Note that this is not needed for emergency target as the sysinit target conflicts against this target already. 2017-03-30 16:39:16 +08:00			`# IgnoreOnIsolate causes issues with sulogin, if someone isolates`
			`# rescue.target or starts rescue.service from multi-user.target or`
			`# graphical.target.`
Revert "units: don't kill the emergency shell when sysinit.target is triggered (#6765)" (#6904) This reverts commit f1e24a259ca182b6cd8a723a56da43435ce48aac. Oops. # systemctl emergency Failed to start emergency.target: Transaction order is cyclic. See syste... See system logs and 'systemctl status emergency.target' for details. # systemctl status emergency.target ● emergency.target - Emergency Mode Loaded: loaded (/usr/lib/systemd/system/emergency.target; static; vendor preset: disabled) Active: inactive (dead) since Mon 2017-09-25 10:43:02 BST; 2h 42min ago Docs: man:systemd.special(7) systemd[1]: sysinit.target: Found dependency on sysinit.target/stop sysinit.target: Unable to break cycle starting with sysinit.target/stop network.target: Found ordering cycle on wpa_supplicant.service/stop network.target: Found dependency on sysinit.target/stop network.target: Found dependency on emergency.target/start network.target: Found dependency on emergency.service/start network.target: Found dependency on serial-getty@ttyS0.service/stop network.target: Found dependency on systemd-user-sessions.service/stop network.target: Found dependency on network.target/stop network.target: Unable to break cycle starting with network.target/stop IMO #6509 is ugly enough that we should aim to answer it. But it could take some time to investigate, so let's re-open the issue as a first step. 2017-09-27 01:47:50 +08:00			`Conflicts=rescue.service`
			`Before=rescue.service`
serial-getty@.service.m4: add Conflicts=/Before= against rescue.service (#5632) Commit 5ed020d8d10fc100c68edddb519f085b7397a45c already fixed this issue for getty@.service but forgot serial console. Note that this is not needed for emergency target as the sysinit target conflicts against this target already. 2017-03-30 16:39:16 +08:00
serial: use seperate getty template for serial ttys 2010-08-25 09:09:57 +08: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 19:58:01 +08: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.`
units: update serial-getty@.service to support 57600 baud rate Fixes: #17306 2020-10-13 23:07:07 +08:00			`ExecStart=-/sbin/agetty -o '-p -- \\u' --keep-baud 115200,57600,38400,9600 %I $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 20:28:00 +08:00			`Type=idle`
service: rename settings for Restart= from 'restart-always' to 'always' and similar 2010-10-06 02:30:44 +08:00			`Restart=always`
units: enable utmp for serial gettys too 2010-10-09 00:22:44 +08:00			`UtmpIdentifier=%I`
exec: hangup/reset/deallocate VTs in gettys Explicitly disconnect all clients from a VT when a getty starts/finishes (requires TIOCVHANGUP, available in 2.6.29). Explicitly deallocate getty VTs in order to flush scrollback buffer. Explicitly reset terminals to a defined state before spawning getty. 2011-05-18 07:07:31 +08:00			`TTYPath=/dev/%I`
			`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 20:12:56 +08:00			m4_ifdef(`ENABLE_LOGIND',,
exec: drop process group kill mode since it has little use and confuses the user 2011-03-30 05:31:38 +08: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 20:12:56 +08:00			`)m4_dnl`
service: ignore SIGPIPE by default 2012-02-09 10:18:04 +08: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 07:54:59 +08:00			`SendSIGHUP=yes`
units/serial-getty@.service: add [Install] section This makes it easier to manually enable and disable specific gettys, and also mirrors getty@.service. http://lists.freedesktop.org/archives/systemd-devel/2014-February/017329.html 2014-02-24 21:02:28 +08:00
			`[Install]`
			`WantedBy=getty.target`