From efeb864cb547a2cbf96dc0053a8bdb4d9190b364 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Wed, 12 Jun 2024 05:50:45 +0200 Subject: Merging upstream version 256. Signed-off-by: Daniel Baumann --- man/systemd.unit.xml | 182 ++++++++++++++++++++++++++++++--------------------- 1 file changed, 109 insertions(+), 73 deletions(-) (limited to 'man/systemd.unit.xml') diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index 301fe77..919e641 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -1,6 +1,6 @@ %entities; ]> @@ -25,52 +25,60 @@ - service.service, - socket.socket, - device.device, - mount.mount, - automount.automount, - swap.swap, - target.target, - path.path, - timer.timer, - slice.slice, - scope.scope + + service.service + socket.socket + device.device + mount.mount + automount.automount + swap.swap + target.target + path.path + timer.timer + slice.slice + scope.scope + System Unit Search Path - /etc/systemd/system.control/* -/run/systemd/system.control/* -/run/systemd/transient/* -/run/systemd/generator.early/* -/etc/systemd/system/* -/etc/systemd/system.attached/* -/run/systemd/system/* -/run/systemd/system.attached/* -/run/systemd/generator/* -… -/usr/lib/systemd/system/* -/run/systemd/generator.late/* + + /etc/systemd/system.control/* + /run/systemd/system.control/* + /run/systemd/transient/* + /run/systemd/generator.early/* + /etc/systemd/system/* + /etc/systemd/system.attached/* + /run/systemd/system/* + /run/systemd/system.attached/* + /run/systemd/generator/* + … + /usr/local/lib/systemd/system/* + /usr/lib/systemd/system/* + /run/systemd/generator.late/* + User Unit Search Path - ~/.config/systemd/user.control/* -$XDG_RUNTIME_DIR/systemd/user.control/* -$XDG_RUNTIME_DIR/systemd/transient/* -$XDG_RUNTIME_DIR/systemd/generator.early/* -~/.config/systemd/user/* -$XDG_CONFIG_DIRS/systemd/user/* -/etc/systemd/user/* -$XDG_RUNTIME_DIR/systemd/user/* -/run/systemd/user/* -$XDG_RUNTIME_DIR/systemd/generator/* -$XDG_DATA_HOME/systemd/user/* -$XDG_DATA_DIRS/systemd/user/* -… -/usr/lib/systemd/user/* -$XDG_RUNTIME_DIR/systemd/generator.late/* + + ~/.config/systemd/user.control/* + $XDG_RUNTIME_DIR/systemd/user.control/* + $XDG_RUNTIME_DIR/systemd/transient/* + $XDG_RUNTIME_DIR/systemd/generator.early/* + ~/.config/systemd/user/* + $XDG_CONFIG_DIRS/systemd/user/* + /etc/systemd/user/* + $XDG_RUNTIME_DIR/systemd/user/* + /run/systemd/user/* + $XDG_RUNTIME_DIR/systemd/generator/* + $XDG_DATA_HOME/systemd/user/* + $XDG_DATA_DIRS/systemd/user/* + … + /usr/local/lib/systemd/user/* + /usr/lib/systemd/user/* + $XDG_RUNTIME_DIR/systemd/generator.late/* + @@ -158,7 +166,7 @@ instance (if any) is always uniquely defined for a given unit and all its aliases. The target of alias symlink must point to a valid unit file location, i.e. the symlink target name must match the symlink source name as described, and the destination path must be in one of the unit search paths, see UNIT FILE - LOAD PATH section below for more details. Note that the target file may not exist, i.e. the symlink may + LOAD PATH section below for more details. Note that the target file might not exist, i.e. the symlink may be dangling. Unit files may specify aliases through the Alias= directive in the [Install] @@ -190,7 +198,7 @@ .wants/ or .requires/ must thus point to a valid unit file location, i.e. the symlink target name must satisfy the described requirements, and the destination path must be in one of the unit search paths, see UNIT FILE LOAD PATH section below for more details. Note - that the target file may not exist, i.e. the symlink may be dangling. + that the target file might not exist, i.e. the symlink may be dangling. Along with a unit file foo.service, a "drop-in" directory foo.service.d/ may exist. All files with the suffix @@ -345,7 +353,9 @@ Unit files are loaded from a set of paths determined during compilation, described in the two tables below. Unit files found in directories listed earlier override files with the same name in - directories lower in the list. + directories lower in the list + . + When the variable $SYSTEMD_UNIT_PATH is set, the contents of this variable overrides the unit load path. If @@ -399,7 +409,7 @@ /usr/local/lib/systemd/system - System units installed by the administrator + System units installed by the administrator /usr/lib/systemd/system @@ -919,6 +929,16 @@ + + WantsMountsFor= + + Same as RequiresMountsFor=, + but adds dependencies of type Wants= instead + of Requires=. + + + + OnSuccessJobMode= OnFailureJobMode= @@ -1067,9 +1087,8 @@ , , , , , , and . In system mode, all options are - allowed. In user mode, only , , - , and are - allowed. Both options default to . + allowed. In user mode, only , , and + are allowed. Both options default to . If is set, no action will be triggered. causes a reboot following the normal shutdown procedure (i.e. equivalent to systemctl @@ -1144,7 +1163,8 @@ JobTimeoutAction= optionally configures an additional action to take when the timeout is hit, see description of JobTimeoutSec= and JobRunningTimeoutSec= above. It takes the same values as - StartLimitAction=. Defaults to . + FailureAction=/SuccessAction=. Defaults to + . JobTimeoutRebootArgument= configures an optional reboot string to pass to the reboot2 system @@ -1311,6 +1331,10 @@ arc-be, or native. + Use + systemd-analyze1 + for the complete list of known architectures. + The architecture is determined from the information returned by uname2 and is thus subject to @@ -1604,7 +1628,7 @@ to make sure they run before the stamp file's modification time gets reset indicating a completed update. - If the systemd.condition-needs-update= option is specified on the kernel + If the systemd.condition_needs_update= option is specified on the kernel command line (taking a boolean), it will override the result of this condition check, taking precedence over any file modification time checks. If the kernel command line option is used, systemd-update-done.service will not have immediate effect on any following @@ -1634,18 +1658,26 @@ whether the system is booting up for the first time. This roughly means that /etc/ was unpopulated when the system started booting (for details, see "First Boot Semantics" in machine-id5). - First boot is considered finished (this condition will evaluate as false) after the manager + First Boot is considered finished (this condition will evaluate as false) after the manager has finished the startup phase. This condition may be used to populate /etc/ on the first boot after factory reset, or when a new system instance boots up for the first time. + Note that the service manager itself will perform setup steps during First Boot: it will + initialize + machine-id5 and + preset all units, enabling or disabling them according to the + systemd.preset5 + settings. Additional setup may be performed via units with + ConditionFirstBoot=yes. + For robustness, units with ConditionFirstBoot=yes should order themselves before first-boot-complete.target and pull in this passive target with Wants=. This ensures that in a case of an aborted first boot, these units will be re-run during the next system startup. - If the systemd.condition-first-boot= option is specified on the kernel + If the systemd.condition_first_boot= option is specified on the kernel command line (taking a boolean), it will override the result of this condition check, taking precedence over /etc/machine-id existence checks. @@ -2282,6 +2314,11 @@ Credentials directory This is the value of the $CREDENTIALS_DIRECTORY environment variable if available. See section "Credentials" in systemd.exec5 for more information. + + %D + Shared data directory + This is either /usr/share/ (for the system manager) or the path $XDG_DATA_HOME resolves to (for user managers). + %E Configuration directory root @@ -2629,28 +2666,27 @@ OnFailure=failure-handler@%N.service See Also - - systemd1, - systemctl1, - systemd-system.conf5, - systemd.special7, - systemd.service5, - systemd.socket5, - systemd.device5, - systemd.mount5, - systemd.automount5, - systemd.swap5, - systemd.target5, - systemd.path5, - systemd.timer5, - systemd.scope5, - systemd.slice5, - systemd.time7, - systemd-analyze1, - capabilities7, - systemd.directives7, - uname1 - + + systemd1 + systemctl1 + systemd-system.conf5 + systemd.special7 + systemd.service5 + systemd.socket5 + systemd.device5 + systemd.mount5 + systemd.automount5 + systemd.swap5 + systemd.target5 + systemd.path5 + systemd.timer5 + systemd.scope5 + systemd.slice5 + systemd.time7 + systemd-analyze1 + capabilities7 + systemd.directives7 + uname1 + - -- cgit v1.2.3