X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;ds=sidebyside;f=man%2Fsystemd.unit.xml;h=35dd4c78c4cc00de502100bbab1847c863855a66;hb=e7176abbe818c75c6acd90227a7a84c3e05fee31;hp=5c8b8e88689469d741c38b01f059017a3466d927;hpb=7ac807320a7416463d7ff3ef6ede574863a601c5;p=elogind.git
diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index 5c8b8e886..35dd4c78c 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -410,10 +410,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 +478,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 +504,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 +537,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 +546,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 +578,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 +628,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 +648,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.
@@ -669,19 +705,29 @@
- OnFailureIsolate=
-
- Takes a boolean
- argument. If , the
- unit listed in
+ OnFailureJobMode=
+
+ Takes a value of
+ fail,
+ replace,
+ replace-irreversibly,
+ isolate,
+ flush,
+ ignore-dependencies
+ or
+ ignore-requirements. Defaults
+ to
+ replace. Specifies
+ how the units 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
+ 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
- OnFailure=. Defaults
- to
- .
+ OnFailure=..
@@ -1089,32 +1135,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
@@ -1160,7 +1208,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.
@@ -1236,12 +1289,12 @@
%rRoot control group path where units are placed.
- For system instances this usually resolves to /system, except in containers, where the path might be prefixed with the container's root control group.
+ For system instances, this usually resolves to /system, except in containers, where the path might be prefixed with the container's root control group.%RParent directory of the control group path where units are placed.
- For system instances this usually
+ For system instances, this usually
resolves to /, except in
containers, where this resolves to the
container's root directory.