fcrontab − manipulate per-user fcrontab files |
fcrontab [-c f] [-n] file
[user | -u user] |
Fcrontab is the program intended to install, edit, list and remove the tables used by fcron(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 execution), the user cannot edit directly his fcrontab (the one used by fcron). When a user installs a fcrontab, the source file is saved
in the spool directory (/var/spool/fcron) 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 previously. The daemon is
not signaled immediately to keep ill disposed users from
blocking the daemon by installing fcrontabs over and
over. A user can install a fcrontab if he is listed in the /etc/fcron.allow and not (unless by the keyword all) listed in /etc/fcron.deny (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. 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. |
-u |
Specify the user whose fcrontab will be managed. Should only be used by root. If not given, the fcrontab file of the user invoking fcrontab(1) will be handled. It may be useful since the su(8) command may confuse fcrontab. |
Note that the ’user’ in the synopsys is equivalent to a ’-u user’. |
-l |
List user’s current fcrontab to standard output. |
||
-e |
Edit user’s current fcrontab using either the editor specified by the environment variable VISUAL, or EDITOR if VISUAL is not set. If none or them are set, /usr/bin/vi will be used. |
||
-r |
Remove user’s fcrontab. |
||
-z |
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. |
||
-n |
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). |
||
-c f |
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 processes can run simultaneously on an only system. |
||
-d |
Run in debug mode. In this mode, many informational messages will be output in order to check if anything went wrong. |
||
-h |
Display a brief description of the options. |
||
-V |
Display an informational message about fcrontab, including its version and the license under which it is distributed. |
Fcrontab returns 0 on normal exit and 1 on error. |
Should be POSIX compliant. |
/etc/fcron.conf |
Configuration file for fcron and fcrontab : contains paths (spool dir, pid file) and default programs to use (editor, shell, etc). See fcron.conf(5) for more details. |
/etc/fcron.allow |
Users allowed to use fcrontab (one name per line, special name "all" acts for everyone) |
/etc/fcron.deny |
Users who are not allowed to use fcrontab (same format as allow file) |
fcrontab(5), fcron(8), fcron.conf(5). |
Thibault Godouet <fcron@free.fr> |