core: Set source for mountinfo .mount units

[elogind.git] / man / systemd.path.xml

diff --git a/man/systemd.path.xml b/man/systemd.path.xml
index 10d8f7300475ea421b1c0ee3002d5c93602aa960..a602caab13232b0ee7dadf3d64047287018a9066 100644 (file)
--- 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
   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
   (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 <http://www.gnu.org/licenses/>.
 -->
 
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 


@@ -44,7 +44,7 @@
 
         <refnamediv>
                 <refname>systemd.path</refname>
 
         <refnamediv>
                 <refname>systemd.path</refname>

-                <refpurpose>systemd path configuration files</refpurpose>
+                <refpurpose>Path unit configuration</refpurpose>

         </refnamediv>
 
         <refsynopsisdiv>
         </refnamediv>
 
         <refsynopsisdiv>


@@ -84,7 +84,7 @@
                 used to monitor files or directories changed by other
                 machines on remote NFS file systems.</para>
 
                 used to monitor files or directories changed by other
                 machines on remote NFS file systems.</para>
 

-                <para>If an path unit is beneath another mount
+                <para>If a path unit is beneath another mount

                 point in the file system hierarchy, a dependency
                 between both units is created automatically.</para>
 
                 point in the file system hierarchy, a dependency
                 between both units is created automatically.</para>
 


@@ -113,6 +113,7 @@
                                 <term><varname>PathExists=</varname></term>
                                 <term><varname>PathExistsGlob=</varname></term>
                                 <term><varname>PathChanged=</varname></term>
                                 <term><varname>PathExists=</varname></term>
                                 <term><varname>PathExistsGlob=</varname></term>
                                 <term><varname>PathChanged=</varname></term>

+                                <term><varname>PathModified=</varname></term>

                                 <term><varname>DirectoryNotEmpty=</varname></term>
 
                                 <listitem><para>Defines paths to
                                 <term><varname>DirectoryNotEmpty=</varname></term>
 
                                 <listitem><para>Defines paths to


@@ -124,13 +125,21 @@
                                 is
                                 activated. <varname>PathExistsGlob=</varname>
                                 works similar, but checks for the
                                 is
                                 activated. <varname>PathExistsGlob=</varname>
                                 works similar, but checks for the

-                                existance of at least one file
+                                existence of at least one file

                                 matching the globbing pattern
                                 specified. <varname>PathChanged=</varname>
                                 may be used to watch a file or
                                 directory and activate the configured
                                 matching the globbing pattern
                                 specified. <varname>PathChanged=</varname>
                                 may be used to watch a file or
                                 directory and activate the configured

-                                unit whenever it changes or is
-                                modified. <varname>DirectoryNotEmpty=</varname>
+                                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. <varname>PathModified=</varname>
+                                is similar, but additionally it is
+                                activated also on simple writes to the
+                                watched file.
+                                <varname>DirectoryNotEmpty=</varname>

                                 may be used to watch a directory and
                                 activate the configured unit whenever
                                 it contains at least one file.</para>
                                 may be used to watch a directory and
                                 activate the configured unit whenever
                                 it contains at least one file.</para>


@@ -141,7 +150,12 @@
 
                                 <para>Multiple directives may be
                                 combined, of the same and of different
 
                                 <para>Multiple directives may be
                                 combined, of the same and of different

-                                types, to watch multiple paths.</para>
+                                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.</para>

 
                                 <para>If a path is already existing
                                 (in case of
 
                                 <para>If a path is already existing
                                 (in case of


@@ -154,11 +168,7 @@
                                 activated, then the configured unit is
                                 immediately activated as
                                 well. Something similar does not apply
                                 activated, then the configured unit is
                                 immediately activated as
                                 well. Something similar does not apply

-                                to
-                                <varname>PathChanged=</varname>. The
-                                latter is not activated on simple
-                                writes but only if files with were
-                                opened for writing are closed.
+                                to <varname>PathChanged=</varname>.

                                 </para></listitem>
                         </varlistentry>
                         <varlistentry>
                                 </para></listitem>
                         </varlistentry>
                         <varlistentry>


@@ -210,7 +220,8 @@
                           <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
                           <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                           <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                           <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
                           <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                           <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,

-                          <citerefentry><refentrytitle>inotify</refentrytitle><manvolnum>7</manvolnum></citerefentry>
+                          <citerefentry><refentrytitle>inotify</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
+                          <citerefentry><refentrytitle>systemd.directives</refentrytitle><manvolnum>7</manvolnum></citerefentry>

                   </para>
         </refsect1>
 
                   </para>
         </refsect1>