X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;ds=sidebyside;f=man%2Fsystemd.path.xml;h=8c782b85311b9f685b54d0521e2bf828cac9d454;hb=44ded3abc28620279633f51a05f2416e5aa3e8e2;hp=772190096d415ad76d4c8be050ad1773b3154fd5;hpb=b439c6ee04967fa988d232e0765f972cb27b1877;p=elogind.git
diff --git a/man/systemd.path.xml b/man/systemd.path.xml
index 772190096..8c782b853 100644
--- a/man/systemd.path.xml
+++ b/man/systemd.path.xml
@@ -9,16 +9,16 @@
Copyright 2010 Lennart Poettering
systemd is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 2 of the License, or
+ under the terms of the GNU Lesser General Public License as published by
+ the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
+ Lesser General Public License for more details.
- You should have received a copy of the GNU General Public License
+ You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see .
-->
@@ -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,9 +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=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.
+
@@ -97,10 +107,12 @@
monitors. The options specific to the [Path] section
of path units are the following:
-
+ PathExists=
+ PathExistsGlob=PathChanged=
+ PathModified=DirectoryNotEmpty=Defines paths to
@@ -110,11 +122,23 @@
file or directory. If the file
specified exists the configured unit
is
- activated. PathChanged=
+ activated. PathExistsGlob=
+ works similar, but checks for the
+ existence of at least one file
+ matching the globbing pattern
+ specified. PathChanged=
may be used to watch a file or
directory and activate the configured
- unit whenever it changes or is
- modified. DirectoryNotEmpty=
+ 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
it contains at least one file.
@@ -125,19 +149,33 @@
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=) or a
- directory already is not empty (in
+ PathExists= and
+ PathExistsGlob=) or
+ a directory already is not empty (in
case of
DirectoryNotEmpty=)
- at the time the path unit is activated,
- then the configured unit is
+ at the time the path unit is
+ 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.
@@ -147,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
@@ -157,17 +195,40 @@
identical, except for the
suffix.
+
+ MakeDirectory=
+
+ Takes a boolean
+ argument. If true the directories to
+ watch are created before
+ watching. This option is ignored for
+ PathExists=
+ settings. Defaults to
+ .
+
+
+ DirectoryMode=
+
+ If
+ MakeDirectory= is
+ enabled use the mode specified here to
+ create the directories in
+ question. Takes an access mode in
+ octal notation. Defaults to
+ .
+ See Also
- systemd8,
+ systemd1,
systemctl8,
systemd.unit5,
systemd.service5,
- inotify7
+ inotify7,
+ systemd.directives7