93 lines
2.1 KiB
Groff
93 lines
2.1 KiB
Groff
.TH CRONTAB 1
|
|
.SH NAME
|
|
crontab \- User crontab manipulation
|
|
.SH SYNOPSIS
|
|
.B crontab \-c
|
|
.RI [ user ]
|
|
.I file
|
|
.br
|
|
.B crontab \-l
|
|
.RI [ user ]
|
|
.br
|
|
.B crontab \-r
|
|
.RI [ user ]
|
|
.br
|
|
.B crontab \-p
|
|
.SH DESCRIPTION
|
|
The
|
|
.B crontab
|
|
program allows users to manipulate their personal crontab files. These
|
|
files are hidden in
|
|
.BI /usr/spool/crontabs/ user
|
|
where
|
|
.I user
|
|
is the login name of a given user. The system daemon
|
|
.B cron
|
|
uses these crontabs, among others, to run tasks that are to be repeated at
|
|
regular intervals. See
|
|
.BR crontab (5)
|
|
on what a good crontab file should look like.
|
|
.PP
|
|
Only the superuser can specify a user name to manipulate the crontab of a
|
|
given user. Any other user can only touch their own crontab file.
|
|
.SH OPTIONS
|
|
.TP
|
|
\fB\-c\fR [\fIuser\fR] \fIfile\fR
|
|
Install
|
|
.I file
|
|
as the crontab file of
|
|
.IR user .
|
|
.TP
|
|
\fB\-l\fR [\fIuser\fR]
|
|
List the crontab file of
|
|
.I user
|
|
to standard output.
|
|
.TP
|
|
\fB\-r\fR [\fIuser\fR]
|
|
Remove the crontab file of
|
|
.IR user .
|
|
.TP
|
|
\fB\-p\fR
|
|
Tell cron to reload its tables. Useful for system administrators to signal
|
|
a change to any of the system crontab files. Changes made by the
|
|
.B crontab
|
|
program are signalled automatically. (Mnemonic: \-p = "ping".)
|
|
.SH FILES
|
|
.TP \w'/usr/spool/crontabs/user'u+5n
|
|
.BI /usr/spool/crontabs/ user
|
|
Per user personal crontab file.
|
|
.SH "SEE ALSO"
|
|
.BR crontab (5),
|
|
.BR cron (8).
|
|
.SH DIAGNOSTICS
|
|
.B Crontab
|
|
preparses a new crontab and only installs it if correct. All errors are
|
|
sent to standard error, messages about installing a new table and telling
|
|
.B cron
|
|
to reload are sent to standard output.
|
|
.SH BUGS
|
|
.B Crontab
|
|
misses a
|
|
.B \-e
|
|
option that other implementations of this command allow one to edit the
|
|
current crontab and install the result. Seems quite handy until you try to
|
|
install a new crontab from an automated script. That's why this command
|
|
has a
|
|
.B \-c
|
|
option that installs a prepared crontab file. Use
|
|
.PP
|
|
.RS
|
|
.nf
|
|
crontab \-l >/tmp/tab
|
|
${EDITOR\-vi} /tmp/tab
|
|
crontab \-c /tmp/tab
|
|
.fi
|
|
.RE
|
|
.PP
|
|
to get the same effect as
|
|
.BR "crontab \-e" .
|
|
.SH AUTHOR
|
|
Kees J. Bot (kjb@cs.vu.nl)
|
|
|
|
.\"
|
|
.\" $PchId: crontab.1,v 1.3 2000/07/17 18:51:04 philip Exp $
|