Generated by groff

fcrontab.1


NAME
SYNOPSIS
DESCRIPTION
OPTIONS
RETURN VALUES
CONFORMING TO
FILES
SEE ALSO
AUTHOR

NAME

fcrontab - manipulate per-user fcrontab files

SYNOPSIS

fcrontab [-u user] [-n] file
fcrontab [-u user] [-n] { -l | -r | -e | -z }
fcrontab [-h]

DESCRIPTION

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 edi- tions, a formated file is generated for fcron daemon, which is signaled once about ten seconds before the next minute for all changes made previously. Daemon is not signaled immediately to keep ill disposed users from block- ing the daemon by installing fcrontabs over and over.
We will call "fcrontab" the source file of the fcrontab in the following.

A user can install a fcrontab if he is listed in the /etc/fcron.allow and not (unless by the all keyword) listed in /etc/fcron.deny (see section "files" below). If neither the fcron.allow nor the fcron.deny file exists, every users are allowed. If the allow file exists and the user is listed inside but the deny file is absent, or if no allow file but the deny file exist and the user is not listed in it, then the user is also allowed. Otherwise, the user is rejected.

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).

OPTIONS

-u

Specify the user whose fcrontab will be managed. Should only be used by root. If not given, your (the user who is executing the command) fcrontab file will be handled. It may be useful since the su(8) command may confuse fcrontab.

-l

-e

List user's current fcrontab to standard output.

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

-z

-n

Remove user's fcrontab.

Reinstall user's fcrontab from its source code.

Ignore previous version. If this option is not given, fcron will try to keep as many informa- tions as he can between old and new version of the fcrontab (time and date of next execu- tion, if job is or not in serial queue, etc) if the line hasn't been modified (same fields, same shell command).

-d

Run in debug mode. In this mode, many informational messages will be output in order to check if anything went wrong.

-h

-V

Display a brief description of the options.

Display an informational message about fcrontab, including his version and the license
under which it is distributed.

RETURN VALUES

Fcrontab returns 0 on normal exit and 1 on error.

CONFORMING TO

Should be POSIX compliant.

FILES

/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)

SEE ALSO

fcron(8), fcrontab(5)

AUTHOR

Thibault Godouet <fcron@free.fr>