X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;ds=sidebyside;f=man%2Fsystemd.unit.xml;h=8d6acc7b02e092e135a6168574eb30e0e06a1892;hb=6baf995c17a95ca0d6b5ad0b1f1667c956574816;hp=b43fa1369ed80991979d60e8abe0e67d9d8254cb;hpb=d420282b28f50720e233ccb1c02547c562195653;p=elogind.git
diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index b43fa1369..8d6acc7b0 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -120,6 +120,17 @@
systemd.scope5.
+ Various settings are allowed to be specified
+ more than once, in which case the interpretation
+ depends on the setting. Often, multiple settings form
+ a list, and setting to an empty value "resets", which
+ means that previous assignments are ignored. When this
+ is allowed, it is mentioned in the description of the
+ setting. Note that using multiple assignments to the
+ same value makes the unit file incompatible with
+ parsers for the XDG .desktop file
+ format.
+
Unit files are loaded from a set of paths
determined during compilation, described in the next section.
@@ -410,10 +421,12 @@
of the other units gets deactivated or
its activation fails, this unit will
be deactivated. This option may be
- specified more than once, in which
- case requirement dependencies for all
- listed names are created. Note that
- requirement dependencies do not
+ specified more than once or multiple
+ space-separated units may be specified
+ in one option in which case
+ requirement dependencies for all
+ listed names will be created. Note
+ that requirement dependencies do not
influence the order in which services
are started or stopped. This has to be
configured independently with the
@@ -476,22 +489,23 @@
RequisiteOverridable=Similar to
- Requires=
- and RequiresOverridable=, respectively. However,
- if a unit listed here is not started
- already it will not be started and the
- transaction fails
- immediately.
+ Requires= and
+ RequiresOverridable=,
+ respectively. However, if the units
+ listed here are not started already
+ they will not be started and the
+ transaction will fail immediately.
+
Wants=A weaker version of
- Requires=. A unit
+ Requires=. Units
listed in this option will be started
if the configuring unit is. However,
- if the listed unit fails to start up
+ 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. This is
@@ -501,8 +515,8 @@
Note that dependencies of this
type may also be configured outside of
- the unit configuration file by
- adding a symlink to a
+ the unit configuration file by adding
+ symlinks to a
.wants/ directory
accompanying the unit file. For
details see above.
@@ -534,7 +548,7 @@
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 -
+ Note that this is a one way dependency â
changes to this unit do not affect the
listed units.
@@ -543,12 +557,12 @@
Conflicts=
- Configures negative
+ A space-separated list
+ of unit names. Configures negative
requirement dependencies. If a unit
- has a
- Conflicts= setting
- on another unit, starting the former
- will stop the latter and vice
+ has a Conflicts=
+ setting on another unit, starting the
+ former will stop the latter and vice
versa. Note that this setting is
independent of and orthogonal to the
After= and
@@ -575,7 +589,8 @@
Before=After=
- Configures ordering
+ A space-separated list
+ of unit names. Configures ordering
dependencies between units. If a unit
foo.service
contains a setting
@@ -624,18 +639,18 @@
type After= or
Before=. If two
units have no ordering dependencies
- between them, they are shut down
- or started up simultaneously, and
- no ordering takes
+ between them, they are shut down or
+ started up simultaneously, and no
+ ordering takes
place. OnFailure=
- Lists one or more
- units that are activated when this
- unit enters the
+ A space-separated list
+ of one or more units that are
+ activated when this unit enters the
failed
state.
@@ -644,16 +659,48 @@
PropagatesReloadTo=ReloadPropagatedFrom=
- Lists one or more
- units where reload requests on the
- unit will be propagated to/on the
- other unit will be propagated
- from. Issuing a reload request on a
- unit will automatically also enqueue a
- reload request on all units that the
- reload request shall be propagated to
- via these two
- settings.
+ A space-separated list
+ of one or more units where reload
+ requests on this unit will be
+ propagated to, or reload requests on
+ the other unit will be propagated to
+ this unit, respectively. Issuing a
+ reload request on a unit will
+ automatically also enqueue a reload
+ request on all units that the reload
+ request shall be propagated to via
+ these two settings.
+
+
+
+ JoinsNamespaceOf=
+
+ For units that start
+ processes (such as service units),
+ lists one or more other units whose
+ network and/or temporary file
+ namespace to join. This only applies
+ to unit types which support the
+ PrivateNetwork= and
+ PrivateTmp=
+ directives (see
+ systemd.exec5
+ for details). If a unit that has this
+ setting set is started its processes
+ will see the same
+ /tmp,
+ /tmp/var and
+ network namespace as one listed unit
+ that is started. If multiple listed
+ units are already started it is not
+ defined which namespace is
+ joined. Note that this setting only
+ has an effect if
+ PrivateNetwork=
+ and/or PrivateTmp=
+ is enabled for both the unit that
+ joins the namespace and the unit whose
+ namespace is joined.
@@ -674,28 +721,20 @@
Takes a value of
fail,
replace,
- replace-irreversibly
+ replace-irreversibly,
+ isolate,
+ flush,
+ ignore-dependencies
or
- isolate. Defaults
+ ignore-requirements. Defaults
to
replace. Specifies
how the units listed in
OnFailure= will be
- enqueued. If set to
- fail and
- contradicting jobs are already queued,
- cause the activation to fail. If set
- to replace and
- contradicting jobs area already
- queued, replace
- those. replace-irreversibly
- is similar to
- replace, however,
- creates jobs that cannot be reversed
- unless they finished or are explicitly
- canceled. isolate
- may be used to terminate all other
- units but the specified one. If
+ enqueued. See
+ systemctl1's
+ option
+ for details on the possible values. If
this is set to
isolate, only a
single unit may be listed in
@@ -1107,32 +1146,34 @@
Alias=
- Additional names this
- unit shall be installed under. 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. At installation
- time,
- systemctl enable
- will create symlinks from these names
- to the unit filename.
+ A space-seperated 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 file name. This option may
+ be specified more than once, in which
+ case all listed names are used. At
+ installation time, systemctl
+ enable will create symlinks
+ from these names to the unit
+ filename.WantedBy=RequiredBy=
- A symbolic link is
- created in the
- .wants/ or
- .requires/ directory
- of the listed unit when this unit is
- activated by systemctl
- enable. This has the effect
- that a dependency of type
- Wants= or
+ 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/ or
+ .requires/
+ directory of each of the listed units
+ when this unit is installed by
+ systemctl enable.
+ This has the effect that a dependency
+ of type Wants= or
Requires= is added
from the listed unit to the current
unit. The primary result is that the
@@ -1178,7 +1219,12 @@
and systemctl
disable will automatically
install/uninstall units listed in this option as
- well.
+ well.
+
+ This option may be used more
+ than once, or a space-separated list
+ of unit names may be
+ given.