systemd/units/emergency.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=Emergency Shell
Documentation=man:sulogin(8)
DefaultDependencies=no
Conflicts=shutdown.target
Conflicts=rescue.service
Before=shutdown.target
Before=rescue.service

[Service]
Environment=HOME=/root
WorkingDirectory=-/root
ExecStartPre=-@rootbindir@/plymouth --wait quit
ExecStart=-@rootlibexecdir@/systemd-sulogin-shell emergency
Type=idle
StandardInput=tty-force
StandardOutput=inherit
StandardError=inherit
KillMode=process
IgnoreSIGPIPE=no
SendSIGHUP=yes
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			`#`
units: move a number of units into the tarball 2010-05-16 22:49:41 +04: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 02:20:58 +04: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`
units: move a number of units into the tarball 2010-05-16 22:49:41 +04:00			`# (at your option) any later version.`

units: rename [Meta] section to [Unit] 2010-04-16 01:20:17 +04:00			`[Unit]`
units: install a few basic units by default 2010-04-13 07:18:12 +04:00			`Description=Emergency Shell`
man: add Documentation= tags to all kinds of missing units 2012-06-27 03:07:04 +04:00			`Documentation=man:sulogin(8)`
units: update shipped unit files for DefaultDependencies= 2010-07-03 21:53:37 +04:00			`DefaultDependencies=no`
units: make fedora/single.service standard and rename it to rescue.service 2010-10-29 06:09:36 +04:00			`Conflicts=shutdown.target`
units: make emergency.service conflict with rescue.service They both use StandardInput=tty-force so they cannot be run concurrently. https://bugs.freedesktop.org/show_bug.cgi?id=82778 https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=757072 2014-08-31 06:33:40 +04:00			`Conflicts=rescue.service`
units: make fedora/single.service standard and rename it to rescue.service 2010-10-29 06:09:36 +04:00			`Before=shutdown.target`
units: add missing ordering deps for Conflicts= of emergency.service 1. If we exited emergency mode immediately, we don't want to have an irreversible stop job still running for syslog.socket. I _suspect_ that can't happen, but let's not waste effort working out exactly why it's impossible and not just very improbable. 2. Similarly, it seems undesirable to have rescue.service and emergency.service both running with an open FD of /dev/console, for however short a period. 2017-09-25 13:45:03 +03:00			`Before=rescue.service`
units: install a few basic units by default 2010-04-13 07:18:12 +04:00
			`[Service]`
units: set HOME=/root when running shells 2010-09-10 18:53:53 +04:00			`Environment=HOME=/root`
units: don't fail if /root doesn't exist for shell units As discussed on the ML: http://lists.freedesktop.org/archives/systemd-devel/2016-January/035594.html 2016-01-17 19:25:42 +03:00			`WorkingDirectory=-/root`
units: use correct path to refer to plymouth This doesn't really matter, since in non-/usr-merged systems plymouth needs to be in /bin and on merged ones it doesn't matter, but it is still prettier to insert the right path, and avoid /bin on merged systems, since it's just a compat symlink. Replaces: #15351 2020-04-07 15:00:28 +03:00			`ExecStartPre=-@rootbindir@/plymouth --wait quit`
units: simplify rescue.service and emergency.service (#5623) The emergency.service and rescue.service units have become rather convoluted. We spawn multiple shells and the help text spans multiple lines which makes the units hard to read. Move the logic into a single shell script and call that via ExecStart. 2017-03-23 06:37:06 +03:00			`ExecStart=-@rootlibexecdir@/systemd-sulogin-shell emergency`
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`
units: introduce emergency.target 2010-07-13 01:49:20 +04:00			`StandardInput=tty-force`
units: direct stdout/stderr of rescue shells to tty With output of services going to syslog by default now, the rescue shell units need to direct their output to tty explicitly. Specify stderr too, just in case. 2011-09-20 14:11:04 +04:00			`StandardOutput=inherit`
			`StandardError=inherit`
exec: drop process group kill mode since it has little use and confuses the user 2011-03-30 01:31:38 +04:00			`KillMode=process`
service: ignore SIGPIPE by default 2012-02-09 06:18:04 +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`