summaryrefslogtreecommitdiffstats
path: root/man/systemd.special.xml (follow)
Commit message (Collapse)AuthorAgeFilesLines
* shared/dropin: support -.service.d/ top level drop-in for service unitsAnita Zhang2019-10-151-0/+9
| | | | Closes #12830
* units: add time-set.targetPeter A. Bigot2019-04-081-0/+13
| | | | | | | | | | | | | time-sync.target is supposed to indicate system clock is synchronized with a remote clock, but as used through 241 it only provided a system clock that was updated based on a locally-maintained timestamp. Systems that are powered off for extended periods would not come up with accurate time. Retain the existing behavior using a new time-set.target leaving time-sync.target for cases where accuracy is required. Closes #8861
* man,units: document what user "default.target" is a bitZbigniew Jędrzejewski-Szmek2019-03-151-2/+15
|
* man: use same header for all filesZbigniew Jędrzejewski-Szmek2019-03-141-1/+1
| | | | | | | The "include" files had type "book" for some raeason. I don't think this is meaningful. Let's just use the same everywhere. $ perl -i -0pe 's^..DOCTYPE (book|refentry) PUBLIC "-//OASIS//DTD DocBook XML V4.[25]//EN"\s+"http^<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"\n "http^gms' man/*.xml
* man: standarize on one-line license headerZbigniew Jędrzejewski-Szmek2019-03-141-4/+1
| | | | | | No need to waste space, and uniformity is good. $ perl -i -0pe 's|\n+<!--\s*SPDX-License-Identifier: LGPL-2.1..\s*-->|\n<!-- SPDX-License-Identifier: LGPL-2.1+ -->|gms' man/*.xml
* units: add usb-gadget targetAndrzej Pietrasiewicz2019-02-151-0/+11
| | | | | | | | | | Linux can be run on a device meant to act as a USB peripheral. In order for a machine to act as such a USB device it has to be equipped with a UDC - USB Device Controller. This patch adds a target reached when UDC becomes available. It can be used for activating e.g. a service unit which composes a USB gadget with configfs and activates it.
* man: document new "boot-complete.target" unitLennart Poettering2018-10-191-0/+22
|
* man: remove recommendation to pull in slices from slices.targetZbigniew Jędrzejewski-Szmek2018-09-141-6/+10
| | | | | | | | That recommendation is likely to cause more trouble and for pretty much all end-user units is not useful. Let's recommend relying on the implicit dependency instead. Fixes #10015.
* man: add a description of user@.service, user-runtime-dir@.service, user-*.sliceZbigniew Jędrzejewski-Szmek2018-07-201-1/+2
| | | | Fixes #9590.
* man: split systemd.special(7) into separate system/user sectionsZbigniew Jędrzejewski-Szmek2018-07-201-927/+950
| | | | | | | | | User units were in the middle, which is just confusing. Let's discuss all system units first, and all user units second. I'm using "System manager units" and "user manager units" instead of the more obvious "system units" and "user units", because there are also units like "user@.service".
* units: make system-update-pre.target a passive unit (#9349)Lennart Poettering2018-06-201-6/+9
| | | | | | | This is an additional synchronization point normally not needed. Hence, let's make it passive, i.e. pull it in from the unit which wants to be ordered before the update service rather than by the update service itself.
* man: drop unused <authorgroup> tags from man sourcesZbigniew Jędrzejewski-Szmek2018-06-141-9/+0
| | | | | | | | | | | | Docbook styles required those to be present, even though the templates that we use did not show those names anywhere. But something changed semi-recently (I would suspect docbook templates, but there was only a minor version bump in recent years, and the changelog does not suggest anything related), and builds now work without those entries. Let's drop this dead weight. Tested with F26-F29, debian unstable. $ perl -i -0pe 's/\s*<authorgroup>.*<.authorgroup>//gms' man/*xml
* tree-wide: remove Lennart's copyright linesLennart Poettering2018-06-141-2/+0
| | | | | | | | | | | These lines are generally out-of-date, incomplete and unnecessary. With SPDX and git repository much more accurate and fine grained information about licensing and authorship is available, hence let's drop the per-file copyright notice. Of course, removing copyright lines of others is problematic, hence this commit only removes my own lines and leaves all others untouched. It might be nicer if sooner or later those could go away too, making git the only and accurate source of authorship information.
* tree-wide: drop 'This file is part of systemd' blurbLennart Poettering2018-06-141-2/+0
| | | | | | | | | | | | | | | | This part of the copyright blurb stems from the GPL use recommendations: https://www.gnu.org/licenses/gpl-howto.en.html The concept appears to originate in times where version control was per file, instead of per tree, and was a way to glue the files together. Ultimately, we nowadays don't live in that world anymore, and this information is entirely useless anyway, as people are very welcome to copy these files into any projects they like, and they shouldn't have to change bits that are part of our copyright header for that. hence, let's just get rid of this old cruft, and shorten our codebase a bit.
* man/systemd.special: fix network v.s. LSB scripts (#8930)Alan Jenkins2018-05-081-5/+4
| | | | | | $network is converted to network-online.target, not network-target. See https://www.freedesktop.org/wiki/Software/systemd/NetworkTarget/ and the implementation at `src/sysv-generator/sysv-generator.c`.
* doc: clarify at which point user/group name resolution needs to work (#8884)Lennart Poettering2018-05-071-20/+13
| | | | | Prompted by the discussions on: https://bugs.freedesktop.org/show_bug.cgi?id=106339
* tree-wide: drop license boilerplateZbigniew Jędrzejewski-Szmek2018-04-061-13/+0
| | | | | | | | | | Files which are installed as-is (any .service and other unit files, .conf files, .policy files, etc), are left as is. My assumption is that SPDX identifiers are not yet that well known, so it's better to retain the extended header to avoid any doubt. I also kept any copyright lines. We can probably remove them, but it'd nice to obtain explicit acks from all involved authors before doing that.
* Rename suspend-to-hibernate to suspend-then-hibernateMario Limonciello2018-03-281-2/+2
| | | | | Per some discussion with Gnome folks, they would prefer this name as it's more descriptive of what's happening.
* Introduce suspend-to-hibernate (#8274)Mario Limonciello2018-03-081-0/+10
| | | | | | | | | | | | | | Suspend to Hibernate is a new sleep method that invokes suspend for a predefined period of time before automatically waking up and hibernating the system. It's similar to HybridSleep however there isn't a performance impact on every suspend cycle. It's intended to use with systems that may have a higher power drain in their supported suspend states to prevent battery and data loss over an extended suspend cycle. Signed-off-by: Mario Limonciello <mario.limonciello@dell.com>
* man: "reboot" to "power off" in poweroff.target (#8124)Faalagorn2018-02-071-1/+1
| | | Changed "reboot" to "power off" in poweroff.target description. It was most likely copied and pasted from the reboot.target below, compare with e.g. halt.target
* man: alphabetize and move targets to proper sections in systemd.specialZbigniew Jędrzejewski-Szmek2018-01-201-34/+34
|
* man: bootup(7) is one of our own man pagesLennart Poettering2017-11-211-1/+1
|
* Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
|
* man: rescue.target could be seen as single-user.target (#7323)John Lin2017-11-171-1/+2
|
* man: document explicitly that network-online.target doesn't track ↵Lennart Poettering2017-11-161-0/+4
| | | | | connectivity state dynamically (#7345) Fixes: #5909
* units: replace remote-cryptsetup-pre.target with remote-fs-pre.targetZbigniew Jędrzejewski-Szmek2017-10-171-16/+4
| | | | | | | | | | | | | | | | | remote-cryptsetup-pre.target was designed as an active unit (that pulls in network-online.target), the opposite of remote-fs-pre.target (a passive unit, with individual provider services ordering itself before it and pulling it in, for example iscsi.service and nfs-client.target). To make remote-cryptsetup-pre.target really work, those services should be ordered before it too. But this would require updates to all those services, not just changes from systemd side. But the requirements for remote-fs-pre.target and remote-cryptset-pre.target are fairly similar (e.g. iscsi devices can certainly be used for both), so let's reuse remote-fs-pre.target also for remote cryptsetup units. This loses a bit of flexibility, but does away with the requirement for various provider services to know about remote-cryptsetup-pre.target.
* man: fix link to documentation of slice conceptLennart Poettering2017-10-101-1/+1
|
* man: move non-target units together (#6934)John Lin2017-09-281-1/+1
|
* man: document two more special unitsLennart Poettering2017-09-221-1/+19
|
* man: remove double newlines in systemd.special man page headerLennart Poettering2017-09-221-6/+3
| | | | | | The <!-- --> comment lines resulted in double newlines in the man page header, which looks quite ugly. Let's rearrange a bit so that these comments don't result in changes in the output.
* man: document the new ip accounting and filting directivesDaniel Mack2017-09-221-6/+6
|
* man/systemd.special: correct what slices.target pulls in (#6862)Alan Jenkins2017-09-181-6/+7
|
* units: add remote-cryptsetup.target and remote-cryptsetup-pre.targetZbigniew Jędrzejewski-Szmek2017-09-051-0/+23
| | | | | | The pair is similar to remote-fs.target and remote-fs-pre.target. Any cryptsetup devices which require network shall be ordered after remote-cryptsetup-pre.target and before remote-cryptsetup.target.
* man: dbus method Manager.Exit() does not start exit.targetAlan Jenkins2017-08-311-2/+1
| | | | | | | It's like Manager.PowerOff(), which does not start poweroff.target. Instead, the dbus methods are used for `systemctl --force exit` or `systemctl --force poweroff`. They shut down the system without processing individual unit's ExecStop or TimeoutStopSec.
* units: introduce getty-pre.target (#6667)Michal Sekletar2017-08-311-0/+12
| | | | | | | | 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
* man: do not recommend rescue.target for alt-↑Zbigniew Jędrzejewski-Szmek2017-07-281-3/+3
| | | | | | | | rescue.target does not work well, and we don't have a suitable emergency shell unit that can be started on existing systems right now. So let's just remove the recommendation for now. Fixes #6451.
* man: do not encourgage starting of poweroff/halt/reboot/kexec targets directlyZbigniew Jędrzejewski-Szmek2017-07-281-8/+24
| | | | | | | | Going through logind and systemd allows polkit to be used, the job mode will be set properly, and is generally easier to get correct. Fixes #6452.
* man: use <varlistentry> for all unit entriesLennart Poettering2017-03-301-47/+41
| | | | | | | So far, all sections of the systemd.special(7) man page used <varlistentry> for listing the targets, with one exception: the "Special Passive User Units" one. Let's clean this up and use the same formatting everywhere.
* man: use https:// in URLsAsciiWolf2017-02-211-3/+3
|
* man: mention machines.target in systemd.special(7) (#5371)Zbigniew Jędrzejewski-Szmek2017-02-171-17/+30
| | | Also sort <refsynopsisdiv>.
* man: use unicode ellipsis in more placesZbigniew Jędrzejewski-Szmek2016-12-111-1/+1
| | | | | | | | | | | | | | As requested in https://github.com/systemd/systemd/pull/4864#pullrequestreview-12372557. docbook will substitute triple dots for the ellipsis in man output, so this has no effect on the troff output, only on HTML, making it infinitesimally nicer. In some places we show output from programs, which use dots, and those places should not be changed. In some tables, the alignment would change if dots were changed to the ellipsis which is only one character. Since docbook replaces the ellipsis automatically, we should leave those be. This patch changes all other places.
* units: add system-update-cleanup.service to guard against offline-update loopsZbigniew Jędrzejewski-Szmek2016-11-291-0/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | Note: the name is "system-update-cleanup.service" rather than "system-update-done.service", because it should not run normally, and also because there's already "systemd-update-done.service", and having them named so similarly would be confusing. In https://bugzilla.redhat.com/show_bug.cgi?id=1395686 the system repeatedly entered system-update.target on boot. Because of a packaging issue, the tool that created the /system-update symlink could be installed without the service unit that was supposed to perform the upgrade (and remove the symlink). In fact, if there are no units in system-update.target, and /system-update symlink is created, systemd always "hangs" in system-update.target. This is confusing for users, because there's no feedback what is happening, and fixing this requires starting an emergency shell somehow, and also knowing that the symlink must be removed. We should be more resilient in this case, and remove the symlink automatically ourselves, if there are no upgrade service to handle it. This adds a service which is started after system-update.target is reached and the symlink still exists. It nukes the symlink and reboots the machine. It should subsequently boot into the default default.target. This is a more general fix for https://bugzilla.redhat.com/show_bug.cgi?id=1395686 (the packaging issue was already fixed).
* man: update the description of offline updatesZbigniew Jędrzejewski-Szmek2016-11-291-7/+5
| | | | | | | | | - use "service" instead of "script", because various offline updaters that we have aren't really scripts, e.g. dnf-plugin-system-upgrade, packagekit-offline-update, fwupd-offline-update. - strongly recommend After=sysinit.target, Wants=sysinit.target - clarify a bit what should happen when multiple update services are started - replace links to the wiki with refs to the man page that replaced it.
* units: add graphical-session-pre.target user unit (#3848)Martin Pitt2016-08-021-0/+13
| | | | | This complements graphical-session.target for services which set up the environment (e. g. dbus-update-activation-environment) and need to run before the actual graphical session.
* units: add graphical-session.target user unit (#3678)Martin Pitt2016-07-251-0/+51
| | | | | | | | | | | | This unit acts as a dynamic "alias" target for any concrete graphical user session like gnome-session.target; these should declare "BindsTo=graphical-session.target" so that both targets stop and start at the same time. This allows services that run in a particular graphical user session (e. g. gnome-settings-daemon.service) to declare "PartOf=graphical-session.target" without having to know or get updated for all/new session types. This will ensure that stopping the graphical session will stop all services which are associated to it.
* correct information about implicit dependencies (#3730)Michal Soltys2016-07-151-5/+11
| | | | | | | systemd.special.xml: corrections about implicit dependencies for basic.target, sysinit.target and shutdown.target. systemd.target.xml: corrections about implicit dependencies for target units in general.
* Various fixes for typos found by lintian (#3705)Michael Biebl2016-07-121-1/+1
|
* man: match runlevel symlinks recommendation with our makefile (#3563)Lukáš Nykrýn2016-06-191-2/+2
| | | | | In makefile we create symlinks runlevel5.target to graphical.target and runlevel2-4.target to multi-user.target. Let's say the same thing in systemd.special manpage.
* Create initrd-root-device.target synchronization point (#3239)Daniel Drake2016-05-121-0/+13
| | | | | | | | | Add a synchronization point so that custom initramfs units can run after the root device becomes available, before it is fsck'd and mounted. This is useful for custom initramfs units that may modify the root disk partition table, where the root device is not known in advance (it's dynamically selected by the generators).
* tree-wide: use mdash instead of a two minusesZbigniew Jędrzejewski-Szmek2016-04-221-1/+1
|