summaryrefslogtreecommitdiffstats
path: root/usr.sbin/cron/crontab/crontab.1
diff options
context:
space:
mode:
Diffstat (limited to 'usr.sbin/cron/crontab/crontab.1')
-rw-r--r--usr.sbin/cron/crontab/crontab.1131
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
OpenPOWER on IntegriCloud