crontab

NAME

crontab - schedule periodic jobs to run in the background

SYNOPSIS

crontab [-u user] [file]
crontab [-u user] {-e|-l|-p|-r}

The crontab(1) utility manipulates your crontab entry, which is a list of commands and when they should be run in the background. You can replace your crontab entry with a new one specified by file (or standard input if you do not specify file), or you can use the command crontab -e to edit your entry directly.

To run crontab(1), one of the following must apply to you:

You are logged on using the local Administrator account.
Your user name appears in the /usr/lib/cron/cron.allow file.
The /usr/lib/cron/cron.allow file does not exist and your user name does not appear in the /usr/lib/cron/cron.deny file.

If neither the cron.allow file nor the cron.deny file exists, only the local Administrator can run crontab(1).

The crontab(1) utility takes the following options:

-e: Edit your crontab entry; if there is no entry, create an empty one to edit. The crontab(1) utility uses the editor specified by your EDITOR environment variable.
-l: List your crontab entry.
-p: Register the current user's password for use by the cron daemon. The cron daemon will use this password to impersonate this user to execute any crontab entries submitted by this user.
-r: Remove your crontab entry.
-u user: Specify user.

For the syntax and semantics of a crontab file, see crontab(5).

ENVIRONMENT VARIABLES

The crontab(1) utility uses the following environment variable:

EDITOR: The name of the editor to be used when editing a crontab entry.

DIAGNOSTICS

On success, crontab(1) returns 0; if an error occurred, it returns >0.

NOTES

By default, Interix does not execute files with the set-user-ID (setuid) or set-group-ID (setgid) mode bit set for security reasons. If an attempt is made to execute such a file, the ENOSETUID error is returned. For more information and and instructions for enabling execution of files with these mode bits set, see The superuser account and appropriate privileges in Windows Services for UNIX Help.