X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.path.xml;h=8c782b85311b9f685b54d0521e2bf828cac9d454;hp=e816c3018c13430b2bd2332defb5c4ddfa03c254;hb=6b4991cfde6c0a0b62e836ca75ae362779c474d4;hpb=0e456f978134100d2e0cc28c7205b3abefcc9cde diff --git a/man/systemd.path.xml b/man/systemd.path.xml index e816c3018..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.path Description A 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,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 @@ -121,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. @@ -136,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. @@ -158,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 @@ -200,7 +227,8 @@ systemctl8, systemd.unit5, systemd.service5, - inotify7 + inotify7, + systemd.directives7