diff options
Diffstat (limited to 'usr.sbin/cron/crontab/crontab.1')
-rw-r--r-- | usr.sbin/cron/crontab/crontab.1 | 131 |
1 files changed, 73 insertions, 58 deletions
diff --git a/usr.sbin/cron/crontab/crontab.1 b/usr.sbin/cron/crontab/crontab.1 index d83aa38..9d13f4b 100644 --- a/usr.sbin/cron/crontab/crontab.1 +++ b/usr.sbin/cron/crontab/crontab.1 @@ -15,86 +15,101 @@ .\" * Paul Vixie <paul@vix.com> uunet!decwrl!vixie!paul .\" */ .\" -.\" $Id$ +.\" $Id: crontab.1,v 1.3 1997/02/22 16:04:51 peter Exp $ .\" -.TH CRONTAB 1 "29 December 1993" -.UC 4 -.SH NAME -crontab \- maintain crontab files for individual users (V3) -.SH SYNOPSIS -crontab [ -u user ] file -.br -crontab [ -u user ] { -l | -r | -e } -.SH DESCRIPTION -.I Crontab +.Dd December 29, 1993 +.Dt CRONTAB 1 +.Os +.Sh NAME +.Nm crontab +.Nd maintain crontab files for individual users (V3) +.Sh SYNOPSIS +.Nm crontab +.Op Fl u Ar user +.Ar file +.Nm crontab +.Op Fl u Ar user +{ +.Fl l | +.Fl r | +.Fl e +} +.Sh DESCRIPTION +.Nm Crontab is the program used to install, deinstall or list the tables used to drive the -.IR cron (8) +.Xr cron 8 daemon in Vixie Cron. Each user can have their own crontab, and though -these are files in /var, they are not intended to be edited directly. -.PP +these are files in +.Pa /var , +they are not intended to be edited directly. +.Pp If the -.I allow +.Pa allow file exists, then you must be listed therein in order to be allowed to use this command. If the -.I allow +.Pa allow file does not exist but the -.I deny -file does exist, then you must \fBnot\fR be listed in the -.I deny +.Pa deny +file does exist, then you must +.Em not +be listed in the +.Pa deny file in order to use this command. If neither of these files exists, then depending on site-dependent configuration parameters, only the super user will be allowed to use this command, or all users will be able to use this command. -.PP -If the -.I -u -option is given, it specifies the name of the user whose crontab is to be +.Pp +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. +.Pp +The following options are available: +.Bl -tag -width indent +.It Fl u +Specify the name of the user whose crontab is to be tweaked. If this option is not given, -.I crontab +.Nm examines "your" crontab, i.e., the crontab of the person executing the command. Note that -.IR su (8) +.Xr su 8 can confuse -.I crontab +.Nm and that if you are running inside of -.IR su (8) +.Xr su 8 you should always use the -.I -u +.Fl u option for safety's sake. -.PP -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. -.PP -The -.I -l -option causes the current crontab to be displayed on standard output. -.PP -The -.I -r -option causes the current crontab to be removed. -.PP -The -.I -e -option is used to edit the current crontab using the editor specified by -the \s-1VISUAL\s+1 or \s-1EDITOR\s+1 environment variables. After you exit +.It Fl l +Display the current crontab on standard output. +.It Fl r +Remove the current crontab. +.It Fl e +Edit the current crontab using the editor specified by +the +.Ev VISUAL +or +.Ev EDITOR +environment variables. After you exit from the editor, the modified crontab will be installed automatically. -.SH "SEE ALSO" -crontab(5), cron(8) -.SH FILES -.nf -/var/cron/allow -/var/cron/deny -.fi -.SH STANDARDS +.El +.Sh SEE ALSO +.Xr crontab 5 , +.Xr cron 8 +.Sh FILES +.Bl -tag -width /var/cron/allow -compact +.It Pa /var/cron/allow +.It Pa /var/cron/deny +.El +.Sh STANDARDS The -.I crontab -command conforms to IEEE Std1003.2-1992 (``POSIX''). This new command syntax +.Nm +command conforms to +.St -p1003.2 . +This new command syntax differs from previous versions of Vixie Cron, as well as from the classic SVR3 syntax. -.SH DIAGNOSTICS +.Sh DIAGNOSTICS A fairly informative usage message appears if you run it with a bad command line. -.SH AUTHOR -.nf -Paul Vixie <paul@vix.com> +.Sh AUTHOR +.An Paul Vixie Aq paul@vix.com |