summaryrefslogtreecommitdiff
path: root/man/systemd.special.xml
Commit message (Collapse)AuthorAgeFilesLines
* Support /etc/system-update for OSTree systemsEric Curtin2023-04-251-4/+5
| | | | | | This is required when / is immutable and cannot be written at runtime. Co-authored-by: Richard Hughes <richard@hughsie.com>
* tree-wide: use the term "initrd" at most places we so far used "initramfs"Lennart Poettering2022-09-231-2/+2
| | | | | | | | | | | | In most cases we refernced the concept as "initrd". Let's convert most remaining uses of "initramfs" to "initrd" too, to stay internally consistent. This leaves "initramfs" only where it's relevant to explain historical concepts or where "initramfs" is part of the API (i.e. in /run/initramfs). Follow-up for: b66a6e1a5838b874b789820c090dd6850cf10513
* docs: normalize uppercasing of titles of network docLennart Poettering2022-07-051-22/+16
|
* tree-wide: replace obsolete wiki links with systemd.io/manpagesBenjamin Franzke2022-05-211-2/+2
| | | | | | | | | | | All wiki pages that contain a deprecation banner pointing to systemd.io or manpages are updated to point to their replacements directly. Helpful command for identification of available links: git grep freedesktop.org/wiki | \ sed "s#.*\(https://www.freedesktop.org/wiki[^ $<'\\\")]*\)\(.*\)#\\1#" | \ sort | uniq
* Add stand-alone dm-integrity supportTony Asleson2021-10-151-0/+2
| | | | | | | This adds support for dm integrity targets and an associated /etc/integritytab file which is required as the dm integrity device super block doesn't include all of the required metadata to bring up the device correctly. See integritytab man page for details.
* units: added factory-reset.targetYegor Alexeyev2021-08-101-0/+7
|
* doc: fix typoYu Watanabe2021-04-211-1/+1
|
* man: document new initrd-usr-fs.targetLennart Poettering2021-04-201-11/+29
|
* man: say explicitly that network.target should give the guarantee that ↵Lennart Poettering2021-02-261-14/+23
| | | | | | synthetic network interfaces have been created Prompted by: #18793
* man: be more explicit about network-online.target and consuming services of ↵Lennart Poettering2021-02-261-5/+4
| | | | | | other hosts Let's make things a tiny bit more explicit.
* man: fix indentation of exampleLennart Poettering2021-02-261-7/+7
| | | | The man page otherwise looks very weirdly aligned.
* man: various typos and other small issuesZbigniew Jędrzejewski-Szmek2021-01-291-3/+3
| | | | Fixes #18397.
* veritysetup-generator: add support for veritytabGaël PORTAY2021-01-151-2/+35
| | | | | | | | | | | | | | | | | | | | | | | | This adds the support for veritytab. The veritytab file contains at most five fields, the first four are mandatory, the last one is optional: - The first field contains the name of the resulting verity volume; its block device is set up /dev/mapper/</filename>. - The second field contains a path to the underlying block data device, or a specification of a block device via UUID= followed by the UUID. - The third field contains a path to the underlying block hash device, or a specification of a block device via UUID= followed by the UUID. - The fourth field is the roothash in hexadecimal. - The fifth field, if present, is a comma-delimited list of options. The following options are recognized only: ignore-corruption, restart-on-corruption, panic-on-corruption, ignore-zero-blocks, check-at-most-once and root-hash-signature. The others options will be implemented later. Also, this adds support for the new kernel verity command line boolean option "veritytab" which enables the read for veritytab, and the new environment variable SYSTEMD_VERITYTAB which sets the path to the file veritytab to read.
* man: apply @Minoru's suggestions from code reviewLennart Poettering2020-12-281-6/+6
| | | | Co-authored-by: Alexander Batischev <eual.jp@gmail.com>
* man: extend time-{set,sync}.target + systemd-timesyncd/wait-sync docsLennart Poettering2020-12-281-24/+91
| | | | | | | | Let's link the three man pages together more tightly and explain what the two targets are about, emphasizing local/quick/reliable/approximate vs remote/slow/unreliable/accurate synchronization. Follow-up for: 1431b2f701f7ba71e5d8664e709b1fad26797918 fe934b42e480473afba8a29a4a0d3d0e789543ac
* man: Advertise systemd-time-wait-sync.service more (#17729)Alexander Batischev2020-12-191-1/+10
| | | | | | | | | | | | | | | | | * man: Advertise systemd-time-wait-sync.service more The description of time-sync.target says that NTP services *should* pull that target, but doesn't mention that e.g. systemd-timesyncd.service doesn't actually do that. As a result, time-sync.target is reached way earlier than people expect; see #5097, #8861, #11008. systemd provides systemd-time-wait-sync.service to ameliorate this problem, but doesn't feature it prominently in relevant manpages. In fact, it's only mentioned in passing in systemd-timesyncd.service(8). As a result, I ended up re-implementing that service, and I'm not the first one: https://github.com/NixOS/nixpkgs/pull/51338 This patch adds a mention right in the description of time-sync.target, which will hopefully raise awareness of this helper service.
* Merge pull request #16603 from benzea/benzea/special-app-sliceLennart Poettering2020-11-111-0/+54
|\ | | | | Use app.slice by default in user manager (and define special user slices)
| * man: Document app, session and background special user slice unitsBenjamin Berg2020-10-231-0/+54
| | | | | | | | Add documentation for the special slice user slice units.
* | license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
| |
* | Revert "units: add initrd-cryptsetup.target"Zbigniew Jędrzejewski-Szmek2020-10-271-17/+4
|/ | | | | | | | | | This reverts commit 6c5496c492a8d74e54d22bf8824160cab1e63c10. sysinit.target is shared between the initrd and the host system. Pulling in initrd-cryptsetup.target into sysinit.target causes the following warning at boot: Oct 27 10:42:30 workstation-uefi systemd[1]: initrd-cryptsetup.target: Starting requested but asserts failed. Oct 27 10:42:30 workstation-uefi systemd[1]: Assertion failed for initrd-cryptsetup.target.
* units: add initrd-cryptsetup.targetJonathan Lebon2020-10-211-4/+17
| | | | | | | | | | | | | | | | | | For encrypted block devices that we need to unlock from the initramfs, we currently rely on dracut shipping `cryptsetup.target`. This works, but doesn't cover the case where the encrypted block device requires networking (i.e. the `remote-cryptsetup.target` version). That target however is traditionally dynamically enabled. Instead, let's rework things here by adding a `initrd-cryptsetup.target` specifically for initramfs encrypted block device setup. This plays the role of both `cryptsetup.target` and `remote-cryptsetup.target` in the initramfs. Then, adapt `systemd-cryptsetup-generator` to hook all generated services to this new unit when running from the initrd. This is analogous to `systemd-fstab-generator` hooking all mounts to `initrd-fs.target`, regardless of whether they're network-backed or not.
* units: add first-boot-complete.target for first boot orderingHarald Seiler2020-10-191-0/+12
| | | | | | | Add a new target for synchronizing units that wish to run once during the first boot of the system. The machine-id will be committed to disk only after the target has been reached, thus ensuring that all units ordered before it had a chance to complete.
* man: use trailing slash on directories in more placesZbigniew Jędrzejewski-Szmek2020-10-051-2/+2
|
* man: assorted small fixesZbigniew Jędrzejewski-Szmek2020-09-301-1/+1
| | | | This is almost all of #17177.
* man: do not index various /foobar/ pathsZbigniew Jędrzejewski-Szmek2020-09-301-2/+2
| | | | For #17177.
* tree-wide: drop quotes from around [section]Zbigniew Jędrzejewski-Szmek2020-07-061-7/+7
| | | | | | | For users, the square brackets already serve as markup and clearly delineate the section name from surrounding text. Putting additional markup around that only adds clutter. Also, we were very inconsistent in using the quotes. Let's just drop them altogether.
* tree-wide: fixes for assorted grammar and spelling issuesZbigniew Jędrzejewski-Szmek2020-07-061-3/+3
| | | | Fixes #16363. Also includes some changes where I generalized the pattern.
* man: add note that emergency.target inherits mount stateZbigniew Jędrzejewski-Szmek2020-06-021-8/+11
| | | | | | | | | | | | | | Based on an internal discussion whether emergency.target should remount disks ro, or maybe remount them rw, or do nothing. In some cases people want to boot ro, and always remounting rw would break that. In other cases, remounting disks ro after they have already been mounted rw is mostly pointless and might even not be possible. So let's just document that we don't change the state. Also: any→other, since emergency.service *is* pulled in. Also: just advertise "emergency" as the way to boot into the target. We are not going to remove this option, and it's way easier to type than "systemd.unit=emergency.target".
* man: Add systemd-xdg-autostart-generator man pageBenjamin Berg2020-05-271-1/+3
|
* xdg-autostart-generator: Add a generator for XDG autostart filesBenjamin Berg2020-05-271-0/+10
| | | | | | | | | | | | | | This generator can be used by desktop environments to launch autostart applications and services. The feature is an opt-in, triggered by xdg-desktop-autostart.target being activated. Also included is the new binary xdg-autostart-condition. This binary is used as an ExecCondition to test the OnlyShowIn and NotShowIn XDG desktop file keys. These need to be evaluated against the XDG_CURRENT_DESKTOP environment variable which may not be known at generation time. Co-authored-by: Henri Chain <henri.chain@enioka.com>
* man: drop apostophe from section titleZbigniew Jędrzejewski-Szmek2020-04-061-2/+2
| | | | | | | | | For whatever reason, this does not get rendered propely in the man page and results in an invalid code: W: manual-page-warning /usr/share/man/man7/systemd.special.7.gz 103: warning: macro `AQ' not defined We say 'user manager' and 'system manager' in most other places, so let's just use this form here too.
* man: tweak description of blockdev@.targetZbigniew Jędrzejewski-Szmek2020-02-041-13/+12
| | | | | | In particular, let's just say "is" and "must" instead of "may be" and "should". The weaker forms are obviously correct, but the text is easier to understand if non-conditional forms are used.
* man: document blockdev@.targetLennart Poettering2020-01-211-0/+18
|
* man: document initrd.targetZbigniew Jędrzejewski-Szmek2019-11-281-7/+19
|
* core: change top-level drop-in from -.service.d to service.dAnita Zhang2019-11-071-9/+0
| | | | | | | | | | Discussed in #13743, the -.service semantic conflicts with the existing root mount and slice names, making this feature not uniformly extensible to all types. Change the name to be <type>.d instead. Updating to this format also extends the top-level dropin to unit types.
* 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`.
View Lorry Controller Status