X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.unit.xml;h=d38a00136651b552ba94b4c513e643a5654f3a2f;hb=af65c248040108830a02860a395f44a186f08495;hp=ff199e43cb531cad75be8d785f0faba798306c52;hpb=e2130f189a543c859b569985d8670132df40673e;p=elogind.git diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index ff199e43c..d38a00136 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -186,16 +186,24 @@ configuration options. Other specifiers that may be used are %n, %N, %p, %P, - %I and %f, for + %I, %f, + %c, %r, + %R and %t for the full unit name, the unescaped unit name, the prefix name, the unescaped prefix name, the unescaped - instance name and the unescaped filename, + instance name, the unescaped filename, the control + group path of the unit, the root control group path of + systemd, and the parent directory of the root control + cgroup path of systemd and the runtime socket dir, 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. + "tty3" is the instance name. The runtime socket + directory is either /run (for the + system manager) or $XDG_RUNTIME_DIR + (for user managers). If a unit file is empty (i.e. has the file size 0) or is symlinked to /dev/null @@ -444,6 +452,44 @@ state. + + OnFailureIsolate= + + Takes a boolean + argument. If the + unit listed in + OnFailure= will be + enqueued in isolation mode, i.e. all + units that are not its dependency will + be stopped. If this is set only a + single unit may be listed in + OnFailure=. Defaults + to + . + + + + IgnoreOnIsolate= + + Takes a boolean + argument. If + this unit will not be stopped when + isolating another unit. Defaults to + . + + + + IgnoreOnSnapshot= + + Takes a boolean + argument. If + this unit will not be included in + snapshots. Defaults to + for device and + snapshot units, + for the others. + + StopWhenUnneeded= @@ -561,16 +607,20 @@ ConditionPathExists= + ConditionPathExistsGlob= + ConditionPathIsDirectory= ConditionDirectoryNotEmpty= + ConditionFileIsExecutable= ConditionKernelCommandLine= ConditionVirtualization= + ConditionSecurity= ConditionNull= Before starting a unit verify that the specified condition is true. With ConditionPathExists= - a file existance condition can be + a file existence condition can be checked before a unit is started. If the specified absolute path name does not exist startup of a unit will not @@ -584,10 +634,26 @@ is prefixed with an exclamation mark (!), the test is negated, and the unit only started if the path does not - exist. ConditionDirectoryNotEmpty= + exist. ConditionPathExistsGlob= + work in a similar way, but checks for + the existance of at least one file or + directory matching the specified + globbing + pattern. ConditionPathIsDirectory= + is similar to + ConditionPathExists= + but verifies whether a certain path + exists and is a + directory. ConditionFileIsExecutable= + is similar to + ConditionPathExists= + but verifies whether a certain path + exists, is a regular file and marked + executable. + ConditionDirectoryNotEmpty= is similar to ConditionPathExists= - but verifies whether a certain path is + but verifies whether a certain path exists and is a non-empty directory. Similarly ConditionKernelCommandLine= @@ -618,10 +684,18 @@ microsoft, oracle, xen, + pidns, openvz to test against a specific implementation. The test may be negated by prepending an - exclamation mark. Finally, + exclamation mark. + ConditionSecurity= + may be used to check whether the given + security module is enabled on the + system. Currently the only recognized + value is selinux. + The test may be negated by prepending + an exclamation mark. Finally, ConditionNull= may be used to add a constant condition check value to the unit. It takes a