CRONTAB(1)                 OpenBSD Reference Manual                 CRONTAB(1)

NAME
     crontab - maintain crontab files for individual users (V3)

SYNOPSIS
     crontab [-u user] file
     crontab [-u user] [-l | -r | -e]

DESCRIPTION
     crontab is the program used to install, deinstall, or list the tables
     used to drive the cron(8) daemon in Vixie Cron.  Each user can have their
     own crontab(5), and though these are files in /var/cron/tabs, they are
     not intended to be edited directly.

     If the /var/cron/allow file exists, then you must be listed therein in
     order to use crontab. If the /var/cron/allow file does not exist but the
     /var/cron/deny file does exist, then you must not be listed in the
     /var/cron/deny file in order to use crontab. If neither of these files
     exists, then depending on site-dependent configuration parameters, only
     the super user will be allowed to use crontab, or all users will be able
     to use it.

     If the -u option is given, user specifies the name of the user whose
     crontab(5) is to be tweaked.  If this option is not given, crontab exam-
     ines ``your'' crontab(5); i.e., the crontab of the person executing the
     command.  Note that su(8) can confuse crontab and that if you are running
     inside of su(8) you should always use the -u option for safety's sake.

     The first form of this command is used to install a new crontab from some
     named file, or standard input if the pseudo-filename `-' is given.

     The -l option causes the current crontab to be displayed on standard out-
     put.

     The -r option causes the current crontab to be removed.

     The -e option is used to edit the current crontab using the editor speci-
     fied by the VISUAL or EDITOR environment variables.  After you exit from
     the editor, the modified crontab(5) will be installed automatically.

FILES
     /var/cron/allow  list of users allowed to use crontab
     /var/cron/deny   list of users prohibited from using crontab
     /var/cron/tabs   directory of individual crontabs

SEE ALSO
     crontab(5), cron(8)

STANDARDS
     The crontab utility is compliant with the IEEE Std1003.2-1992
     (``POSIX.2'') specification.  This new command syntax differs from previ-
     ous versions of Vixie Cron, as well as from the classic SVR3 syntax.

DIAGNOSTICS
     A fairly informative usage message appears if you run it with a bad com-
     mand line.

AUTHOR
     Paul Vixie <paul@vix.com>

OpenBSD 2.9                      June 8, 1999                                1
