A copy of the license is included in gfdl.sgml.
-->
-<!-- $Id: fcron.conf.5.sgml,v 1.3 2002-03-02 17:31:16 thib Exp $ -->
+<!-- $Id: fcron.conf.5.sgml,v 1.4 2002-07-19 19:42:22 thib Exp $ -->
<refentry id="fcron.conf.5">
<refmeta>
<refentrytitle>fcron.conf</refentrytitle>
<manvolnum>5</manvolnum>
- <refmiscinfo>Fcron &version; <![%devrelease; [ (<emphasis>development</emphasis> release)]]></refmiscinfo>
+ <refmiscinfo>Fcron &version; <![%devrelease; [
+(<emphasis>development</emphasis> release)]]></refmiscinfo>
<refmiscinfo>&date;</refmiscinfo>
</refmeta>
<refnamediv>
<refsect1>
<title>Description</title>
<abstract>
- <para>This page describes the syntax used for the configuration file of <link linkend="fcrontab.1">&fcrontab;</link>(1), <link linkend="fcrondyn.1">&fcrondyn;</link>(1) and <link linkend="fcron.8">&fcron;</link>(8).</para>
+ <para>This page describes the syntax used for the configuration file
+of <link linkend="fcrontab.1">&fcrontab;</link>(1), <link
+linkend="fcrondyn.1">&fcrondyn;</link>(1) and <link
+linkend="fcron.8">&fcron;</link>(8).</para>
</abstract>
- <para>Blank lines, line beginning by a pound-sign (#) (which are considered comments), leading blanks and tabs are ignored. Each line in a &fcron.conf file is of the form
+ <para>Blank lines, line beginning by a pound-sign (#) (which are
+considered comments), leading blanks and tabs are ignored. Each line in a
+&fcron.conf file is of the form
<blockquote>
<para>name = value</para>
- </blockquote>
-where the blanks around equal-sign (=) are ignored and optional. Trailing blanks are also ignored.
+ </blockquote> where the blanks around equal-sign (=) are ignored and
+optional. Trailing blanks are also ignored.
</para>
<para>The following names are recognized (default value in brackets) :
<variablelist>
<title>Valid variables in a fcron.conf file</title>
<varlistentry>
- <term><varname>fcrontabs</varname>=<replaceable>directory</replaceable> (<filename>&fcrontabsdir;</filename>)</term>
+ <term><varname>fcrontabs</varname>=<replaceable>directory</replaceable>
+(<filename>&fcrontabsdir;</filename>)</term>
<listitem>
<para>&Fcron; spool directory</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><varname>pidfile</varname>=<replaceable>file-path</replaceable> (<filename>&fcron.pid;</filename>)</term>
+ <term><varname>pidfile</varname>=<replaceable>file-path</replaceable>
+(<filename>&fcron.pid;</filename>)</term>
<listitem>
- <para>Location of &fcron; pid file (needed by &fcrontab; to work properly).</para>
+ <para>Location of &fcron; pid file (needed by &fcrontab;
+to work properly).</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><varname>fifofile</varname>=<replaceable>file-path</replaceable> (<filename>&fcron.pid;</filename>)</term>
+ <term><varname>fifofile</varname>=<replaceable>file-path</replaceable>
+(<filename>&fcron.pid;</filename>)</term>
<listitem>
- <para>Location of &fcron; fifo file (needed by &fcrondyn; to communicate with fcron).</para>
+ <para>Location of &fcron; fifo file (needed by
+&fcrondyn; to communicate with fcron).</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><varname>fcronallow</varname>=<replaceable>file-path</replaceable> (<filename>&etc;/&fcron.allow;</filename>)</term>
+ <term><varname>fcronallow</varname>=<replaceable>file-path</replaceable>
+(<filename>&etc;/&fcron.allow;</filename>)</term>
<listitem>
<para>Location of fcron.allow file.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><varname>fcrondeny</varname>=<replaceable>file-path</replaceable> (<filename>&etc;/&fcron.deny;</filename>)</term>
+ <term><varname>fcrondeny</varname>=<replaceable>file-path</replaceable>
+(<filename>&etc;/&fcron.deny;</filename>)</term>
<listitem>
<para>Location of fcron.deny file.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><varname>shell</varname>=<replaceable>file-path</replaceable> (<filename>&shell;</filename>)</term>
+ <term><varname>shell</varname>=<replaceable>file-path</replaceable>
+(<filename>&shell;</filename>)</term>
<listitem>
- <para>Location of default shell called by &fcron; when running a job.</para>
+ <para>Location of default shell called by &fcron; when
+running a job.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><varname>sendmail</varname>=<replaceable>file-path</replaceable> (<filename>&sendmail;</filename>)</term>
+ <term><varname>sendmail</varname>=<replaceable>file-path</replaceable>
+(<filename>&sendmail;</filename>)</term>
<listitem>
- <para>Location of mailer program called by &fcron; to send job output.</para>
+ <para>Location of mailer program called by &fcron; to
+send job output.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><varname>editor</varname>=<replaceable>file-path</replaceable> (<filename>&editor;</filename>)</term>
+ <term><varname>editor</varname>=<replaceable>file-path</replaceable>
+(<filename>&editor;</filename>)</term>
<listitem>
- <para>Location of default editor used when invoking "fcrontab -e".</para>
+ <para>Location of default editor used when invoking
+"fcrontab -e".</para>
</listitem>
</varlistentry>
- </variablelist>
-File-paths and directories are complete and absolute (i.e. beginning by a "/").</para>
- <para>To run several instances of &fcron; simultaneously on the same system, you must use a different configuration file for each instance. Each instance must have a different <varname>fcrontabs</varname>, <varname>pidfile</varname> and <varname>fifofile</varname>. Then, use <link linkend="fcron.8">fcron</link>(8)'s command line option <parameter>-c</parameter> to select which config file (so which instance) you refer to.</para>
+ </variablelist> File-paths and directories are complete and absolute
+(i.e. beginning by a "/").</para>
+ <para>To run several instances of &fcron; simultaneously on the same
+system, you must use a different configuration file for each instance. Each
+instance must have a different <varname>fcrontabs</varname>,
+<varname>pidfile</varname> and <varname>fifofile</varname>. Then, use <link
+linkend="fcron.8">fcron</link>(8)'s command line option
+<parameter>-c</parameter> to select which config file (so which instance) you
+refer to.</para>
</refsect1>
<refsect1>
<varlistentry>
<term><filename>&etc;/&fcron.conf.location;</filename></term>
<listitem>
- <para>Configuration file for &fcron;, &fcrontab and &fcrondyn; : contains paths (spool dir, pid file) and default programs to use (editor, shell, etc). See <link linkend="fcron.conf.5">&fcron.conf(5)</link> for more details.</para>
+ <para>Configuration file for &fcron;, &fcrontab and
+&fcrondyn; : contains paths (spool dir, pid file) and default programs to use
+(editor, shell, etc). See <link linkend="fcron.conf.5">&fcron.conf(5)</link> for
+more details.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><filename>&etc;/&fcron.allow;</filename></term>
<listitem>
- <para>Users allowed to use &fcrontab; and &fcrondyn; (one name per line, special name "all" acts for everyone)</para>
+ <para>Users allowed to use &fcrontab; and &fcrondyn; (one
+name per line, special name "all" acts for everyone)</para>
</listitem>
</varlistentry>
<varlistentry>
<term><filename>&etc;/&fcron.deny;</filename></term>
<listitem>
- <para>Users who are not allowed to use &fcrontab; and &fcrondyn; (same format as allow file)</para>
+ <para>Users who are not allowed to use &fcrontab; and
+&fcrondyn; (same format as allow file)</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><filename>&etc;/pam.d/fcron</filename> (or <filename>&etc;/pam.conf</filename>)</term>
+ <term><filename>&etc;/pam.d/fcron</filename> (or
+<filename>&etc;/pam.conf</filename>)</term>
<listitem>
- <para><productname>PAM</productname> configuration file for &fcron;. Take a look at pam(8) for more details.</para>
+ <para><productname>PAM</productname> configuration file for
+&fcron;. Take a look at pam(8) for more details.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
- <refsect1>
- <title>See also</title>
- <simplelist>
- <member><link linkend="fcron.8">&fcron;(8)</link></member>
- <member><link linkend="fcrontab.1">&fcrontab;(1)</link></member>
- <member><link linkend="fcrontab.5">&fcrontab;(5)</link></member>
- <member><link linkend="fcrondyn.1">&fcrondyn;(1)</link></member>
- <member>The HTML version of the documentation, if you are not reading it right now, which is far better than these man pages :)).</member>
- </simplelist>
- </refsect1>
-
- <refsect1>
- <title>Author</title>
- <para>Thibault Godouet &email;</para>
- </refsect1>
+ &manpage-foot;
</refentry>