]> git.ipfire.org Git - thirdparty/fcron.git/commitdiff
Add documentation on option runatresume.
authorThibault Godouet <yo8192@users.noreply.github.com>
Sun, 16 Jun 2024 14:56:39 +0000 (15:56 +0100)
committerThibault Godouet <yo8192@users.noreply.github.com>
Sun, 16 Jun 2024 14:56:39 +0000 (15:56 +0100)
doc/en/fcrontab.5.sgml

index f5a20a24d2251f90c4f66b3fd4b1eff272bea841..0c98a5f6239c7a7080b8192f8dcfdd457fd7403f 100644 (file)
@@ -762,7 +762,7 @@ for most uses.</para>
 a new one every time the OS reboots. This is very similar to the option &optvolatile;
 but based on the OS reboots instead of fcron restarts.
 You may also want to use option &optfirst; if you use fcron that way.</para>
-                       <para>&seealso; options &optfirst;, &optvolatile;, &optrunonce;, &optrunatreboot;.</para>
+                       <para>&seealso; options &optfirst;, &optvolatile;, &optrunonce;, &optrunatreboot;, &runatresume;.</para>
                    </listitem>
                </varlistentry>
 
@@ -788,10 +788,22 @@ permissions and environment (only root is allowed to use this option).</para>
                    <listitem>
                        <para><emphasis><type>boolean</type></emphasis>(<constant>false</constant>)</para>
                        <para>If set to true, the task will be run at system startup (i.e. immediately after the &argfirstsleep; delay -- by default, &firstsleep; seconds -- when the &fcron; daemon starts the first time after the OS has booted). This is in addition to the regular schedule which won't be modified by this option.</para>
-                        <para>For instance, if a program should be started automatically and run from 7am to 6pm, you could use the following dfcrontab definitions:</para>
+                        <para>For instance, if a program should be started automatically right after boot and run from 7am to 6pm, you could use the following fcrontab definitions:</para>
                         <programlisting>&amp;runatreboot 0 6 * * 1-5 start_my_program.sh
 &amp; 0 7 * * 1-5 stop_my_program.sh</programlisting>
-                       <para>&seealso; options &optvolatile;, &optrunonce;, &optrebootreset;.</para>
+                       <para>&seealso; options &optvolatile;, &optrunonce;, &runatresume;, &optrebootreset;.</para>
+                   </listitem>
+               </varlistentry>
+
+               <varlistentry id="fcrontab.5.runatresume">
+                   <term>runatresume</term>
+                   <listitem>
+                       <para><emphasis><type>boolean</type></emphasis>(<constant>false</constant>)</para>
+                       <para>If set to true, the task will be run at system resume (from suspend, or hibernation). This is in addition to the regular schedule which won't be modified by this option.</para>
+                        <para>For instance, if a program should be started automatically right after a system resume, and run from 7am to 6pm, you could use the following fcrontab definitions:</para>
+                        <programlisting>&amp;runatresume 0 6 * * 1-5 start_my_program.sh
+&amp; 0 7 * * 1-5 stop_my_program.sh</programlisting>
+                       <para>&seealso; options &optvolatile;, &optrunonce;, &runatreboot;, &optrebootreset;.</para>
                    </listitem>
                </varlistentry>
 
@@ -811,7 +823,7 @@ linkend="uptent">lines based on elapsed system up time</link>).</para>
                    <listitem>
                        <para><emphasis><type>boolean</type></emphasis>(<constant>false</constant>)</para>
                        <para>Do not re-schedule the task after it has run once, until the next OS reboot (if &optvolatile; is not set) or until the next &fcron; daemon restart (if &optvolatile; is set).</para>
-                       <para>&seealso; options &optvolatile;, &optrebootreset;, &optrunatreboot;.</para>
+                       <para>&seealso; options &optvolatile;, &optrebootreset;, &optrunatreboot;, &runatresume;.</para>
                    </listitem>
                </varlistentry>