X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.unit.xml;h=3236bfa7416f07670294827c0984ba6df5df9f6f;hp=eecff7373a512e342d7768950df269db1ac44779;hb=b2896c905bef7be7ed9a760d9d61aa6ad0f614a3;hpb=7d39db92c5e3d4f0448982639ba06ae442bb6226 diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index eecff7373..3236bfa74 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -8,16 +8,16 @@ Copyright 2010 Lennart Poettering systemd is free software; you can redistribute it and/or modify it - under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or + under the terms of the GNU Lesser General Public License as published by + the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. systemd is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - General Public License for more details. + Lesser General Public License for more details. - You should have received a copy of the GNU General Public License + You should have received a copy of the GNU Lesser General Public License along with systemd; If not, see . --> @@ -122,7 +122,7 @@ If a line starts with followed by a file name, the specified file will be parsed at this point. Make sure that the file that is - included has the appropiate section headers before + included has the appropriate section headers before any directives. Along with a unit file @@ -258,6 +258,16 @@ Runtime socket dir This is either /run (for the system manager) or $XDG_RUNTIME_DIR (for user managers). + + %u + User name + This is the name of the configured user of the unit, or (if none is set) the user running the systemd instance. + + + %h + User home directory + This is the home directory of the configured user of the unit, or (if none is set) the user running the systemd instance. + @@ -294,6 +304,23 @@ name. + + Documentation= + 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 + uri7. + + Requires= @@ -393,7 +420,7 @@ - BindTo= + BindsTo= Configures requirement dependencies, very similar in style to @@ -510,8 +537,8 @@ - PropagateReloadTo= - PropagateReloadFrom= + PropagatesReloadTo= + ReloadPropagatedFrom= Lists one or more units where reload requests on the @@ -525,6 +552,18 @@ settings. + + RequiresMountsFor= + + Takes a space + separated list of paths. Automatically + adds dependencies of type + Requires= and + After= for all + mount units required to access the + specified path. + + OnFailureIsolate= @@ -684,6 +723,7 @@ ConditionPathIsDirectory= ConditionPathIsSymbolicLink= ConditionPathIsMountPoint= + ConditionPathIsReadWrite= ConditionDirectoryNotEmpty= ConditionFileIsExecutable= ConditionKernelCommandLine= @@ -731,7 +771,13 @@ ConditionPathExists= but verifies whether a certain path exists and is a mount - point. ConditionFileIsExecutable= + point. ConditionPathIsReadWrite= + is similar to + ConditionPathExists= + but verifies whether the underlying + file system is read and writable + (i.e. not mounted + read-only). ConditionFileIsExecutable= is similar to ConditionPathExists= but verifies whether a certain path @@ -780,13 +826,13 @@ openvz, lxc, lxc-libvirt, - systemd-nspawn, - pidns to test - against a specific implementation. If - multiple virtualization technologies - are nested only the innermost is - considered. The test may be negated by - prepending an exclamation mark. + systemd-nspawn to + test against a specific + implementation. If multiple + virtualization technologies are nested + only the innermost is considered. The + test may be negated by prepending an + exclamation mark. ConditionSecurity= may be used to check whether the given security module is enabled on the @@ -834,32 +880,16 @@ - Names= - - Additional names for - this unit. The names listed here must - have the same suffix (i.e. type) as - the unit file name. This option may be - specified more than once, in which - case all listed names are used. Note - that this option is different from the - Alias= option from - the [Install] section mentioned - below. See below for details. Note - that in almost all cases this option - is not what you want. A symlink alias - in the file system is generally - preferable since it can be used as - lookup key. If a unit with a symlinked - alias name is not loaded and needs to - be it is easily found via the - symlink. However, if a unit with an - alias name configured with this - setting is not loaded it will not be - discovered. This settings' only use is - in conjunction with service - instances. - + SourcePath= + 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. Thus + functionality should not be used in + normal units. @@ -887,37 +917,16 @@ time, systemctl enable will create symlinks from these names - to the unit file name. Note that this - is different from the - Names= option from - the [Unit] section mentioned above: - The names from - Names= apply - unconditionally if the unit is - loaded. The names from - Alias= apply only - if the unit has actually been - installed with the - systemctl enable - command. Also, if systemd searches for a - unit, it will discover symlinked alias - names as configured with - Alias=, but not - names configured with - Names= only. It is - a common pattern to list a name in - both options. In this case, a unit - will be active under all names if - installed, but also if not installed - but requested explicitly under its - main name. + to the unit file name. WantedBy= + RequiredBy= Installs a symlink in the .wants/ + resp. .requires/ subdirectory for a unit. This has the effect that when the listed unit name is activated the unit listing it is