X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.path.xml;h=8d86fca5d6add41e51e53e02ae672e4c2d3bcc3e;hp=5b1ff75f7ae68a9c0324a7181c176c347152af05;hb=03ee5c38cb0da193dd08733fb4c0c2809cee6a99;hpb=dc1ecd78e9f046880d10ddb45cf9b06df1084b10 diff --git a/man/systemd.path.xml b/man/systemd.path.xml index 5b1ff75f7..8d86fca5d 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,7 +107,7 @@ monitors. The options specific to the [Path] section of path units are the following: - + PathExists= PathExistsGlob= @@ -121,22 +120,24 @@ 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 - existance of at least one file + 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. 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