<html>
<head>
<meta name="Content-Style" content="text/css">
</head>
<body BGCOLOR=#000000 TEXT=#FFFFFF LINK=#0FA0FF VLINK=#B000B0 ALINK=#FF0000> <i>Generated by groff</i><br><h1>fcrontab.1</h1><br>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#OPTIONS">OPTIONS</a><br>
<a href="#RETURN VALUES">RETURN VALUES</a><br>
<a href="#CONFORMING TO">CONFORMING TO</a><br>
<a href="#FILES">FILES</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<a href="#AUTHOR">AUTHOR</a><br>
<!-- Creator : groff version 1.16.1 -->
<!-- CreationDate: Thu Aug 23 15:11:36 2001
-->
<!-- Total number of pages: 2 -->
<!-- Page: 1 -->
<!-- left margin: 220 -->
<!-- right margin: 750 -->
<a name="NAME"></a><h2>NAME</h2><p style="margin-left: 18%"><font size=3>fcrontab - manipulate per­user fcrontab files</font></p>
<a name="SYNOPSIS"></a><h2>SYNOPSIS</h2><p style="margin-left: 18%"><font size=3><B>fcrontab</B></font> <font size=3>[</font><font size=3><B>­c f</B></font><font size=3>] [</font><font size=3><B>­n</B></font><font size=3>]</font> <font size=3><I>file</I></font> <font size=3>[</font><font size=3><I>user</I></font> <font size=3>|</font> <font size=3><B>­u</B></font> <font size=3><I>user</I></font><font size=3>]<br>
<B>fcrontab</B></font> <font size=3>[</font><font size=3><B>­c f</B></font><font size=3>] [</font><font size=3><B>­n</B></font><font size=3>] {</font> <font size=3><B>­l</B></font> <font size=3>|</font> <font size=3><B>­r</B></font> <font size=3>|</font> <font size=3><B>­e</B></font> <font size=3>|</font> <font size=3><B>­z</B></font> <font size=3>} [</font><font size=3><I>user</I></font> <font size=3>|</font> <font size=3><B>­u</B></font> <font size=3><I>user</I></font><font size=3>]<br>
<B>fcrontab</B></font> <font size=3>[</font><font size=3><B>­h</B></font><font size=3>]</font></p>
<a name="DESCRIPTION"></a><h2>DESCRIPTION</h2><p style="margin-left: 18%"><font size=3>Fcrontab is the program intended to install, edit, list and remove the tables used by</font> <font size=3><B>fcron</B></font><font size=3>(8) daemon. As fcron internally uses a non­human readable format (this is needed because fcron saves more informations than the user gives, for example the time and date of next execu­ tion), the user cannot edit directly his fcrontab (the one used by fcron).</font></p>
<p style="margin-left: 18%"><font size=3>When a user installs a fcrontab, the source file is saved in the spool directory (</font><font size=3><I>/var/spool/fcron</I></font><font size=3>) to allow future editions, a formatted file is generated for the fcron daemon, which is signaled once about ten seconds before the next minute for all changes made previ­ ously. The daemon is not signaled immediately to keep ill disposed users from blocking the daemon by installing fcrontabs over and over.<br>
We will call "fcrontab" the source file of the fcrontab in the following.</font></p>
<p style="margin-left: 18%"><font size=3>A user can install a fcrontab if he is listed in the</font> <font size=3><I>/etc/fcron.allow</I></font> <font size=3>and not (unless by the key­ word</font> <font size=3><I>all</I></font><font size=3>) listed in</font> <font size=3><I>/etc/fcron.deny</I></font> <font size=3>(see section "files" below). If neither fcron.allow nor fcron.deny exist, every users are allowed. None of these files have to exist, but if they do, the deny file takes precedence.</font></p>
<p style="margin-left: 18%"><font size=3>The first form of the command is used to install a new fcrontab file, from any named file or from standard input if the pseudo­filename "­" is given, replacing the previous one (if any) : each user can have only one fcrontab.</font></p>
<a name="OPTIONS"></a><h2>OPTIONS</h2>
<table width="99%" rules="none" frame="none" cols="3" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="18%">
<p><font size=3><B>­u</B></font></p>
</td>
<td valign="top" align="left" width="63%">
<p><font size=3>Specify the user whose fcrontab will be managed. Should only be used by root. If not given, the fcrontab file of the user invoking</font> <font size=3><B>fcrontab(1)</B></font> <font size=3>will be handled. It may be useful since the</font> <font size=3><B>su</B></font><font size=3>(8) command may confuse fcrontab.<br>
Note that the '</font><font size=3><I>user</I></font><font size=3>' in the synopsys is equivalent to a '</font><font size=3><B>­u</B></font> <font size=3><I>user</I></font><font size=3>'.</font></p>
</td>
</tr>
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="18%">
<p><font size=3><B>­l</B></font></p>
<p><font size=3><B>­e</B></font></p>
</td>
<td valign="top" align="left" width="63%">
<p><font size=3>List user's current fcrontab to standard output.</font></p>
<p><font size=3>Edit user's current fcrontab using either the editor specified by the envi­ ronment variable</font> <font size=3><B>VISUAL</B></font><font size=3>, or</font> <font size=3><B>EDITOR</B></font> <font size=3>if</font> <font size=3><B>VISUAL</B></font> <font size=3>is not set. If none or them are set,</font> <font size=3><I>/bin/vi</I></font> <font size=3>will be used.</font></p>
</td>
</tr>
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="18%">
<p><font size=3><B>­r</B></font></p>
<p><font size=3><B>­z</B></font></p>
</td>
<td valign="top" align="left" width="63%">
<p><font size=3>Remove user's fcrontab.</font></p>
<p><font size=3>Reinstall user's fcrontab from its source code. All informations fcron may have kept in the binary fcrontab (such as the last execution time and date) will be forgotten.</font></p>
</td>
</tr>
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="18%">
<p><font size=3><B>­n</B></font></p>
</td>
<td valign="top" align="left" width="63%">
<p><font size=3>Ignore previous version. If this option is not given, fcron will try to keep as much information as possible between old and new version of the fcrontab (time and date of next execution, if job is in serial queue, etc) if the line hasn't been modified (same fields, same shell command).</font></p>
</td>
</tr>
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="18%">
<p><font size=3><B>­c f</B></font></p>
</td>
<td valign="top" align="left" width="63%">
<p><font size=3>Make fcrontab use config file f instead of default config file /etc/fcron.conf. To interact with a running fcron process, fcrontab must use the same config file as the process. That way, several fcron pro­ cesses can run simultaneously on an only system.</font></p>
</td>
</tr>
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="18%">
<p><font size=3><B>­d</B></font></p>
</td>
<td valign="top" align="left" width="63%">
<p><font size=3>Run in debug mode. In this mode, many informational messages will be output in order to check if anything went wrong.</font></p>
</td>
</tr>
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="18%">
<p><font size=3><B>­h</B></font></p>
<p><font size=3><B>­V</B></font></p>
</td>
<td valign="top" align="left" width="63%">
<p><font size=3>Display a brief description of the options.</font></p>
<p><font size=3>Display an informational message about fcrontab, including its version and the license under which it is distributed.</font></p>
</td>
</tr>
</table>
<!-- Page: 2 -->
<!-- left margin: 220 -->
<!-- right margin: 750 -->
<a name="RETURN VALUES"></a><h2>RETURN VALUES</h2><p style="margin-left: 18%"><font size=3>Fcrontab returns 0 on normal exit and 1 on error.</font></p>
<a name="CONFORMING TO"></a><h2>CONFORMING TO</h2><p style="margin-left: 18%"><font size=3>Should be POSIX compliant.</font></p>
<a name="FILES"></a><h2>FILES</h2>
<table width="99%" rules="none" frame="none" cols="3" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="18%">
<p><font size=3><I>/etc/fcron.conf</I></font></p>
</td>
<td valign="top" align="left" width="63%">
<p><font size=3>Configuration file for fcron and fcrontab : contains paths (spool dir, pid file) and default programs to use (editor, shell, etc). See</font> <font size=3><B>fcron.conf</B></font><font size=3>(5) for more details.</font></p>
</td>
</tr>
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="18%">
<p><font size=3><I>/etc/fcron.allow</I></font></p>
</td>
<td valign="top" align="left" width="63%">
<p><font size=3>Users allowed to use fcrontab (one name per line, special name "all" acts for everyone)</font></p>
</td>
</tr>
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="18%">
<p><font size=3><I>/etc/fcron.deny</I></font></p>
</td>
<td valign="top" align="left" width="63%">
<p><font size=3>Users who are not allowed to use fcrontab (same format as allow file)</font></p>
</td>
</tr>
</table>
<a name="SEE ALSO"></a><h2>SEE ALSO</h2><p style="margin-left: 18%"><font size=3><B>fcrontab</B></font><font size=3>(5),</font> <font size=3><B>fcron</B></font><font size=3>(8),</font> <font size=3><B>fcron.conf</B></font><font size=3>(5).</font></p>
<a name="AUTHOR"></a><h2>AUTHOR</h2><p style="margin-left: 18%"><font size=3>Thibault Godouet <fcron@free.fr></font><br>
</p>
</body>
</html>
