crontab.1 (b9ff618c3af22fe5c13cc56ce9db940682bd173e) crontab.1 (aaa66740bff6164c0f23ded738fcc202043b38a7)
1.\"/* Copyright 1988,1990,1993 by Paul Vixie
2.\" * All rights reserved
3.\" *
4.\" * Distribute freely, except: don't remove my name from the source or
5.\" * documentation (don't take credit for my work), mark your changes (don't
6.\" * get me blamed for your possible bugs), don't alter or remove this
7.\" * notice. May be sold if buildable source is provided to buyer. No
8.\" * warrantee of any kind, express or implied, is included with this

--- 26 unchanged lines hidden (view full) ---

35.Fl e
36}
37.Sh DESCRIPTION
38The
39.Nm
40utility is the program used to install, deinstall or list the tables
41used to drive the
42.Xr cron 8
1.\"/* Copyright 1988,1990,1993 by Paul Vixie
2.\" * All rights reserved
3.\" *
4.\" * Distribute freely, except: don't remove my name from the source or
5.\" * documentation (don't take credit for my work), mark your changes (don't
6.\" * get me blamed for your possible bugs), don't alter or remove this
7.\" * notice. May be sold if buildable source is provided to buyer. No
8.\" * warrantee of any kind, express or implied, is included with this

--- 26 unchanged lines hidden (view full) ---

35.Fl e
36}
37.Sh DESCRIPTION
38The
39.Nm
40utility is the program used to install, deinstall or list the tables
41used to drive the
42.Xr cron 8
43daemon in Vixie Cron. Each user can have their own crontab, and though
43daemon in Vixie Cron.
44Each user can have their own crontab, and though
44these are files in
45.Pa /var ,
46they are not intended to be edited directly.
47.Pp
48If the
49.Pa allow
50file exists, then you must be listed therein in order to be allowed to use
45these are files in
46.Pa /var ,
47they are not intended to be edited directly.
48.Pp
49If the
50.Pa allow
51file exists, then you must be listed therein in order to be allowed to use
51this command. If the
52this command.
53If the
52.Pa allow
53file does not exist but the
54.Pa deny
55file does exist, then you must
56.Em not
57be listed in the
58.Pa deny
54.Pa allow
55file does not exist but the
56.Pa deny
57file does exist, then you must
58.Em not
59be listed in the
60.Pa deny
59file in order to use this command. If neither of these files exists, then
61file in order to use this command.
62If neither of these files exists, then
60depending on site-dependent configuration parameters, only the super user
61will be allowed to use this command, or all users will be able to use this
62command.
63The format of these files is one username per line,
64with no leading or trailing whitespace.
65Lines of other formats will be ignored,
66and so can be used for comments.
67.Pp
68The first form of this command is used to install a new crontab from some
63depending on site-dependent configuration parameters, only the super user
64will be allowed to use this command, or all users will be able to use this
65command.
66The format of these files is one username per line,
67with no leading or trailing whitespace.
68Lines of other formats will be ignored,
69and so can be used for comments.
70.Pp
71The first form of this command is used to install a new crontab from some
69named file or standard input if the pseudo-filename ``-'' is given.
72named file or standard input if the pseudo-filename
73.Dq -
74is given.
70.Pp
71The following options are available:
72.Bl -tag -width indent
73.It Fl u
74Specify the name of the user whose crontab is to be
75.Pp
76The following options are available:
77.Bl -tag -width indent
78.It Fl u
79Specify the name of the user whose crontab is to be
75tweaked. If this option is not given,
80tweaked.
81If this option is not given,
76.Nm
82.Nm
77examines "your" crontab, i.e., the crontab of the person executing the
78command. Note that
83examines
84.Dq your
85crontab, i.e., the crontab of the person executing the
86command.
87Note that
79.Xr su 1
80can confuse
81.Nm
82and that if you are running inside of
83.Xr su 1
84you should always use the
85.Fl u
86option for safety's sake.

--- 27 unchanged lines hidden (view full) ---

114The
115.Nm
116command conforms to
117.St -p1003.2
118with the exception that the dangerous variant of calling
119.Nm
120without a file name in the first form of the command is not allowed by
121this implementation.
88.Xr su 1
89can confuse
90.Nm
91and that if you are running inside of
92.Xr su 1
93you should always use the
94.Fl u
95option for safety's sake.

--- 27 unchanged lines hidden (view full) ---

123The
124.Nm
125command conforms to
126.St -p1003.2
127with the exception that the dangerous variant of calling
128.Nm
129without a file name in the first form of the command is not allowed by
130this implementation.
122The pseudo-filename ``-'' must be specified to read from standard input.
131The pseudo-filename
132.Dq -
133must be specified to read from standard input.
123The new command syntax
124differs from previous versions of Vixie Cron, as well as from the classic
125SVR3 syntax.
126.Sh DIAGNOSTICS
127A fairly informative usage message appears if you run it with a bad command
128line.
129.Sh AUTHORS
130.An Paul Vixie Aq paul@vix.com
134The new command syntax
135differs from previous versions of Vixie Cron, as well as from the classic
136SVR3 syntax.
137.Sh DIAGNOSTICS
138A fairly informative usage message appears if you run it with a bad command
139line.
140.Sh AUTHORS
141.An Paul Vixie Aq paul@vix.com