Content-type: text/html
Manpage of FCRONTAB
FCRONTAB
Section: User Commands (1)
Updated: 12/25/2001
Index
Return to Main Contents
NAME
fcrontab - manipulate per-user fcrontab files
SYNOPSIS
fcrontab
[-c f] [-n]
file [user |
-u
user]
fcrontab
[-c f] [-n]
{ -l | -r | -e | -z }
[user |
-u
user]
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 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.
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 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.
OPTIONS
- -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,
/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.
RETURN VALUES
Fcrontab returns 0 on normal exit and 1 on error.
CONFORMING TO
Should be POSIX compliant.
FILES
- /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)
- /etc/pam.d/fcrontab (or /etc/pam.conf)
-
PAM configuration file for fcrontab. Take a look at
pam(8) for more details.
SEE ALSO
fcrontab(5),
fcron(8),
fcron.conf(5).
AUTHOR
Thibault Godouet <fcron@free.fr>
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- RETURN VALUES
-
- CONFORMING TO
-
- FILES
-
- SEE ALSO
-
- AUTHOR
-
This document was created by
man2html,
using the manual pages.
Time: 13:50:56 GMT, December 25, 2001