# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2024-03-01 17:11+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "SYSTEMD\\&.UNIT" msgstr "" #. type: TH #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "systemd 255" msgstr "" #. type: TH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "systemd.unit" msgstr "" #. ----------------------------------------------------------------- #. * MAIN CONTENT STARTS HERE * #. ----------------------------------------------------------------- #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "systemd.unit - Unit configuration" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I\\&.service, I\\&.socket, I\\&.device, I\\&." "mount, I\\&.automount, I\\&.swap, I\\&.target, " "I\\&.path, I\\&.timer, I\\&.slice, I\\&.scope" msgstr "" #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "System Unit Search Path" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "/etc/systemd/system\\&.control/*\n" "/run/systemd/system\\&.control/*\n" "/run/systemd/transient/*\n" "/run/systemd/generator\\&.early/*\n" "/etc/systemd/system/*\n" "/etc/systemd/system\\&.attached/*\n" "/run/systemd/system/*\n" "/run/systemd/system\\&.attached/*\n" "/run/systemd/generator/*\n" "\\&...\n" "/usr/lib/systemd/system/*\n" "/run/systemd/generator\\&.late/*\n" msgstr "" #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "User Unit Search Path" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "~/\\&.config/systemd/user\\&.control/*\n" "$XDG_RUNTIME_DIR/systemd/user\\&.control/*\n" "$XDG_RUNTIME_DIR/systemd/transient/*\n" "$XDG_RUNTIME_DIR/systemd/generator\\&.early/*\n" "~/\\&.config/systemd/user/*\n" "$XDG_CONFIG_DIRS/systemd/user/*\n" "/etc/systemd/user/*\n" "$XDG_RUNTIME_DIR/systemd/user/*\n" "/run/systemd/user/*\n" "$XDG_RUNTIME_DIR/systemd/generator/*\n" "$XDG_DATA_HOME/systemd/user/*\n" "$XDG_DATA_DIRS/systemd/user/*\n" "\\&...\n" "/usr/lib/systemd/user/*\n" "$XDG_RUNTIME_DIR/systemd/generator\\&.late/*\n" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "A unit file is a plain text ini-style file that encodes information about a " "service, a socket, a device, a mount point, an automount point, a swap file " "or partition, a start-up target, a watched file system path, a timer " "controlled and supervised by B(1), a resource management slice or a " "group of externally created processes\\&. See B(7) for a " "general description of the syntax\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "This man page lists the common configuration options of all the unit " "types\\&. These options need to be configured in the [Unit] or [Install] " "sections of the unit files\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "In addition to the generic [Unit] and [Install] sections described here, " "each unit may have a type-specific section, e\\&.g\\&. [Service] for a " "service unit\\&. See the respective man pages for more information: " "B(5), B(5), B(5), B(5), B(5), B(5), B(5), B(5), B(5), B(5), " "B(5)\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Unit files are loaded from a set of paths determined during compilation, " "described in the next section\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Valid unit names consist of a \"unit name prefix\", and a suffix specifying " "the unit type which begins with a dot\\&. The \"unit name prefix\" must " "consist of one or more valid characters (ASCII letters, digits, \":\", \"-" "\", \"_\", \"\\&.\", and \"\\e\")\\&. The total length of the unit name " "including the suffix must not exceed 255 characters\\&. The unit type suffix " "must be one of \"\\&.service\", \"\\&.socket\", \"\\&.device\", \"\\&." "mount\", \"\\&.automount\", \"\\&.swap\", \"\\&.target\", \"\\&.path\", " "\"\\&.timer\", \"\\&.slice\", or \"\\&.scope\"\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Unit names can be parameterized by a single argument called the \"instance " "name\"\\&. The unit is then constructed based on a \"template file\" which " "serves as the definition of multiple services or other units\\&. A template " "unit must have a single \"@\" at the end of the unit name prefix (right " "before the type suffix)\\&. The name of the full unit is formed by inserting " "the instance name between \"@\" and the unit type suffix\\&. In the unit " "file itself, the instance parameter may be referred to using \"%i\" and " "other specifiers, see below\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Unit files may contain additional options on top of those listed here\\&. If " "systemd encounters an unknown option, it will write a warning log message " "but continue loading the unit\\&. If an option or section name is prefixed " "with B, it is ignored completely by systemd\\&. Options within an " "ignored section do not need the prefix\\&. Applications may use this to " "include additional information in the unit files\\&. To access those " "options, applications need to parse the unit files on their own\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Units can be aliased (have an alternative name), by creating a symlink from " "the new name to the existing name in one of the unit search paths\\&. For " "example, systemd-networkd\\&.service has the alias dbus-org\\&." "freedesktop\\&.network1\\&.service, created during installation as a " "symlink, so when B is asked through D-Bus to load dbus-org\\&." "freedesktop\\&.network1\\&.service, it\\*(Aqll load systemd-networkd\\&." "service\\&. As another example, default\\&.target \\(em the default system " "target started at boot \\(em is commonly aliased to either multi-user\\&." "target or graphical\\&.target to select what is started by default\\&. Alias " "names may be used in commands like B, B, B, B, " "and similar, and in all unit dependency directives, including I, " "I, I, I\\&. Aliases cannot be used with the " "B command\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Aliases obey the following restrictions: a unit of a certain type (\"\\&." "service\", \"\\&.socket\", \\&...) can only be aliased by a name with the " "same type suffix\\&. A plain unit (not a template or an instance), may only " "be aliased by a plain name\\&. A template instance may only be aliased by " "another template instance, and the instance part must be identical\\&. A " "template may be aliased by another template (in which case the alias applies " "to all instances of the template)\\&. As a special case, a template instance " "(e\\&.g\\&. \"alias@inst\\&.service\") may be a symlink to different " "template (e\\&.g\\&. \"template@inst\\&.service\")\\&. In that case, just " "this specific instance is aliased, while other instances of the template " "(e\\&.g\\&. \"alias@foo\\&.service\", \"alias@bar\\&.service\") are not " "aliased\\&. Those rules preserve the requirement that the 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 be dangling\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Unit files may specify aliases through the I directive in the " "[Install] section\\&. When the unit is enabled, symlinks will be created for " "those names, and removed when the unit is disabled\\&. For example, " "reboot\\&.target specifies I, so when enabled, " "the symlink /etc/systemd/system/ctrl-alt-del\\&.service pointing to the " "reboot\\&.target file will be created, and when Ctrl+Alt+Del is invoked, " "B will look for the ctrl-alt-del\\&.service and execute reboot\\&." "service\\&. B does not look at the [Install] section at all during " "normal operation, so any directives in that section only have an effect " "through the symlinks created during enablement\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Along with a unit file foo\\&.service, the directory foo\\&.service\\&." "wants/ may exist\\&. All unit files symlinked from such a directory are " "implicitly added as dependencies of type I to the unit\\&. Similar " "functionality exists for I type dependencies as well, the " "directory suffix is \\&.requires/ in this case\\&. This functionality is " "useful to hook units into the start-up of other units, without having to " "modify their unit files\\&. For details about the semantics of I and " "I, see below\\&. The preferred way to create symlinks in the \\&." "wants/ or \\&.requires/ directories is by specifying the dependency in " "[Install] section of the target unit, and creating the symlink in the file " "system with the B or B commands of B(1)\\&. The " "target can be a normal unit (either plain or a specific instance of a " "template unit)\\&. In case when the source unit is a template, the target " "can also be a template, in which case the instance will be \"propagated\" to " "the target unit to form a valid unit instance\\&. The target of symlinks in " "\\&.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\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Along with a unit file foo\\&.service, a \"drop-in\" directory foo\\&." "service\\&.d/ may exist\\&. All files with the suffix \"\\&.conf\" from this " "directory will be merged in the alphanumeric order and parsed after the main " "unit file itself has been parsed\\&. This is useful to alter or add " "configuration settings for a unit, without having to modify unit files\\&. " "Each drop-in file must contain appropriate section headers\\&. For " "instantiated units, this logic will first look for the instance \"\\&.d/\" " "subdirectory (e\\&.g\\&. \"foo@bar\\&.service\\&.d/\") and read its \"\\&." "conf\" files, followed by the template \"\\&.d/\" subdirectory (e\\&.g\\&. " "\"foo@\\&.service\\&.d/\") and the \"\\&.conf\" files there\\&. Moreover for " "unit names containing dashes (\"-\"), the set of directories generated by " "repeatedly truncating the unit name after all dashes is searched too\\&. " "Specifically, for a unit name foo-bar-baz\\&.service not only the regular " "drop-in directory foo-bar-baz\\&.service\\&.d/ is searched but also both foo-" "bar-\\&.service\\&.d/ and foo-\\&.service\\&.d/\\&. This is useful for " "defining common drop-ins for a set of related units, whose names begin with " "a common prefix\\&. This scheme is particularly useful for mount, automount " "and slice units, whose systematic naming structure is built around dashes as " "component separators\\&. Note that equally named drop-in files further down " "the prefix hierarchy override those further up, i\\&.e\\&. foo-bar-\\&." "service\\&.d/10-override\\&.conf overrides foo-\\&.service\\&.d/10-" "override\\&.conf\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "In cases of unit aliases (described above), dropins for the aliased name and " "all aliases are loaded\\&. In the example of default\\&.target aliasing " "graphical\\&.target, default\\&.target\\&.d/, default\\&.target\\&.wants/, " "default\\&.target\\&.requires/, graphical\\&.target\\&.d/, graphical\\&." "target\\&.wants/, graphical\\&.target\\&.requires/ would all be read\\&. For " "templates, dropins for the template, any template aliases, the template " "instance, and all alias instances are read\\&. When just a specific template " "instance is aliased, then the dropins for the target template, the target " "template instance, and the alias template instance are read\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "In addition to /etc/systemd/system, the drop-in \"\\&.d/\" directories for " "system services can be placed in /usr/lib/systemd/system or /run/systemd/" "system directories\\&. Drop-in files in /etc/ take precedence over those in /" "run/ which in turn take precedence over those in /usr/lib/\\&. Drop-in files " "under any of these directories take precedence over unit files wherever " "located\\&. Multiple drop-in files with different names are applied in " "lexicographic order, regardless of which of the directories they reside " "in\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Units also support a top-level drop-in with I\\&.d/, where I may " "be e\\&.g\\&. \"service\" or \"socket\", that allows altering or adding to " "the settings of all corresponding unit files on the system\\&. The " "formatting and precedence of applying drop-in configurations follow what is " "defined above\\&. Files in I\\&.d/ have lower precedence compared to " "files in name-specific override directories\\&. The usual rules apply: " "multiple drop-in files with different names are applied in lexicographic " "order, regardless of which of the directories they reside in, so a file in " "I\\&.d/ applies to a unit only if there are no drop-ins or masks with " "that name in directories with higher precedence\\&. See Examples\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note that while systemd offers a flexible dependency system between units it " "is recommended to use this functionality only sparingly and instead rely on " "techniques such as bus-based or socket-based activation which make " "dependencies implicit, resulting in a both simpler and more flexible " "system\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "As mentioned above, a unit may be instantiated from a template file\\&. This " "allows creation of multiple units from a single configuration file\\&. If " "systemd looks for a unit configuration file, it will first search for the " "literal unit name in the file system\\&. If that yields no success and the " "unit name contains an \"@\" character, systemd will look for a unit template " "that shares the same name but with the instance string (i\\&.e\\&. the part " "between the \"@\" character and the suffix) removed\\&. Example: if a " "service getty@tty3\\&.service is requested and no file by that name is " "found, systemd will look for getty@\\&.service and instantiate a service " "from that configuration file if it is found\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "To refer to the instance string from within the configuration file you may " "use the special \"%i\" specifier in many of the configuration options\\&. " "See below for details\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "If a unit file is empty (i\\&.e\\&. has the file size 0) or is symlinked to /" "dev/null, its configuration will not be loaded and it appears with a load " "state of \"masked\", and cannot be activated\\&. Use this as an effective " "way to fully disable a unit, making it impossible to start it even " "manually\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The unit file format is covered by the \\m[blue]B\\m[]\\&\\s-2\\u[1]\\d\\s+2\\&." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "STRING ESCAPING FOR INCLUSION IN UNIT NAMES" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Sometimes it is useful to convert arbitrary strings into unit names\\&. To " "facilitate this, a method of string escaping is used, in order to map " "strings containing arbitrary byte values (except B) into valid unit " "names and their restricted character set\\&. A common special case are unit " "names that reflect paths to objects in the file system hierarchy\\&. " "Example: a device unit dev-sda\\&.device refers to a device with the device " "node /dev/sda in the file system\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The escaping algorithm operates as follows: given a string, any \"/\" " "character is replaced by \"-\", and all other characters which are not ASCII " "alphanumerics, \":\", \"_\" or \"\\&.\" are replaced by C-style \"\\ex2d\" " "escapes\\&. In addition, \"\\&.\" is replaced with such a C-style escape " "when it would appear as the first character in the escaped string\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "When the input qualifies as absolute file system path, this algorithm is " "extended slightly: the path to the root directory \"/\" is encoded as single " "dash \"-\"\\&. In addition, any leading, trailing or duplicate \"/\" " "characters are removed from the string before transformation\\&. Example: /" "foo//bar/baz/ becomes \"foo-bar-baz\"\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "This escaping is fully reversible, as long as it is known whether the " "escaped string was a path (the unescaping results are different for paths " "and non-path strings)\\&. The B(1) command may be used to " "apply and reverse escaping on arbitrary strings\\&. Use B to escape path strings, and B without B<--path> " "otherwise\\&." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "AUTOMATIC DEPENDENCIES" msgstr "" #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Implicit Dependencies" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "A number of unit dependencies are implicitly established, depending on unit " "type and unit configuration\\&. These implicit dependencies can make unit " "configuration file cleaner\\&. For the implicit dependencies in each unit " "type, please refer to section \"Implicit Dependencies\" in respective man " "pages\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "For example, service units with I automatically acquire " "dependencies of type I and I on dbus\\&.socket\\&. See " "B(5) for details\\&." msgstr "" #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Default Dependencies" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Default dependencies are similar to implicit dependencies, but can be turned " "on and off by setting I to I (the default) and " "I, while implicit dependencies are always in effect\\&. See section " "\"Default Dependencies\" in respective man pages for the effect of enabling " "I in each unit types\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "For example, target units will complement all configured dependencies of " "type I or I with dependencies of type I\\&. See " "B(5) for details\\&. Note that this behavior can be opted " "out by setting I in the specified units, or it can " "be selectively overridden via an explicit I dependency\\&." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "UNIT FILE LOAD PATH" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "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\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "When the variable I<$SYSTEMD_UNIT_PATH> is set, the contents of this " "variable overrides the unit load path\\&. If I<$SYSTEMD_UNIT_PATH> ends with " "an empty component (\":\"), the usual unit load path will be appended to the " "contents of the variable\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "B" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Path" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Description" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid ".T&" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "l l" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "l ^" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "l l." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/etc/systemd/system\\&.control" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Persistent and transient configuration created using the dbus API" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/run/systemd/system\\&.control" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/run/systemd/transient" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Dynamic configuration for transient units" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/run/systemd/generator\\&.early" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Generated units with high priority (see I in B(7))" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/etc/systemd/system" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "System units created by the administrator" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/run/systemd/system" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Runtime units" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/run/systemd/generator" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Generated units with medium priority (see I in B(7))" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/usr/local/lib/systemd/system" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "System units installed by the administrator" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/usr/lib/systemd/system" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "System units installed by the distribution package manager" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/run/systemd/generator\\&.late" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Generated units with low priority (see I in B(7))" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "B" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "$XDG_CONFIG_HOME/systemd/user\\&.control or ~/\\&.config/systemd/user\\&.control" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Persistent and transient configuration created using the dbus API (I<$XDG_CONFIG_HOME> is used if set, ~/\\&.config otherwise)" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "$XDG_RUNTIME_DIR/systemd/user\\&.control" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "$XDG_RUNTIME_DIR/systemd/transient" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "$XDG_RUNTIME_DIR/systemd/generator\\&.early" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "$XDG_CONFIG_HOME/systemd/user or $HOME/\\&.config/systemd/user" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "User configuration (I<$XDG_CONFIG_HOME> is used if set, ~/\\&.config otherwise)" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "$XDG_CONFIG_DIRS/systemd/user or /etc/xdg/systemd/user" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Additional configuration directories as specified by the XDG base directory specification (I<$XDG_CONFIG_DIRS> is used if set, /etc/xdg otherwise)" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/etc/systemd/user" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "User units created by the administrator" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "$XDG_RUNTIME_DIR/systemd/user" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Runtime units (only used when $XDG_RUNTIME_DIR is set)" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/run/systemd/user" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "$XDG_RUNTIME_DIR/systemd/generator" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "$XDG_DATA_HOME/systemd/user or $HOME/\\&.local/share/systemd/user" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Units of packages that have been installed in the home directory (I<$XDG_DATA_HOME> is used if set, ~/\\&.local/share otherwise)" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "$XDG_DATA_DIRS/systemd/user or /usr/local/share/systemd/user and /usr/share/systemd/user" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Additional data directories as specified by the XDG base directory specification (I<$XDG_DATA_DIRS> is used if set, /usr/local/share and /usr/share otherwise)" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "$dir/systemd/user for each I<$dir> in I<$XDG_DATA_DIRS>" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Additional locations for installed user units, one for each entry in I<$XDG_DATA_DIRS>" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/usr/local/lib/systemd/user" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "User units installed by the administrator" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/usr/lib/systemd/user" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "User units installed by the distribution package manager" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "$XDG_RUNTIME_DIR/systemd/generator\\&.late" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The set of load paths for the user manager instance may be augmented or " "changed using various environment variables\\&. And environment variables " "may in turn be set using environment generators, see B(7)\\&. In particular, I<$XDG_DATA_HOME> and I<$XDG_DATA_DIRS> may " "be easily set using B(8)\\&. Thus, " "directories listed here are just the defaults\\&. To see the actual list " "that would be used based on compilation options and current environment use" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "systemd-analyze --user unit-paths\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Moreover, additional units might be loaded into systemd from directories not " "on the unit load path by creating a symlink pointing to a unit file in the " "directories\\&. You can use B for this; see " "B(1)\\&. The file system where the linked unit files are located " "must be accessible when systemd is started (e\\&.g\\&. anything underneath /" "home/ or /var/ is not allowed, unless those directories are located on the " "root file system)\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "It is important to distinguish \"linked unit files\" from \"unit file " "aliases\": any symlink where the symlink I is within the unit load " "path becomes an alias: the source name and the target file name must satisfy " "specific constraints listed above in the discussion of aliases, but the " "symlink target doesn\\*(Aqt have to exist, and in fact the symlink target " "path is not used, except to check whether the target is within the unit load " "path\\&. In contrast, a symlink which goes outside of the unit load path " "signifies a linked unit file\\&. The symlink is followed when loading the " "file, but the destination name is otherwise unused (and may even not be a " "valid unit file name)\\&. For example, symlinks /etc/systemd/system/" "alias1\\&.service → service1\\&.service, /etc/systemd/system/alias2\\&." "service → /usr/lib/systemd/service1\\&.service, /etc/systemd/system/" "alias3\\&.service → /etc/systemd/system/service1\\&.service are all valid " "aliases and service1\\&.service will have four names, even if the unit file " "is located at /run/systemd/system/service1\\&.service\\&. In contrast, a " "symlink /etc/systemd/system/link1\\&.service → \\&.\\&./link1_service_file " "means that link1\\&.service is a \"linked unit\" and the contents of /etc/" "systemd/link1_service_file provide its configuration\\&." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "UNIT GARBAGE COLLECTION" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The system and service manager loads a unit\\*(Aqs configuration " "automatically when a unit is referenced for the first time\\&. It will " "automatically unload the unit configuration and state again when the unit is " "not needed anymore (\"garbage collection\")\\&. A unit may be referenced " "through a number of different mechanisms:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Another loaded unit references it with a dependency such as I, " "I, \\&..." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The unit is currently starting, running, reloading or stopping\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The unit is currently in the B state\\&. (But see below\\&.)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "A job for the unit is pending\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The unit is pinned by an active IPC client program\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The unit is a special \"perpetual\" unit that is always active and " "loaded\\&. Examples for perpetual units are the root mount unit -\\&.mount " "or the scope unit init\\&.scope that the service manager itself lives in\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The unit has running processes associated with it\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The garbage collection logic may be altered with the I option, " "which allows configuration whether automatic unloading of units that are in " "B state is permissible, see below\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note that when a unit\\*(Aqs configuration and state is unloaded, all " "execution results, such as exit codes, exit signals, resource consumption " "and other statistics are lost, except for what is stored in the log " "subsystem\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Use B or an equivalent command to reload unit " "configuration while the unit is already loaded\\&. In this case all " "configuration settings are flushed out and replaced with the new " "configuration (which however might not be in effect immediately), however " "all runtime state is saved/restored\\&." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "[UNIT] SECTION OPTIONS" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The unit file may include a [Unit] section, which carries generic " "information about the unit that is not dependent on the type of unit:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "A short human readable title of the unit\\&. This may be used by B " "(and other UIs) as a user-visible label for the unit, so this string should " "identify the unit rather than describe it, despite the name\\&. This string " "also shouldn\\*(Aqt just repeat the unit name\\&. \"Apache2 Web Server\" is " "a good example\\&. Bad examples are \"high-performance light-weight HTTP " "server\" (too generic) or \"Apache2\" (meaningless for people who do not " "know Apache, duplicates the unit name)\\&. B may use this string " "as a noun in status messages (\"Starting I\\&.\\&.\\&.\", " "\"Started I\\&.\", \"Reached target I\\&.\", " "\"Failed to start I\\&.\"), so it should be capitalized, and " "should not be a full sentence, or a phrase with a continuous verb\\&. Bad " "examples include \"exiting the container\" or \"updating the database once " "per day\\&.\"\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 201\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "A space-separated list of URIs referencing documentation for this unit or " "its configuration\\&. Accepted are only URIs of the types \"http://\", " "\"https://\", \"file:\", \"info:\", \"man:\"\\&. For more information about " "the syntax of these URIs, see B(7)\\&. The URIs should be listed in " "order of relevance, starting with the most relevant\\&. It is a good idea to " "first reference documentation that explains what the unit\\*(Aqs purpose is, " "followed by how it is configured, followed by any other related " "documentation\\&. This option may be specified more than once, in which case " "the specified list of URIs is merged\\&. If the empty string is assigned to " "this option, the list is reset and all prior assignments will have no " "effect\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Configures (weak) requirement dependencies on other units\\&. This option " "may be specified more than once or multiple space-separated units may be " "specified in one option in which case dependencies for all listed names will " "be created\\&. Dependencies of this type may also be configured outside of " "the unit configuration file by adding a symlink to a \\&.wants/ directory " "accompanying the unit file\\&. For details, see above\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Units listed in this option will be started if the configuring unit is\\&. " "However, if the listed units fail to start or cannot be added to the " "transaction, this has no impact on the validity of the transaction as a " "whole, and this unit will still be started\\&. This is the recommended way " "to hook the start-up of one unit to the start-up of another unit\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note that requirement dependencies do not influence the order in which " "services are started or stopped\\&. This has to be configured independently " "with the I or I options\\&. If unit foo\\&.service pulls in " "unit bar\\&.service as configured with I and no ordering is " "configured with I or I, then both units will be started " "simultaneously and without any delay between them if foo\\&.service is " "activated\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Similar to I, but declares a stronger requirement dependency\\&. " "Dependencies of this type may also be configured by adding a symlink to a " "\\&.requires/ directory accompanying the unit file\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "If this unit gets activated, the units listed will be activated as well\\&. " "If one of the other units fails to activate, and an ordering dependency " "I on the failing unit is set, this unit will not be started\\&. " "Besides, with or without specifying I, this unit will be stopped (or " "restarted) if one of the other units is explicitly stopped (or restarted)\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Often, it is a better choice to use I instead of I in " "order to achieve a system that is more robust when dealing with failing " "services\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note that this dependency type does not imply that the other unit always has " "to be in active state when this unit is running\\&. Specifically: failing " "condition checks (such as I, " "I, \\&... \\(em see below) do not cause the " "start job of a unit with a I dependency on it to fail\\&. Also, " "some unit types may deactivate on their own (for example, a service process " "may decide to exit cleanly, or a device may be unplugged by the user), which " "is not propagated to units having a I dependency\\&. Use the " "I dependency type together with I to ensure that a unit " "may never be in active state without a specific other unit also in active " "state (see below)\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Similar to I\\&. However, if the units listed here are not " "started already, they will not be started and the starting of this unit will " "fail immediately\\&. I does not imply an ordering dependency, " "even if both units are started in the same transaction\\&. Hence this " "setting should usually be combined with I, to ensure this unit is " "not started before the other unit\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "When I is used on a\\&.service, this dependency will " "show as I in property listing of b\\&.service\\&. " "I dependency cannot be specified directly\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Configures requirement dependencies, very similar in style to " "I\\&. However, this dependency type is stronger: in addition to " "the effect of I it declares that if the unit bound to is stopped, " "this unit will be stopped too\\&. This means a unit bound to another unit " "that suddenly enters inactive state will be stopped too\\&. Units can " "suddenly, unexpectedly enter inactive state for different reasons: the main " "process of a service unit might terminate on its own choice, the backing " "device of a device unit might be unplugged or the mount point of a mount " "unit might be unmounted without involvement of the system and service " "manager\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "When used in conjunction with I on the same unit the behaviour of " "I is even stronger\\&. In this case, the unit bound to strictly " "has to be in active state for this unit to also be in active state\\&. This " "not only means a unit bound to another unit that suddenly enters inactive " "state, but also one that is bound to another unit that gets skipped due to " "an unmet condition check (such as I, " "I, \\&... \\(em see below) will be stopped, " "should it be running\\&. Hence, in many cases it is best to combine " "I with I\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "When I is used on a\\&.service, this dependency will " "show as I in property listing of b\\&.service\\&. " "I dependency cannot be specified directly\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Configures dependencies similar to I, but limited to stopping and " "restarting of units\\&. When systemd stops or restarts the units listed " "here, the action is propagated to this unit\\&. Note that this is a one-way " "dependency\\ \\&\\(em changes to this unit do not affect the listed units\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "When I is used on a\\&.service, this dependency will " "show as I in property listing of b\\&.service\\&. " "I dependency cannot be specified directly\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Configures dependencies similar to I, but as long as this unit is " "up, all units listed in I are started whenever found to be " "inactive or failed, and no job is queued for them\\&. While a I " "dependency on another unit has a one-time effect when this units started, a " "I dependency on it has a continuous effect, constantly restarting " "the unit if necessary\\&. This is an alternative to the I setting " "of service units, to ensure they are kept running whatever happens\\&. The " "restart happens without delay, and usual per-unit rate-limit applies\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "When I is used on a\\&.service, this dependency will " "show as I in the property listing of b\\&.service\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 249\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "A space-separated list of unit names\\&. Configures negative requirement " "dependencies\\&. If a unit has a I setting on another unit, " "starting the former will stop the latter and vice versa\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note that this setting does not imply an ordering dependency, similarly to " "the I and I dependencies described above\\&. This means " "that to ensure that the conflicting unit is stopped before the other unit is " "started, an I or I dependency must be declared\\&. It " "doesn\\*(Aqt matter which of the two ordering dependencies is used, because " "stop jobs are always ordered before start jobs, see the discussion in " "I/I below\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "If unit A that conflicts with unit B is scheduled to be started at the same " "time as B, the transaction will either fail (in case both are required parts " "of the transaction) or be modified to be fixed (in case one or both jobs are " "not a required part of the transaction)\\&. In the latter case, the job that " "is not required will be removed, or in case both are not required, the unit " "that conflicts will be started and the unit that is conflicted is stopped\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I, I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "These two settings expect a space-separated list of unit names\\&. They may " "be specified more than once, in which case dependencies for all listed names " "are created\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Those two settings configure ordering dependencies between units\\&. If unit " "foo\\&.service contains the setting B and both units " "are being started, bar\\&.service\\*(Aqs start-up is delayed until foo\\&." "service has finished starting up\\&. I is the inverse of " "I, i\\&.e\\&. while I ensures that the configured unit is " "started before the listed unit begins starting up, I ensures the " "opposite, that the listed unit is fully started up before the configured " "unit is started\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "When two units with an ordering dependency between them are shut down, the " "inverse of the start-up order is applied\\&. I\\&.e\\&. if a unit is " "configured with I on another unit, the former is stopped before the " "latter if both are shut down\\&. Given two units with any ordering " "dependency between them, if one unit is shut down and the other is started " "up, the shutdown is ordered before the start-up\\&. It doesn\\*(Aqt matter " "if the ordering dependency is I or I, in this case\\&. It " "also doesn\\*(Aqt matter which of the two is shut down, as long as one is " "shut down and the other is started up; the shutdown is ordered before the " "start-up in all cases\\&. If two units have no ordering dependencies between " "them, they are shut down or started up simultaneously, and no ordering takes " "place\\&. It depends on the unit type when precisely a unit has finished " "starting up\\&. Most importantly, for service units start-up is considered " "completed for the purpose of I/I when all its configured " "start-up commands have been invoked and they either failed or reported start-" "up success\\&. Note that this does includes I (or " "I for the shutdown case)\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note that those settings are independent of and orthogonal to the " "requirement dependencies as configured by I, I, " "I, or I\\&. It is a common pattern to include a unit " "name in both the I and I options, in which case the unit " "listed will be started before the unit that is configured with these " "options\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note that I dependencies on device units have no effect and are not " "supported\\&. Devices generally become available as a result of an external " "hotplug event, and systemd creates the corresponding device unit without " "delay\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "A space-separated list of one or more units that are activated when this " "unit enters the \"failed\" state\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "A space-separated list of one or more units that are activated when this " "unit enters the \"inactive\" state\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I, I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "A space-separated list of one or more units to which reload requests from " "this unit shall be propagated to, or units from which reload requests shall " "be propagated to this unit, respectively\\&. Issuing a reload request on a " "unit will automatically also enqueue reload requests on all units that are " "linked to it using these two settings\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I, I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "A space-separated list of one or more units to which stop requests from this " "unit shall be propagated to, or units from which stop requests shall be " "propagated to this unit, respectively\\&. Issuing a stop request on a unit " "will automatically also enqueue stop requests on all units that are linked " "to it using these two settings\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "For units that start processes (such as service units), lists one or more " "other units whose network and/or temporary file namespace to join\\&. If " "this is specified on a unit (say, a\\&.service has I), then the inverse dependency (I for " "b\\&.service) is implied\\&. This only applies to unit types which support " "the I, I, I, " "I, and I directives (see B(5) " "for details)\\&. If a unit that has this setting set is started, its " "processes will see the same /tmp/, /var/tmp/, IPC namespace and network " "namespace as one listed unit that is started\\&. If multiple listed units " "are already started and these do not share their namespace, then it is not " "defined which namespace is joined\\&. Note that this setting only has an " "effect if I/I, I/" "I and/or I is enabled for both the unit that " "joins the namespace and the unit whose namespace is joined\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 209\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Takes a space-separated list of absolute paths\\&. Automatically adds " "dependencies of type I and I for all mount units required " "to access the specified path\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Mount points marked with B are not mounted automatically through " "local-fs\\&.target, but are still honored for the purposes of this option, " "i\\&.e\\&. they will be pulled in by this unit\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I, I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Takes a value of \"fail\", \"replace\", \"replace-irreversibly\", " "\"isolate\", \"flush\", \"ignore-dependencies\" or \"ignore-" "requirements\"\\&. Defaults to \"replace\"\\&. Specifies how the units " "listed in I/I will be enqueued\\&. See " "B(1)\\*(Aqs B<--job-mode=> option for details on the possible " "values\\&. If this is set to \"isolate\", only a single unit may be listed " "in I/I\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Takes a boolean argument\\&. If B, this unit will not be stopped when " "isolating another unit\\&. Defaults to B for service, target, socket, " "timer, and path units, and B for slice, scope, device, swap, mount, " "and automount units\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Takes a boolean argument\\&. If B, this unit will be stopped when it " "is no longer used\\&. Note that, in order to minimize the work to be " "executed, systemd will not stop units by default unless they are conflicting " "with other units, or the user explicitly requested their shut down\\&. If " "this option is set, a unit will be automatically cleaned up if no other " "active unit requires it\\&. Defaults to B\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I, I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Takes a boolean argument\\&. If B, this unit can only be activated or " "deactivated indirectly\\&. In this case, explicit start-up or termination " "requested by the user is denied, however if it is started or stopped as a " "dependency of another unit, start-up or termination will succeed\\&. This is " "mostly a safety feature to ensure that the user does not accidentally " "activate units that are not intended to be activated explicitly, and not " "accidentally deactivate units that are not intended to be deactivated\\&. " "These options default to B\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Takes a boolean argument\\&. If B, this unit may be used with the " "B command\\&. Otherwise, this will be refused\\&. It " "probably is a good idea to leave this disabled except for target units that " "shall be used similar to runlevels in SysV init systems, just as a " "precaution to avoid unusable system states\\&. This option defaults to " "B\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Takes a boolean argument\\&. If B, (the default), a few default " "dependencies will implicitly be created for the unit\\&. The actual " "dependencies created depend on the unit type\\&. For example, for service " "units, these dependencies ensure that the service is started only after " "basic system initialization is completed and is properly terminated on " "system shutdown\\&. See the respective man pages for details\\&. Generally, " "only services involved with early boot or late shutdown should set this " "option to B\\&. It is highly recommended to leave this option enabled " "for the majority of common units\\&. If set to B, this option does not " "disable all implicit dependencies, just non-essential ones\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "Takes a boolean argument\\&. Defaults to B\\&. If B, processes " "belonging to this unit will not be sent the final \"SIGTERM\" and " "\"SIGKILL\" signals during the final phase of the system shutdown " "process\\&. This functionality replaces the older mechanism that allowed a " "program to set \"argv[0][0] = \\*(Aq@\\*(Aq\" as described at " "\\m[blue]B\\m[]\\&\\s-2\\u[2]\\d\\s+2, which however continues to be " "supported\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 255\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Tweaks the \"garbage collection\" algorithm for this unit\\&. Takes one of " "B or B\\&. If set to B the unit will " "be unloaded if it is in the B state and is not referenced by " "clients, jobs or other units \\(em however it is not unloaded if it is in " "the B state\\&. In B mode, failed units are not unloaded " "until the user invoked B on them to reset the " "B state, or an equivalent command\\&. This behaviour is altered if " "this option is set to B: in this case the unit is " "unloaded even if the unit is in a B state, and thus an explicitly " "resetting of the B state is not necessary\\&. Note that if this mode " "is used unit results (such as exit codes, exit signals, consumed resources, " "\\&...) are flushed out immediately after the unit completed, except for " "what is stored in the logging subsystem\\&. Defaults to B\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 236\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I, I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Configure the action to take when the unit stops and enters a failed state " "or inactive state\\&. Takes one of B, B, B, " "B, B, B, B, " "B, B, B, B, B, " "B, B, B and B\\&. In system " "mode, all options are allowed\\&. In user mode, only B, B, " "B, B and B are allowed\\&. Both " "options default to B\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "If B is set, no action will be triggered\\&. B causes a " "reboot following the normal shutdown procedure (i\\&.e\\&. equivalent to " "B)\\&. B causes a forced reboot which will " "terminate all processes forcibly but should cause no dirty file systems on " "reboot (i\\&.e\\&. equivalent to B) and B causes immediate execution of the B(2) system call, " "which might result in data loss (i\\&.e\\&. equivalent to B)\\&. Similarly, B, B, B, " "B, B, B, B and B have " "the effect of powering down the system, executing kexec, and halting the " "system respectively with similar semantics\\&. B causes the manager " "to exit following the normal shutdown procedure, and B causes it " "terminate without shutting down services\\&. When B or B " "is used by default the exit status of the main process of the unit (if this " "applies) is returned from the service manager\\&. However, this may be " "overridden with I/I, see " "below\\&. B will trigger a userspace reboot operation\\&. " "B does that too, but does not go through the shutdown " "transaction beforehand\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I, I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Controls the exit status to propagate back to an invoking container manager " "(in case of a system service) or service manager (in case of a user manager) " "when the I/I are set to B or B and the action is triggered\\&. By default the exit status of the " "main process of the triggering unit (if this applies) is propagated\\&. " "Takes a value in the range 0\\&...255 or the empty string to request default " "behaviour\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 240\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I, I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I specifies a timeout for the whole job that starts running " "when the job is queued\\&. I specifies a timeout " "that starts running when the queued job is actually started\\&. If either " "limit is reached, the job will be cancelled, the unit however will not " "change state or even enter the \"failed\" mode\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Both settings take a time span with the default unit of seconds, but other " "units may be specified, see B(5)\\&. The default is " "\"infinity\" (job timeouts disabled), except for device units where " "I defaults to I\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note: these timeouts are independent from any unit-specific timeouts (for " "example, the timeout set with I in service units)\\&. The " "job timeout has no effect on the unit itself\\&. Or in other words: unit-" "specific timeouts are useful to abort unit state changes, and revert " "them\\&. The job timeout set with this option however is useful to abort " "only the job waiting for the unit state to change\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I, I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I optionally configures an additional action to take when " "the timeout is hit, see description of I and " "I above\\&. It takes the same values as " "I\\&. Defaults to B\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I configures an optional reboot string to pass to " "the B(2) system call\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "II, II" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Configure unit start rate limiting\\&. Units which are started more than " "I times within an I time span are not permitted to start " "any more\\&. Use I to configure the checking " "interval and I to configure how many starts per interval " "are allowed\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "I is a time span with the default unit of seconds, but other units " "may be specified, see B(5)\\&. The special value \"infinity\" " "can be used to limit the total number of start attempts, even if they happen " "at large time intervals\\&. Defaults to I in " "manager configuration file, and may be set to 0 to disable any kind of rate " "limiting\\&. I is a number and defaults to " "I in manager configuration file\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "These configuration options are particularly useful in conjunction with the " "service setting I (see B(5)); however, they apply " "to all kinds of starts (including manual), not just those triggered by the " "I logic\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note that units which are configured for I, and which reach the " "start limit are not attempted to be restarted anymore; however, they may " "still be restarted manually or from a timer or socket at a later point, " "after the I has passed\\&. From that point on, the restart logic " "is activated again\\&. B will cause the restart " "rate counter for a service to be flushed, which is useful if the " "administrator wants to manually start a unit and the start limit interferes " "with that\\&. Rate-limiting is enforced after any unit condition checks are " "executed, and hence unit activations with failing conditions do not count " "towards the rate limit\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "When a unit is unloaded due to the garbage collection logic (see above) its " "rate limit counters are flushed out too\\&. This means that configuring " "start rate limiting for a unit that is not referenced continuously has no " "effect\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "This setting does not apply to slice, target, device, and scope units, since " "they are unit types whose activation may either never fail, or may succeed " "only a single time\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 229\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Configure an additional action to take if the rate limit configured with " "I and I is hit\\&. Takes the same " "values as the I/I settings\\&. If B is " "set, hitting the rate limit will trigger no action except that the start " "will not be permitted\\&. Defaults to B\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Configure the optional argument for the B(2) system call if " "I or I is a reboot action\\&. This works " "just like the optional argument to B command\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "A path to a configuration file this unit has been generated from\\&. This is " "primarily useful for implementation of generator tools that convert " "configuration from an external configuration file format into native unit " "files\\&. This functionality should not be used in normal units\\&." msgstr "" #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Conditions and Asserts" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Unit files may also include a number of I and " "I settings\\&. Before the unit is started, systemd will " "verify that the specified conditions and asserts are true\\&. If not, the " "starting of the unit will be (mostly silently) skipped (in case of " "conditions), or aborted with an error message (in case of asserts)\\&. " "Failing conditions or asserts will not result in the unit being moved into " "the \"failed\" state\\&. The conditions and asserts are checked at the time " "the queued start job is to be executed\\&. The ordering dependencies are " "still respected, so other units are still pulled in and ordered as if this " "unit was successfully activated, and the conditions and asserts are executed " "the precise moment the unit would normally start and thus can validate " "system state after the units ordered before completed initialization\\&. Use " "condition expressions for skipping units that do not apply to the local " "system, for example because the kernel or runtime environment doesn\\*(Aqt " "require their functionality\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "If multiple conditions are specified, the unit will be executed if all of " "them apply (i\\&.e\\&. a logical AND is applied)\\&. Condition checks can " "use a pipe symbol (\"|\") after the equals sign (\"Condition\\&...=|\\&..." "\"), which causes the condition to become a I condition\\&. If " "at least one triggering condition is defined for a unit, then the unit will " "be started if at least one of the triggering conditions of the unit applies " "and all of the regular (i\\&.e\\&. non-triggering) conditions apply\\&. If " "you prefix an argument with the pipe symbol and an exclamation mark, the " "pipe symbol must be passed first, the exclamation second\\&. If any of these " "options is assigned the empty string, the list of conditions is reset " "completely, all previous condition settings (of any kind) will have no " "effect\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The I, I, \\&... options are " "similar to conditions but cause the start job to fail (instead of being " "skipped)\\&. The failed check is logged\\&. Units with unmet conditions are " "considered to be in a clean state and will be garbage collected if they are " "not referenced\\&. This means that when queried, the condition failure may " "or may not show up in the state of the unit\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note that neither assertion nor condition expressions result in unit state " "changes\\&. Also note that both are checked at the time the job is to be " "executed, i\\&.e\\&. long after depending jobs and it itself were queued\\&. " "Thus, neither condition nor assertion expressions are suitable for " "conditionalizing unit dependencies\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The B verb of B(1) can be used to test " "condition and assert expressions\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Except for I, all path checks follow " "symlinks\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Check whether the system is running on a specific architecture\\&. Takes one " "of \"x86\", \"x86-64\", \"ppc\", \"ppc-le\", \"ppc64\", \"ppc64-le\", " "\"ia64\", \"parisc\", \"parisc64\", \"s390\", \"s390x\", \"sparc\", " "\"sparc64\", \"mips\", \"mips-le\", \"mips64\", \"mips64-le\", \"alpha\", " "\"arm\", \"arm-be\", \"arm64\", \"arm64-be\", \"sh\", \"sh64\", \"m68k\", " "\"tilegx\", \"cris\", \"arc\", \"arc-be\", or \"native\"\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The architecture is determined from the information returned by B(2) " "and is thus subject to B(2)\\&. Note that a I " "setting in the same unit file has no effect on this condition\\&. A special " "architecture name \"native\" is mapped to the architecture the system " "manager itself is compiled for\\&. The test may be negated by prepending an " "exclamation mark\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Check whether the system\\*(Aqs firmware is of a certain type\\&. The " "following values are possible:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "\"uefi\" matches systems with EFI\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "\"device-tree\" matches systems with a device tree\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "\"device-tree-compatible(I)\" matches systems with a device tree that " "are compatible with \"value\"\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "\"smbios-field(I I I)\" matches systems with a " "SMBIOS field containing a certain value\\&. I is the name of the " "SMBIOS field exposed as \"sysfs\" attribute file below /sys/class/dmi/id/" "\\&. I is one of \"E\", \"E=\", \"E=\", \"E\", " "\"==\", \"EE\" for version comparisons, \"=\" and \"!=\" for literal " "string comparisons, or \"$=\", \"!$=\" for shell-style glob comparisons\\&. " "I is the expected value of the SMBIOS field value (possibly " "containing shell style globs in case \"$=\"/\"!$=\" is used)\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Check whether the system is executed in a virtualized environment and " "optionally test whether it is a specific implementation\\&. Takes either " "boolean value to check if being executed in any virtualized environment, or " "one of \"vm\" and \"container\" to test against a generic type of " "virtualization solution, or one of \"qemu\", \"kvm\", \"amazon\", \"zvm\", " "\"vmware\", \"microsoft\", \"oracle\", \"powervm\", \"xen\", \"bochs\", " "\"uml\", \"bhyve\", \"qnx\", \"apple\", \"sre\", \"openvz\", \"lxc\", \"lxc-" "libvirt\", \"systemd-nspawn\", \"docker\", \"podman\", \"rkt\", \"wsl\", " "\"proot\", \"pouch\", \"acrn\" to test against a specific implementation, or " "\"private-users\" to check whether we are running in a user namespace\\&. " "See B(1) for a full list of known virtualization " "technologies and their identifiers\\&. If multiple virtualization " "technologies are nested, only the innermost is considered\\&. The test may " "be negated by prepending an exclamation mark\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 244\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I may be used to match against the hostname or machine ID of " "the host\\&. This either takes a hostname string (optionally with shell " "style globs) which is tested against the locally set hostname as returned by " "B(2), or a machine ID formatted as string (see B(5))\\&. The test may be negated by prepending an exclamation mark\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I may be used to check whether a specific " "kernel command line option is set (or if prefixed with the exclamation mark " "\\(em unset)\\&. The argument must either be a single word, or an assignment " "(i\\&.e\\&. two words, separated by \"=\")\\&. In the former case the kernel " "command line is searched for the word appearing as is, or as left hand side " "of an assignment\\&. In the latter case, the exact assignment is looked for " "with right and left hand side matching\\&. This operates on the kernel " "command line communicated to userspace via /proc/cmdline, except when the " "service manager is invoked as payload of a container manager, in which case " "the command line of PID 1 is used instead (i\\&.e\\&. /proc/1/cmdline)\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I may be used to check whether the kernel version " "(as reported by B) matches a certain expression, or if prefixed " "with the exclamation mark, does not match\\&. The argument must be a list of " "(potentially quoted) expressions\\&. Each expression starts with one of " "\"=\" or \"!=\" for string comparisons, \"E\", \"E=\", \"==\", " "\"EE\", \"E=\", \"E\" for version comparisons, or \"$=\", \"!" "$=\" for a shell-style glob match\\&. If no operator is specified, \"$=\" is " "implied\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note that using the kernel version string is an unreliable way to determine " "which features are supported by a kernel, because of the widespread practice " "of backporting drivers, features, and fixes from newer upstream kernels into " "older versions provided by distributions\\&. Hence, this check is inherently " "unportable and should not be used for units which may be used on different " "distributions\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "I may be used to check whether a credential by the " "specified name was passed into the service manager\\&. See \\m[blue]B\\m[]\\&\\s-2\\u[3]\\d\\s+2 for details about " "credentials\\&. If used in services for the system service manager this may " "be used to conditionalize services based on system credentials passed in\\&. " "If used in services for the per-user service manager this may be used to " "conditionalize services based on credentials passed into the unit@\\&." "service service instance belonging to the user\\&. The argument must be a " "valid credential name\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 252\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I may be used to check whether a specific environment " "variable is set (or if prefixed with the exclamation mark \\(em unset) in " "the service manager\\*(Aqs environment block\\&. The argument may be a " "single word, to check if the variable with this name is defined in the " "environment block, or an assignment (\"I=I\"), to check if the " "variable with this exact value is defined\\&. Note that the environment " "block of the service manager itself is checked, i\\&.e\\&. not any variables " "defined with I or I, as described above\\&. " "This is particularly useful when the service manager runs inside a " "containerized environment or as per-user service manager, in order to check " "for variables passed in by the enclosing container manager or PAM\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 246\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "I may be used to check whether the given security " "technology is enabled on the system\\&. Currently, the following values are " "recognized:" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "B" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "Value" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "selinux" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "SELinux MAC" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "apparmor" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "AppArmor MAC" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "tomoyo" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "Tomoyo MAC" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "smack" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "SMACK MAC" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "ima" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "Integrity Measurement Architecture (IMA)" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "audit" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "Linux Audit Framework" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "uefi-secureboot" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "UEFI SecureBoot" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "tpm2" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "Trusted Platform Module 2\\&.0 (TPM2)" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "cvm" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "Confidential virtual machine (SEV/TDX)" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "measured-uki" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "Unified Kernel Image with PCR 11 Measurements, as per B(7)\\&. Added in version 255\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "The test may be negated by prepending an exclamation mark\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Check whether the given capability exists in the capability bounding set of " "the service manager (i\\&.e\\&. this does not check whether capability is " "actually available in the permitted or effective sets, see " "B(7) for details)\\&. Pass a capability name such as " "\"CAP_MKNOD\", possibly prefixed with an exclamation mark to negate the " "check\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Check whether the system has AC power, or is exclusively battery powered at " "the time of activation of the unit\\&. This takes a boolean argument\\&. If " "set to \"true\", the condition will hold only if at least one AC connector " "of the system is connected to a power source, or if no AC connectors are " "known\\&. Conversely, if set to \"false\", the condition will hold only if " "there is at least one AC connector known and all AC connectors are " "disconnected from a power source\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Takes one of /var/ or /etc/ as argument, possibly prefixed with a \"!\" (to " "invert the condition)\\&. This condition may be used to conditionalize units " "on whether the specified directory requires an update because /usr/\\*(Aqs " "modification time is newer than the stamp file \\&.updated in the specified " "directory\\&. This is useful to implement offline updates of the vendor " "operating system resources in /usr/ that require updating of /etc/ or /var/ " "on the next following boot\\&. Units making use of this condition should " "order themselves before B(8), to make sure they " "run before the stamp file\\*(Aqs modification time gets reset indicating a " "completed update\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "If the I 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 " "I checks, until the system is rebooted where the " "kernel command line option is not specified anymore\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note that to make this scheme effective, the timestamp of /usr/ should be " "explicitly updated after its contents are modified\\&. The kernel will " "automatically update modification timestamp on a directory only when " "immediate children of a directory are modified; an modification of nested " "files will not automatically result in mtime of /usr/ being updated\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Also note that if the update method includes a call to execute appropriate " "post-update steps itself, it should not touch the timestamp of /usr/\\&. In " "a typical distribution packaging scheme, packages will do any required " "update steps as part of the installation or upgrade, to make package " "contents immediately usable\\&. I should be used " "with other update mechanisms where such an immediate update does not " "happen\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Takes a boolean argument\\&. This condition may be used to conditionalize " "units on 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 B(5))\\&. First " "boot is considered finished (this condition will evaluate as false) after " "the manager has finished the startup phase\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "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\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "For robustness, units with I should order themselves " "before first-boot-complete\\&.target and pull in this passive target with " "I\\&. This ensures that in a case of an aborted first boot, these " "units will be re-run during the next system startup\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "If the I 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\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Check for the existence of a file\\&. If the specified absolute path name " "does not exist, the condition will fail\\&. If the absolute path name passed " "to I is prefixed with an exclamation mark (\"!\"), the " "test is negated, and the unit is only started if the path does not exist\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I is similar to I, but " "checks for the existence of at least one file or directory matching the " "specified globbing pattern\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I is similar to I but " "verifies that a certain path exists and is a directory\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I is similar to I but " "verifies that a certain path exists and is a symbolic link\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I is similar to I but " "verifies that a certain path exists and is a mount point\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I is similar to I but " "verifies that the underlying file system is readable and writable (i\\&." "e\\&. not mounted read-only)\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I is similar to I but " "verifies that the underlying file system\\*(Aqs backing block device is " "encrypted using dm-crypt/LUKS\\&. Note that this check does not cover ext4 " "per-directory encryption, and only detects block level encryption\\&. " "Moreover, if the specified path resides on a file system on top of a " "loopback block device, only encryption above the loopback device is " "detected\\&. It is not detected whether the file system backing the loopback " "block device is encrypted\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I is similar to I but " "verifies that a certain path exists and is a non-empty directory\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I is similar to I but verifies " "that a certain path exists and refers to a regular file with a non-zero " "size\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I is similar to I but " "verifies that a certain path exists, is a regular file, and marked " "executable\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I takes a numeric \"UID\", a UNIX user name, or the special " "value \"@system\"\\&. This condition may be used to check whether the " "service manager is running as the given user\\&. The special value " "\"@system\" can be used to check if the user id is within the system user " "range\\&. This option is not useful for system services, as the system " "manager exclusively runs as the root user, and thus the test result is " "constant\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I is similar to I but verifies that the " "service manager\\*(Aqs real or effective group, or any of its auxiliary " "groups, match the specified group or GID\\&. This setting does not support " "the special value \"@system\"\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Check whether given cgroup controllers (e\\&.g\\&. \"cpu\") are available " "for use on the system or whether the legacy v1 cgroup or the modern v2 " "cgroup hierarchy is used\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Multiple controllers may be passed with a space separating them; in this " "case the condition will only pass if all listed controllers are available " "for use\\&. Controllers unknown to systemd are ignored\\&. Valid controllers " "are \"cpu\", \"io\", \"memory\", and \"pids\"\\&. Even if available in the " "kernel, a particular controller may not be available if it was disabled on " "the kernel command line with I\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Alternatively, two special strings \"v1\" and \"v2\" may be specified " "(without any controller names)\\&. \"v2\" will pass if the unified v2 " "cgroup hierarchy is used, and \"v1\" will pass if the legacy v1 hierarchy or " "the hybrid hierarchy are used\\&. Note that legacy or hybrid hierarchies " "have been deprecated\\&. See B(1) for more information\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Verify that the specified amount of system memory is available to the " "current system\\&. Takes a memory size in bytes as argument, optionally " "prefixed with a comparison operator \"E\", \"E=\", \"=\" (or " "\"==\"), \"!=\" (or \"EE\"), \"E=\", \"E\"\\&. On bare-metal " "systems compares the amount of physical memory in the system with the " "specified size, adhering to the specified comparison operator\\&. In " "containers compares the amount of memory assigned to the container " "instead\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Verify that the specified number of CPUs is available to the current " "system\\&. Takes a number of CPUs as argument, optionally prefixed with a " "comparison operator \"E\", \"E=\", \"=\" (or \"==\"), \"!=\" (or " "\"EE\"), \"E=\", \"E\"\\&. Compares the number of CPUs in " "the CPU affinity mask configured of the service manager itself with the " "specified number, adhering to the specified comparison operator\\&. On " "physical systems the number of CPUs in the affinity mask of the service " "manager usually matches the number of physical CPUs, but in special and " "virtual environments might differ\\&. In particular, in containers the " "affinity mask usually matches the number of CPUs assigned to the container " "and not the physically available ones\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Verify that a given CPU feature is available via the \"CPUID\" " "instruction\\&. This condition only does something on i386 and x86-64 " "processors\\&. On other processors it is assumed that the CPU does not " "support the given feature\\&. It checks the leaves \"1\", \"7\", " "\"0x80000001\", and \"0x80000007\"\\&. Valid values are: \"fpu\", \"vme\", " "\"de\", \"pse\", \"tsc\", \"msr\", \"pae\", \"mce\", \"cx8\", \"apic\", " "\"sep\", \"mtrr\", \"pge\", \"mca\", \"cmov\", \"pat\", \"pse36\", " "\"clflush\", \"mmx\", \"fxsr\", \"sse\", \"sse2\", \"ht\", \"pni\", " "\"pclmul\", \"monitor\", \"ssse3\", \"fma3\", \"cx16\", \"sse4_1\", " "\"sse4_2\", \"movbe\", \"popcnt\", \"aes\", \"xsave\", \"osxsave\", \"avx\", " "\"f16c\", \"rdrand\", \"bmi1\", \"avx2\", \"bmi2\", \"rdseed\", \"adx\", " "\"sha_ni\", \"syscall\", \"rdtscp\", \"lm\", \"lahf_lm\", \"abm\", " "\"constant_tsc\"\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 248\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Verify that a specific \"key=value\" pair is set in the host\\*(Aqs B(5)\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Other than exact string matching (with \"=\" and \"!=\"), relative " "comparisons are supported for versioned parameters (e\\&.g\\&. " "\"VERSION_ID\"; with \"E\", \"E=\", \"==\", \"EE\", " "\"E=\", \"E\"), and shell-style wildcard comparisons (\"*\", \"?\", " "\"[]\") are supported with the \"$=\" (match) and \"!$=\" (non-match)\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I, I, " "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "Verify that the overall system (memory, CPU or IO) pressure is below or " "equal to a threshold\\&. This setting takes a threshold value as " "argument\\&. It can be specified as a simple percentage value, suffixed with " "\"%\", in which case the pressure will be measured as an average over the " "last five minutes before the attempt to start the unit is performed\\&. " "Alternatively, the average timespan can also be specified using \"/\" as a " "separator, for example: \"10%/1min\"\\&. The supported timespans match what " "the kernel provides, and are limited to \"10sec\", \"1min\" and \"5min\"\\&. " "The \"full\" PSI will be checked first, and if not found \"some\" will be " "checked\\&. For more details, see the documentation on \\m[blue]B\\m[]\\&\\s-2\\u[4]\\d\\s+2\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Optionally, the threshold value can be prefixed with the slice unit under " "which the pressure will be checked, followed by a \":\"\\&. If the slice " "unit is not specified, the overall system pressure will be measured, instead " "of a particular cgroup\\*(Aqs\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 250\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I, I, I, " "I, I, I, " "I, I, I, " "I, I, I, " "I, I, I, " "I, I, " "I, I, " "I, I, " "I, I, I, " "I, I, I, " "I, I, I, " "I, I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Similar to the I, I, " "\\&..., condition settings described above, these settings add assertion " "checks to the start-up of the unit\\&. However, unlike the conditions " "settings, any assertion setting that is not met results in failure of the " "start job (which means this is logged loudly)\\&. Note that hitting a " "configured assertion does not cause the unit to enter the \"failed\" state " "(or in fact result in any state change of the unit), it affects only the job " "queued for it\\&. Use assertion expressions for units that cannot operate " "when specific requirements are not met, and when this is something the " "administrator or user should look into\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 218\\&." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "MAPPING OF UNIT PROPERTIES TO THEIR INVERSES" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Unit settings that create a relationship with a second unit usually show up " "in properties of both units, for example in B output\\&. In " "some cases the name of the property is the same as the name of the " "configuration setting, but not always\\&. This table lists the properties " "that are shown on two units which are connected through some dependency, and " "shows which property on \"source\" unit corresponds to which property on the " "\"target\" unit\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "B" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "\"Forward\" property" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "\"Reverse\" property" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Where used" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "l l l s" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "l l ^ ^" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "l l l l" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "l l l l." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "[Unit] section" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "[Install] section" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "an automatic property" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Automatic properties, see notes below" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "n/a" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "An automatic property" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "\\ \\&" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note: I, I, and I are used in the " "[Install] section to create symlinks in \\&.wants/, \\&.requires/, and \\&." "upholds/ directories\\&. They cannot be used directly as a unit " "configuration setting\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note: I, I, I, I are " "created implicitly along with their reverses and cannot be specified " "directly\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note: I is created implicitly between a socket, path unit, or an " "automount unit, and the unit they activate\\&. By default a unit with the " "same name is triggered, but this can be overridden using I, " "I, and I settings\\&. See B(5), B(5), B(5), and B(5) for " "details\\&. I is created implicitly on the triggered unit\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note: I is used to group device aliases and points to the " "\"primary\" device unit that systemd is using to track device state, usually " "corresponding to a sysfs path\\&. It does not show up in the \"target\" " "unit\\&." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "[INSTALL] SECTION OPTIONS" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Unit files may include an [Install] section, which carries installation " "information for the unit\\&. This section is not interpreted by " "B(1) during runtime; it is used by the B and B " "commands of the B(1) tool during installation of a unit\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "A space-separated list of additional names this unit shall be installed " "under\\&. The names listed here must have the same suffix (i\\&.e\\&. type) " "as the unit filename\\&. This option may be specified more than once, in " "which case all listed names are used\\&. At installation time, B will create symlinks from these names to the unit filename\\&. Note " "that not all unit types support such alias names, and this setting is not " "supported for them\\&. Specifically, mount, slice, swap, and automount units " "do not support aliasing\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I, I, I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "This option may be used more than once, or a space-separated list of unit " "names may be given\\&. A symbolic link is created in the \\&.wants/, \\&." "requires/, or \\&.upholds/ directory of each of the listed units when this " "unit is installed by B\\&. This has the effect of a " "dependency of type I, I, or I being added from " "the listed unit to the current unit\\&. See the description of the mentioned " "dependency types in the [Unit] section for details\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "In case of template units listing non template units, the listing unit must " "have I set, or B must be called with an " "instance name\\&. The instance (default or specified) will be added to the " "\\&.wants/, \\&.requires/, or \\&.upholds/ list of the listed unit\\&. For " "example, B in a service getty@\\&.service will " "result in B creating a getty\\&." "target\\&.wants/getty@tty2\\&.service link to getty@\\&.service\\&. This " "also applies to listing specific instances of templated units: this specific " "instance will gain the dependency\\&. A template unit may also list a " "template unit, in which case a generic dependency will be added where each " "instance of the listing unit will have a dependency on an instance of the " "listed template with the same instance value\\&. For example, " "B in a service monitor@\\&.service will " "result in B creating a container@\\&." "target\\&.wants/monitor@\\&.service link to monitor@\\&.service, which " "applies to all instances of container@\\&.target\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Additional units to install/deinstall when this unit is installed/" "deinstalled\\&. If the user requests installation/deinstallation of a unit " "with this option configured, B and B " "will automatically install/uninstall units listed in this option as well\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "This option may be used more than once, or a space-separated list of unit " "names may be given\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "In template unit files, this specifies for which instance the unit shall be " "enabled if the template is enabled without any explicitly set instance\\&. " "This option has no effect in non-template unit files\\&. The specified " "string must be usable as instance identifier\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 215\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The following specifiers are interpreted in the Install section: %a, %b, %B, " "%g, %G, %H, %i, %j, %l, %m, %n, %N, %o, %p, %u, %U, %v, %w, %W, %%\\&. For " "their meaning see the next section\\&." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "SPECIFIERS" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Many settings resolve specifiers which may be used to write generic unit " "files referring to runtime or unit parameters that are replaced when the " "unit files are loaded\\&. Specifiers must be known and resolvable for the " "setting to be valid\\&. The following specifiers are understood:" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "B" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Specifier" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Meaning" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Details" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "l l l" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "l l l." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%a" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Architecture" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "A short string identifying the architecture of the local system\\&. A string such as B, B or B\\&. See the architectures defined for I above for a full list\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%A" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Operating system image version" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "The operating system image version identifier of the running system, as read from the I field of /etc/os-release\\&. If not set, resolves to an empty string\\&. See B(5) for more information\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%b" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Boot ID" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "The boot ID of the running system, formatted as string\\&. See B(4) for more information\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%B" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Operating system build ID" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "The operating system build identifier of the running system, as read from the I field of /etc/os-release\\&. If not set, resolves to an empty string\\&. See B(5) for more information\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%C" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Cache directory root" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is either /var/cache (for the system manager) or the path \"$XDG_CACHE_HOME\" resolves to (for user managers)\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%d" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Credentials directory" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is the value of the \"$CREDENTIALS_DIRECTORY\" environment variable if available\\&. See section \"Credentials\" in B(5) for more information\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%E" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Configuration directory root" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is either /etc/ (for the system manager) or the path \"$XDG_CONFIG_HOME\" resolves to (for user managers)\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%f" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Unescaped filename" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is either the unescaped instance name (if applicable) with / prepended (if applicable), or the unescaped prefix name prepended with /\\&. This implements unescaping according to the rules for escaping absolute file system paths discussed above\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%g" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "User group" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is the name of the group running the service manager instance\\&. In case of the system manager this resolves to \"root\"\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%G" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "User GID" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is the numeric GID of the user running the service manager instance\\&. In case of the system manager this resolves to \"0\"\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%h" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "User home directory" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "This is the home directory of the I\\&. In case of the system manager this resolves to \"/root\"\\&.\n" "\n" "Note that this setting is I influenced by the I setting configurable in the [Service] section of the service unit\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%H" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Host name" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "The hostname of the running system at the point in time the unit configuration is loaded\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%i" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Instance name" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "For instantiated units this is the string between the first \"@\" character and the type suffix\\&. Empty for non-instantiated units\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%I" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Unescaped instance name" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Same as \"%i\", but with escaping undone\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%j" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Final component of the prefix" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is the string between the last \"-\" and the end of the prefix name\\&. If there is no \"-\", this is the same as \"%p\"\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%J" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Unescaped final component of the prefix" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Same as \"%j\", but with escaping undone\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%l" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Short host name" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "The hostname of the running system at the point in time the unit configuration is loaded, truncated at the first dot to remove any domain component\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%L" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Log directory root" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is either /var/log (for the system manager) or the path I<$XDG_STATE_HOME> resolves to with /log appended (for user managers)\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%m" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Machine ID" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "The machine ID of the running system, formatted as string\\&. See B(5) for more information\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%M" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Operating system image identifier" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "The operating system image identifier of the running system, as read from the I field of /etc/os-release\\&. If not set, resolves to an empty string\\&. See B(5) for more information\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%n" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Full unit name" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%N" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Same as \"%n\", but with the type suffix removed\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%o" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Operating system ID" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "The operating system identifier of the running system, as read from the I field of /etc/os-release\\&. See B(5) for more information\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%p" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Prefix name" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "For instantiated units, this refers to the string before the first \"@\" character of the unit name\\&. For non-instantiated units, same as \"%N\"\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%P" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Unescaped prefix name" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Same as \"%p\", but with escaping undone\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%q" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Pretty host name" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "The pretty hostname of the running system at the point in time the unit configuration is loaded, as read from the I field of /etc/machine-info\\&. If not set, resolves to the short hostname\\&. See B(5) for more information\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%s" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "User shell" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is the shell of the user running the service manager instance\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%S" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "State directory root" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is either /var/lib (for the system manager) or the path I<$XDG_STATE_HOME> resolves to (for user managers)\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%t" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Runtime directory root" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is either /run/ (for the system manager) or the path \"$XDG_RUNTIME_DIR\" resolves to (for user managers)\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%T" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Directory for temporary files" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is either /tmp or the path \"$TMPDIR\", \"$TEMP\" or \"$TMP\" are set to\\&. (Note that the directory may be specified without a trailing slash\\&.)" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%u" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "User name" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "This is the name of the I\\&. In case of the system manager this resolves to \"root\"\\&.\n" "\n" "Note that this setting is I influenced by the I setting configurable in the [Service] section of the service unit\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%U" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "User UID" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "This is the numeric UID of the I\\&. In case of the system manager this resolves to \"0\"\\&.\n" "\n" "Note that this setting is I influenced by the I setting configurable in the [Service] section of the service unit\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%v" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Kernel release" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Identical to B output\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%V" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Directory for larger and persistent temporary files" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is either /var/tmp or the path \"$TMPDIR\", \"$TEMP\" or \"$TMP\" are set to\\&. (Note that the directory may be specified without a trailing slash\\&.)" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%w" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Operating system version ID" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "The operating system version identifier of the running system, as read from the I field of /etc/os-release\\&. If not set, resolves to an empty string\\&. See B(5) for more information\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%W" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Operating system variant ID" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "The operating system variant identifier of the running system, as read from the I field of /etc/os-release\\&. If not set, resolves to an empty string\\&. See B(5) for more information\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%y" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "The path to the fragment" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is the path where the main part of the unit file is located\\&. For linked unit files, the real path outside of the unit search directories is used\\&. For units that don\\*(Aqt have a fragment file, this specifier will raise an error\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%Y" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "The directory of the fragment" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "This is the directory part of \"%y\"\\&." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "%%" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Single percent sign" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Use \"%%\" in place of \"%\" to specify a single percent sign\\&." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "EXAMPLES" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The following snippet (highlighted) allows a unit (e\\&.g\\&. foo\\&." "service) to be enabled via B:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "[Unit]\n" "Description=Foo\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "[Service]\n" "ExecStart=/usr/sbin/foo-daemon\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "I<[Install]>\n" "I\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "After running B, a symlink /etc/systemd/system/multi-" "user\\&.target\\&.wants/foo\\&.service linking to the actual unit will be " "created\\&. It tells systemd to pull in the unit when starting multi-user\\&." "target\\&. The inverse B will remove that symlink " "again\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "There are two methods of overriding vendor settings in unit files: copying " "the unit file from /usr/lib/systemd/system to /etc/systemd/system and " "modifying the chosen settings\\&. Alternatively, one can create a directory " "named I\\&.d/ within /etc/systemd/system and place a drop-in file " "I\\&.conf there that only changes the specific settings one is " "interested in\\&. Note that multiple such drop-in files are read if present, " "processed in lexicographic order of their filename\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The advantage of the first method is that one easily overrides the complete " "unit, the vendor unit is not parsed at all anymore\\&. It has the " "disadvantage that improvements to the unit file by the vendor are not " "automatically incorporated on updates\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The advantage of the second method is that one only overrides the settings " "one specifically wants, where updates to the unit by the vendor " "automatically apply\\&. This has the disadvantage that some future updates " "by the vendor might be incompatible with the local changes\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "This also applies for user instances of systemd, but with different " "locations for the unit files\\&. See the section on unit load paths for " "further details\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Suppose there is a vendor-supplied unit /usr/lib/systemd/system/httpd\\&." "service with the following contents:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "[Unit]\n" "Description=Some HTTP server\n" "After=remote-fs\\&.target sqldb\\&.service\n" "Requires=sqldb\\&.service\n" "AssertPathExists=/srv/webserver\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "[Service]\n" "Type=notify\n" "ExecStart=/usr/sbin/some-fancy-httpd-server\n" "Nice=5\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "[Install]\n" "WantedBy=multi-user\\&.target\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Now one wants to change some settings as an administrator: firstly, in the " "local setup, /srv/webserver might not exist, because the HTTP server is " "configured to use /srv/www instead\\&. Secondly, the local configuration " "makes the HTTP server also depend on a memory cache service, memcached\\&." "service, that should be pulled in (I) and also be ordered " "appropriately (I)\\&. Thirdly, in order to harden the service a bit " "more, the administrator would like to set the I setting (see " "B(5) for details)\\&. And lastly, the administrator would " "like to reset the niceness of the service to its default value of 0\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The first possibility is to copy the unit file to /etc/systemd/system/" "httpd\\&.service and change the chosen settings:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "[Unit]\n" "Description=Some HTTP server\n" "After=remote-fs\\&.target sqldb\\&.service I\n" "Requires=sqldb\\&.service I\n" "AssertPathExists=I\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "[Service]\n" "Type=notify\n" "ExecStart=/usr/sbin/some-fancy-httpd-server\n" "I\n" "I\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Alternatively, the administrator could create a drop-in file /etc/systemd/" "system/httpd\\&.service\\&.d/local\\&.conf with the following contents:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "[Unit]\n" "After=memcached\\&.service\n" "Requires=memcached\\&.service\n" "# Reset all assertions and then re-add the condition we want\n" "AssertPathExists=\n" "AssertPathExists=/srv/www\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "[Service]\n" "Nice=0\n" "PrivateTmp=yes\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Note that for drop-in files, if one wants to remove entries from a setting " "that is parsed as a list (and is not a dependency), such as " "I (or e\\&.g\\&. I in service units), one " "needs to first clear the list before re-adding all entries except the one " "that is to be removed\\&. Dependencies (I, etc\\&.) cannot be reset " "to an empty list, so dependencies can only be added in drop-ins\\&. If you " "want to remove dependencies, you have to override the entire unit\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Top level per-type drop-ins can be used to change some aspect of all units " "of a particular type\\&. For example, by creating the /etc/systemd/system/" "service\\&.d/ directory with a drop-in file, the contents of the drop-in " "file can be applied to all service units\\&. We can take this further by " "having the top-level drop-in instantiate a secondary helper unit\\&. " "Consider for example the following set of units and drop-in files where we " "install an I dependency for all service units\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "/etc/systemd/system/failure-handler@\\&.service:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "[Unit]\n" "Description=My failure handler for %i\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "[Service]\n" "Type=oneshot\n" "# Perform some special action for when %i exits unexpectedly\\&.\n" "ExecStart=/usr/sbin/myfailurehandler %i\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "We can then add an instance of failure-handler@\\&.service as an " "I dependency for all service units\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "/etc/systemd/system/service\\&.d/10-all\\&.conf:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "[Unit]\n" "OnFailure=failure-handler@%N\\&.service\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Now, after running B all services will have " "acquired an I dependency on failure-handler@%N\\&.service\\&. " "The template instance units will also have gained the dependency which " "results in the creation of a recursive dependency chain\\&. systemd will try " "to detect these recursive dependency chains where a template unit directly " "and recursively depends on itself and will remove such dependencies " "automatically if it finds them\\&. If systemd doesn\\*(Aqt detect the " "recursive dependency chain, we can break the chain ourselves by disabling " "the drop-in for the template instance units via a symlink to /dev/null:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "B\n" "B\n" "B\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "This ensures that if a failure-handler@\\&.service instance fails it will " "not trigger an instance named failure-handler@failure-handler\\&.service\\&." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "B(1), B(1), B(5), B(7), B(5), B(5), B(5), B(5), B(5), B(5), B(5), B(5), B(5), " "B(5), B(5), B(7), B(1), B(7), B(7), B(1)" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "NOTES" msgstr "" #. type: IP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid " 1." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Interface Portability and Stability Promise" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "\\%https://systemd.io/PORTABILITY_AND_STABILITY/" msgstr "" #. type: IP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid " 2." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "systemd and Storage Daemons for the Root File System" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "\\%https://systemd.io/ROOT_STORAGE_DAEMONS" msgstr "" #. type: IP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid " 3." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "System and Service Credentials" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "\\%https://systemd.io/CREDENTIALS" msgstr "" #. type: IP #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid " 4." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "PSI (Pressure Stall Information)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "\\%https://docs.kernel.org/accounting/psi.html" msgstr "" #. type: TH #: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "systemd 254" msgstr "" #. type: Plain text #: debian-bookworm #, no-wrap msgid "" "/etc/systemd/system\\&.control/*\n" "/run/systemd/system\\&.control/*\n" "/run/systemd/transient/*\n" "/run/systemd/generator\\&.early/*\n" "/etc/systemd/system/*\n" "/etc/systemd/system\\&.attached/*\n" "/run/systemd/system/*\n" "/run/systemd/system\\&.attached/*\n" "/run/systemd/generator/*\n" "\\&...\n" "/lib/systemd/system/*\n" "/run/systemd/generator\\&.late/*\n" msgstr "" #. type: Plain text #: debian-bookworm msgid "" "In addition to /etc/systemd/system, the drop-in \"\\&.d/\" directories for " "system services can be placed in /lib/systemd/system or /run/systemd/system " "directories\\&. Drop-in files in /etc/ take precedence over those in /run/ " "which in turn take precedence over those in /lib/\\&. Drop-in files under " "any of these directories take precedence over unit files wherever " "located\\&. Multiple drop-in files with different names are applied in " "lexicographic order, regardless of which of the directories they reside " "in\\&." msgstr "" #. type: tbl table #: debian-bookworm #, no-wrap msgid "/lib/systemd/system" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed msgid "" "For units that start processes (such as service units), lists one or more " "other units whose network and/or temporary file namespace to join\\&. If " "this is specified on a unit (say, a\\&.service has I), then this the inverse dependency (I for b\\&.service) is implied\\&. This only applies to unit types " "which support the I, I, " "I, I, and I directives (see " "B(5) for details)\\&. If a unit that has this setting set is " "started, its processes will see the same /tmp/, /var/tmp/, IPC namespace and " "network namespace as one listed unit that is started\\&. If multiple listed " "units are already started and these do not share their namespace, then it is " "not defined which namespace is joined\\&. Note that this setting only has an " "effect if I/I, I/" "I and/or I is enabled for both the unit that " "joins the namespace and the unit whose namespace is joined\\&." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I is a time span with the default unit of seconds, but other units " "may be specified, see B(5)\\&. Defaults to " "I in manager configuration file, and may be " "set to 0 to disable any kind of rate limiting\\&. I is a number and " "defaults to I in manager configuration file\\&." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I may be used to check whether a credential by the " "specified name was passed into the service manager\\&. See \\m[blue]B\\m[]\\&\\s-2\\u[2]\\d\\s+2 for details about " "credentials\\&. If used in services for the system service manager this may " "be used to conditionalize services based on system credentials passed in\\&. " "If used in services for the per-user service manager this may be used to " "conditionalize services based on credentials passed into the unit@\\&." "service service instance belonging to the user\\&. The argument must be a " "valid credential name\\&." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I may be used to check whether the given security " "technology is enabled on the system\\&. Currently, the recognized values are " "\"selinux\", \"apparmor\", \"tomoyo\", \"ima\", \"smack\", \"audit\", \"uefi-" "secureboot\", \"tpm2\" and \"cvm\"\\&. The test may be negated by prepending " "an exclamation mark\\&." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Verify that the overall system (memory, CPU or IO) pressure is below or " "equal to a threshold\\&. This setting takes a threshold value as " "argument\\&. It can be specified as a simple percentage value, suffixed with " "\"%\", in which case the pressure will be measured as an average over the " "last five minutes before the attempt to start the unit is performed\\&. " "Alternatively, the average timespan can also be specified using \"/\" as a " "separator, for example: \"10%/1min\"\\&. The supported timespans match what " "the kernel provides, and are limited to \"10sec\", \"1min\" and \"5min\"\\&. " "The \"full\" PSI will be checked first, and if not found \"some\" will be " "checked\\&. For more details, see the documentation on \\m[blue]B\\m[]\\&\\s-2\\u[3]\\d\\s+2\\&." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed msgid "B" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed msgid "B" msgstr "" #. type: Plain text #: debian-bookworm msgid "" "There are two methods of overriding vendor settings in unit files: copying " "the unit file from /lib/systemd/system to /etc/systemd/system and modifying " "the chosen settings\\&. Alternatively, one can create a directory named " "I\\&.d/ within /etc/systemd/system and place a drop-in file I\\&." "conf there that only changes the specific settings one is interested in\\&. " "Note that multiple such drop-in files are read if present, processed in " "lexicographic order of their filename\\&." msgstr "" #. type: Plain text #: debian-bookworm msgid "" "Suppose there is a vendor-supplied unit /lib/systemd/system/httpd\\&.service " "with the following contents:" msgstr ""