X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.path.xml;h=8d86fca5d6add41e51e53e02ae672e4c2d3bcc3e;hb=260ad50f5b4a9795032e3119c64f838a2d03370d;hp=2d02318f199441f853025e4ca908a1130dca5fea;hpb=dc786b29c309bed4edc3c42e950e445c176c8a0c;p=elogind.git
diff --git a/man/systemd.path.xml b/man/systemd.path.xml
index 2d02318f1..8d86fca5d 100644
--- a/man/systemd.path.xml
+++ b/man/systemd.path.xml
@@ -44,18 +44,18 @@
systemd.path
- systemd path configuration files
+ Path unit configuration
- systemd.path
+ path.pathDescriptionA unit configuration file whose name ends in
- .path encodes information about
+ .path encodes information about
a path monitored by systemd, for
path-based activation.
@@ -84,20 +84,19 @@
used to monitor files or directories changed by other
machines on remote NFS file systems.
- If an path unit is beneath another mount
+ If a path unit is beneath another mount
point in the file system hierarchy, a dependency
between both units is created automatically.
- Unless DefaultDependencies=
- is set to , path units will
- implicitly have dependencies of type
- Conflicts= and
+ Unless DefaultDependencies=false
+ is used, path units will implicitly have dependencies of
+ type Conflicts= and
Before= on
shutdown.target. These ensure
that path units are terminated cleanly prior to system
shutdown. Only path units involved with early boot or
- late system shutdown should disable this
- option.
+ late system shutdown should disable this option.
+
@@ -108,7 +107,7 @@
monitors. The options specific to the [Path] section
of path units are the following:
-
+ PathExists=PathExistsGlob=
@@ -121,7 +120,7 @@
PathExists= may be
used to watch the mere existence of a
file or directory. If the file
- specified exists the configured unit
+ specified exists, the configured unit
is
activated. PathExistsGlob=
works similar, but checks for the
@@ -130,13 +129,15 @@
specified. PathChanged=
may be used to watch a file or
directory and activate the configured
- unit whenever it changes. It is not activated
- on every write to the watched file but it is
- activated if the file which was open for writing
- gets closed. PathModified=
- is similar, but additionally it is activated
- also on simple writes to the watched file.
-
+ unit whenever it changes. It is not
+ activated on every write to the
+ watched file but it is activated if
+ the file which was open for writing
+ gets
+ closed. PathModified=
+ is similar, but additionally it is
+ activated also on simple writes to the
+ watched file.
DirectoryNotEmpty=
may be used to watch a directory and
activate the configured unit whenever
@@ -148,9 +149,14 @@
Multiple directives may be
combined, of the same and of different
- types, to watch multiple paths.
-
- If a path is already existing
+ types, to watch multiple paths. If the
+ empty string is assigned to any of
+ these options, the list of paths to
+ watch is reset, and any prior
+ assignments of these options will not
+ have any effect.
+
+ If a path already exists
(in case of
PathExists= and
PathExistsGlob=) or
@@ -161,7 +167,15 @@
activated, then the configured unit is
immediately activated as
well. Something similar does not apply
- to PathChanged=.
+ to PathChanged= and
+ PathModified=.
+
+ If the path itself or any of the
+ containing directories are not
+ accessible, systemd
+ will watch for permission changes and
+ notice that conditions are satisfied
+ when permissions allow that.
@@ -171,7 +185,7 @@
when any of the configured paths
changes. The argument is a unit name,
whose suffix is not
- .path. If not
+ .path. If not
specified, this value defaults to a
service that has the same name as the
path unit, except for the suffix. (See
@@ -185,7 +199,7 @@
MakeDirectory=Takes a boolean
- argument. If true the directories to
+ argument. If true, the directories to
watch are created before
watching. This option is ignored for
PathExists=
@@ -197,7 +211,7 @@
If
MakeDirectory= is
- enabled use the mode specified here to
+ enabled, use the mode specified here to
create the directories in
question. Takes an access mode in
octal notation. Defaults to
@@ -213,7 +227,8 @@
systemctl8,
systemd.unit5,
systemd.service5,
- inotify7
+ inotify7,
+ systemd.directives7