X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.unit.xml;h=39862cf7c89162e510f1bb35eb820c1aa47f5851;hp=e54cafaabcd2f0b854b7d9e1aa7126c83170d5a5;hb=761163046260b42c0bed075c17d43e0e6c3dd3a4;hpb=52661efd21608dc7e0ac26b714a9254ed6180ddb diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index e54cafaab..39862cf7c 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -182,13 +182,17 @@ %i specifier in many of the configuration options. Other specifiers that may be used are %n, %N, - %p, %P and - %I, for the full unit name, the - unescaped unit name, the prefix name, the unescaped - prefix name and the unescaped instance name, - respectively. The prefix name here refers to the - string before the @, i.e. "getty" in the example - above, where "tty3" is the instance name. + %p, %P, + %I and %f, for + the full unit name, the unescaped unit name, the + prefix name, the unescaped prefix name, the unescaped + instance name and the unescaped filename, + respectively. The unescaped filename is either the + unescaped instance name (if set) with / prepended (if + necessary), or the prefix name similarly prepended + with /. The prefix name here refers to the string + before the @, i.e. "getty" in the example above, where + "tty3" is the instance name. If a unit file is empty (i.e. has the file size 0) or is symlinked to /dev/null @@ -277,7 +281,6 @@ services. - RequiresOverridable= @@ -336,6 +339,23 @@ details see above. + + BindTo= + + Configures requirement + dependencies, very similar in style to + Requires=, however + in addition to this behaviour it also + declares that this unit is stopped + when any of the units listed suddenly + disappears. Units can suddenly, + unexpectedly disappear if a service + terminates on its own choice, a device + is unplugged or a mount point + unmounted with involvement of + systemd. + + Conflicts= @@ -436,26 +456,6 @@ state. - - RecursiveStop= - - Takes a boolean - argument. If and - the unit stops without being requested - by the user, all units - depending on it will be stopped as - well. (e.g. if a service exits or - crashes on its own behalf, units using - it will be stopped) Note that normally - if a unit stops without a user request, - units depending on it will not be - terminated. Only if the user requested - shutdown of a unit, all units depending - on that unit will be shut down as well - and at the same time. Defaults to - . - - StopWhenUnneeded= @@ -543,20 +543,6 @@ ones. - - IgnoreDependencyFailure= - - Takes a boolean - argument. If and - a requirement dependency of this unit - fails to start up this unit will be - started nonetheless, ignoring that - failure. If - (the default) and a dependency unit - fails the unit will immediately fail - too and the job is removed. - - JobTimeoutSec= @@ -588,6 +574,7 @@ ConditionPathExists= ConditionKernelCommandLine= + ConditionNull= Before starting a unit verify that the specified condition is @@ -616,15 +603,23 @@ must either be a single word, or an assignment (i.e. two words, seperated by the equality sign). In the former - case the kernel command line is search - 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. If multiple conditions - are specified the unit will be - executed iff at least one of them - apply (i.e. a logical OR is + 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. Finally, + ConditionNull= may + be used to add a constant condition + check value to the unit. It takes a + boolean argument. If set to + false the condition + will always fail, otherwise + succeed. If multiple conditions are + specified the unit will be executed + iff at least one of them applies + (i.e. a logical OR is applied).