OpenBSD CVS

CVS log for src/usr.sbin/cron/crontab.5


[BACK] Up to [local] / src / usr.sbin / cron

Request diff between arbitrary revisions


Default branch: MAIN


Revision 1.42 / (download) - annotate - [select for diffs], Sat May 6 23:06:27 2023 UTC (13 months ago) by millert
Branch: MAIN
CVS Tags: OPENBSD_7_5_BASE, OPENBSD_7_5, OPENBSD_7_4_BASE, OPENBSD_7_4, HEAD
Changes since 1.41: +15 -4 lines
Diff to previous 1.41 (colored)

Support random offsets when using ranges with a step value in cron.
This extends the random range syntax to support step values.  Instead
of choosing a random number between the high and low values, the
field is treated as a range with a random offset less than the step
value.  This can be used to avoid thundering herd problems where
multiple machines contact a server all at the same time via cron jobs.

The syntax is similar to the existing range/step syntax but uses a
random range.  For example, instead of "0-59/10" in the minutes
field, "0~59/10" can be used to run a command every 10 minutes where
the first command starts at a random offset in the range [0,9].
The high and low numbers are optional, "~/10" can be used instead.

Requested by job@, OK phessler@

Revision 1.41 / (download) - annotate - [select for diffs], Sat Apr 18 17:11:40 2020 UTC (4 years, 1 month ago) by jmc
Branch: MAIN
CVS Tags: OPENBSD_7_3_BASE, OPENBSD_7_3, OPENBSD_7_2_BASE, OPENBSD_7_2, OPENBSD_7_1_BASE, OPENBSD_7_1, OPENBSD_7_0_BASE, OPENBSD_7_0, OPENBSD_6_9_BASE, OPENBSD_6_9, OPENBSD_6_8_BASE, OPENBSD_6_8, OPENBSD_6_7_BASE, OPENBSD_6_7
Changes since 1.40: +15 -19 lines
Diff to previous 1.40 (colored)

rename the "options" field to "flags" (as suggested by millert): an optional
options field was difficult to describe concisely;

- tweak wording accordingly
- sort flags
- condense STANDARDS to avoid text repitition, as suggested by deraadt
- document flags may be combined, now deraadt fixed the parsing

ok millert deraadt

Revision 1.40 / (download) - annotate - [select for diffs], Thu Apr 16 19:30:50 2020 UTC (4 years, 1 month ago) by deraadt
Branch: MAIN
Changes since 1.39: +35 -25 lines
Diff to previous 1.39 (colored)

Reflow text so that the -[nsq] options are described as an optional [options]
field before command, rather than muddling up the command description to
explain them messily as some sort of exception
ok millert

Revision 1.39 / (download) - annotate - [select for diffs], Thu Apr 16 17:51:56 2020 UTC (4 years, 1 month ago) by millert
Branch: MAIN
Changes since 1.38: +9 -2 lines
Diff to previous 1.38 (colored)

Add a mechanism to prevent cron jobs from running concurrently.
This adds a new "-s" flag to the command field which indicates that
only a single instance of the job should run concurrenty.
OK beck@ job@ deraadt@

Revision 1.38 / (download) - annotate - [select for diffs], Wed Apr 15 01:59:34 2020 UTC (4 years, 1 month ago) by millert
Branch: MAIN
Changes since 1.37: +21 -3 lines
Diff to previous 1.37 (colored)

Add support for random values using the '~' operator.
For example "0~30" will result in a random value between 0 and 30
inclusive.  If either (or both) of the numbers on either side of
the '~' are omitted, the appropriate limit (low or high) for the
field will be used.  OK deraadt@ beck@ jmc@

Revision 1.37 / (download) - annotate - [select for diffs], Mon Jan 6 19:44:09 2020 UTC (4 years, 5 months ago) by job
Branch: MAIN
Changes since 1.36: +8 -3 lines
Diff to previous 1.36 (colored)

Add "-n" to EXAMPLES in crontab(5)'s man page

OK Ingo Schwarze

Revision 1.36 / (download) - annotate - [select for diffs], Wed Jun 13 13:27:37 2018 UTC (5 years, 11 months ago) by jmc
Branch: MAIN
CVS Tags: OPENBSD_6_6_BASE, OPENBSD_6_6, OPENBSD_6_5_BASE, OPENBSD_6_5, OPENBSD_6_4_BASE, OPENBSD_6_4
Changes since 1.35: +3 -3 lines
Diff to previous 1.35 (colored)

avoid a double flag;

Revision 1.35 / (download) - annotate - [select for diffs], Wed Jun 13 11:27:30 2018 UTC (5 years, 11 months ago) by job
Branch: MAIN
Changes since 1.34: +19 -10 lines
Diff to previous 1.34 (colored)

Add crontab entry option -n for "No mail when run successful"

OK jmc@ millert@

Revision 1.34 / (download) - annotate - [select for diffs], Wed Oct 12 17:27:08 2016 UTC (7 years, 7 months ago) by schwarze
Branch: MAIN
CVS Tags: OPENBSD_6_3_BASE, OPENBSD_6_3, OPENBSD_6_2_BASE, OPENBSD_6_2, OPENBSD_6_1_BASE, OPENBSD_6_1
Changes since 1.33: +12 -1 lines
Diff to previous 1.33 (colored)

Document the "-q " prefix accepted in the "command" field.
Original patch from Wouter Clarie <wclarie at gmail com>,
tweaked in joint work with jca@,
OK millert@, OK jca@ on an earlier version.

Revision 1.33 / (download) - annotate - [select for diffs], Thu Jan 30 20:02:42 2014 UTC (10 years, 4 months ago) by jmc
Branch: MAIN
CVS Tags: OPENBSD_6_0_BASE, OPENBSD_6_0, OPENBSD_5_9_BASE, OPENBSD_5_9, OPENBSD_5_8_BASE, OPENBSD_5_8, OPENBSD_5_7_BASE, OPENBSD_5_7, OPENBSD_5_6_BASE, OPENBSD_5_6, OPENBSD_5_5_BASE, OPENBSD_5_5
Changes since 1.32: +3 -1 lines
Diff to previous 1.32 (colored)

reinstate the note that setting env vars in a crontab is an extension;
ok millert (actually it was millert who pointed it out) + sobrado

Revision 1.32 / (download) - annotate - [select for diffs], Thu Jan 30 17:49:40 2014 UTC (10 years, 4 months ago) by jmc
Branch: MAIN
Changes since 1.31: +112 -169 lines
Diff to previous 1.31 (colored)

reorganise this file into something a bit saner, killing wacky macros
as we go;

ok sobrado millert

Revision 1.31 / (download) - annotate - [select for diffs], Thu Jan 30 13:32:58 2014 UTC (10 years, 4 months ago) by jmc
Branch: MAIN
Changes since 1.30: +25 -41 lines
Diff to previous 1.30 (colored)

update the EXTENSIONS section, renaming it to STANDARDS while here;
help/ok millert sobrado

Revision 1.30 / (download) - annotate - [select for diffs], Mon Jan 20 05:07:48 2014 UTC (10 years, 4 months ago) by schwarze
Branch: MAIN
Changes since 1.29: +2 -2 lines
Diff to previous 1.29 (colored)

Obvious .Xr fixes, found while testing mandocdb(8).

Revision 1.29 / (download) - annotate - [select for diffs], Wed Aug 14 16:07:53 2013 UTC (10 years, 9 months ago) by jmc
Branch: MAIN
Changes since 1.28: +1 -2 lines
Diff to previous 1.28 (colored)

editing blip in previous;

Revision 1.28 / (download) - annotate - [select for diffs], Wed Aug 14 14:58:06 2013 UTC (10 years, 9 months ago) by millert
Branch: MAIN
Changes since 1.27: +10 -33 lines
Diff to previous 1.27 (colored)

ISC cron is the defacto BSD cron these days so remove confusing
remarks about the historic BSD and SysV crons.  OK jmc@

Revision 1.27 / (download) - annotate - [select for diffs], Wed Aug 14 08:41:16 2013 UTC (10 years, 9 months ago) by jmc
Branch: MAIN
Changes since 1.26: +4 -4 lines
Diff to previous 1.26 (colored)

macro simplification;
From: Jan Stary

Revision 1.26 / (download) - annotate - [select for diffs], Wed Aug 14 08:39:32 2013 UTC (10 years, 9 months ago) by jmc
Branch: MAIN
Changes since 1.25: +27 -9 lines
Diff to previous 1.25 (colored)

some Bx/Ox conversion;
From: Jan Stary

Revision 1.25 / (download) - annotate - [select for diffs], Tue Jul 16 11:13:33 2013 UTC (10 years, 10 months ago) by schwarze
Branch: MAIN
CVS Tags: OPENBSD_5_4_BASE, OPENBSD_5_4
Changes since 1.24: +3 -3 lines
Diff to previous 1.24 (colored)

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@

Revision 1.24 / (download) - annotate - [select for diffs], Fri Nov 19 17:16:48 2010 UTC (13 years, 6 months ago) by millert
Branch: MAIN
CVS Tags: OPENBSD_5_3_BASE, OPENBSD_5_3, OPENBSD_5_2_BASE, OPENBSD_5_2, OPENBSD_5_1_BASE, OPENBSD_5_1, OPENBSD_5_0_BASE, OPENBSD_5_0, OPENBSD_4_9_BASE, OPENBSD_4_9
Changes since 1.23: +3 -3 lines
Diff to previous 1.23 (colored)

Use regular double quotes ("") in the MAILTO example so we don't
suggest something that is a syntax error.  OK jmc@

Revision 1.23 / (download) - annotate - [select for diffs], Mon Sep 20 07:41:17 2010 UTC (13 years, 8 months ago) by jmc
Branch: MAIN
Changes since 1.22: +3 -3 lines
Diff to previous 1.22 (colored)

according to ingo, it isn;t a problem to have empty [BDS]q macros, so
revert that part of yesterday's diffs;

Revision 1.22 / (download) - annotate - [select for diffs], Sun Sep 19 21:59:23 2010 UTC (13 years, 8 months ago) by jmc
Branch: MAIN
Changes since 1.21: +3 -3 lines
Diff to previous 1.21 (colored)

more wacky macro fixing;

Revision 1.21 / (download) - annotate - [select for diffs], Thu May 31 19:20:23 2007 UTC (17 years ago) by jmc
Branch: MAIN
CVS Tags: OPENBSD_4_8_BASE, OPENBSD_4_8, OPENBSD_4_7_BASE, OPENBSD_4_7, OPENBSD_4_6_BASE, OPENBSD_4_6, OPENBSD_4_5_BASE, OPENBSD_4_5, OPENBSD_4_4_BASE, OPENBSD_4_4, OPENBSD_4_3_BASE, OPENBSD_4_3, OPENBSD_4_2_BASE, OPENBSD_4_2
Changes since 1.20: +2 -2 lines
Diff to previous 1.20 (colored)

convert to new .Dd format;

Revision 1.20 / (download) - annotate - [select for diffs], Thu Jun 17 22:11:55 2004 UTC (19 years, 11 months ago) by millert
Branch: MAIN
CVS Tags: OPENBSD_4_1_BASE, OPENBSD_4_1, OPENBSD_4_0_BASE, OPENBSD_4_0, OPENBSD_3_9_BASE, OPENBSD_3_9, OPENBSD_3_8_BASE, OPENBSD_3_8, OPENBSD_3_7_BASE, OPENBSD_3_7, OPENBSD_3_6_BASE, OPENBSD_3_6
Changes since 1.19: +9 -9 lines
Diff to previous 1.19 (colored)

UUpdate ISC copyright year to 2004
Remove unused macros Skip_Line and MkLower
Remove trailing whitespace

Revision 1.19 / (download) - annotate - [select for diffs], Thu Jun 12 12:59:50 2003 UTC (21 years ago) by jmc
Branch: MAIN
CVS Tags: OPENBSD_3_5_BASE, OPENBSD_3_5, OPENBSD_3_4_BASE, OPENBSD_3_4
Changes since 1.18: +2 -2 lines
Diff to previous 1.18 (colored)

- section reorder
- macro fixes
- kill whitespace at EOL
- new sentence, new line

Revision 1.18 / (download) - annotate - [select for diffs], Thu Feb 20 20:38:08 2003 UTC (21 years, 3 months ago) by millert
Branch: MAIN
CVS Tags: OPENBSD_3_3_BASE, OPENBSD_3_3
Changes since 1.17: +3 -1 lines
Diff to previous 1.17 (colored)

Sync with ISC cron-current + my at(1) integration.
The at(1) code is now more tightly integrated into the cron codebase.

Revision 1.17 / (download) - annotate - [select for diffs], Mon Jul 8 18:11:02 2002 UTC (21 years, 11 months ago) by millert
Branch: MAIN
CVS Tags: OPENBSD_3_2_BASE, OPENBSD_3_2
Changes since 1.16: +2 -2 lines
Diff to previous 1.16 (colored)

Merge in some changes from Paul Vixie's tree; most are cosmetic
o ANSI function headers
o return (foo) not return foo
o add -oi to sendmail flags
o update email address in man pages
o make some strings const
o completely remove globbing cruft from popen.c
o whitespace changes
o add DOW_STAR to flags for "monthly", "weekly", and "daily" cron entries

Revision 1.16 / (download) - annotate - [select for diffs], Wed Aug 22 23:14:27 2001 UTC (22 years, 9 months ago) by hugh
Branch: MAIN
CVS Tags: OPENBSD_3_1_BASE, OPENBSD_3_1, OPENBSD_3_0_BASE, OPENBSD_3_0
Changes since 1.15: +5 -4 lines
Diff to previous 1.15 (colored)

More manpage mania. Crontab entries are comprised of a certain number
of fixed fields (the time spec, etc) and a command which may itself
be one or more fields long. Make this clear.

Revision 1.15 / (download) - annotate - [select for diffs], Wed Aug 22 18:29:29 2001 UTC (22 years, 9 months ago) by heko
Branch: MAIN
Changes since 1.14: +2 -2 lines
Diff to previous 1.14 (colored)

 o System crontab has seven (7) fields
 o User crontab has six (6) fields
 o Closes PR 2021; thanks jamesez@cerberus.jimz.net
 o Okay millert@

Revision 1.14 / (download) - annotate - [select for diffs], Thu Aug 2 18:37:34 2001 UTC (22 years, 10 months ago) by mpech
Branch: MAIN
Changes since 1.13: +2 -2 lines
Diff to previous 1.13 (colored)

o) .Sh AUTHOR -> .Sh AUTHORS;
o) .Sh EXAMPLE -> .Sh EXAMPLES;
o) Delete .Sh OPTIONS. Text moved to .Sh DESCRIPTION;

millert@ ok

Revision 1.13 / (download) - annotate - [select for diffs], Tue Jun 19 22:40:24 2001 UTC (22 years, 11 months ago) by millert
Branch: MAIN
Changes since 1.12: +3 -13 lines
Diff to previous 1.12 (colored)

o Don't talk about /bin/mail vs. sendmail since we always build with
  sendmail support.
o Remove misleading info in STANDARDS about the syntax being different
  from previous Vixie Cron versions.  The flags have been this way for
  all versions of cron we have shipped with.

Revision 1.12 / (download) - annotate - [select for diffs], Sun Feb 18 19:48:32 2001 UTC (23 years, 3 months ago) by millert
Branch: MAIN
CVS Tags: OPENBSD_2_9_BASE, OPENBSD_2_9
Changes since 1.11: +15 -15 lines
Diff to previous 1.11 (colored)

Update to ISC cron 4.0b1 + our patches.  This is now under a BSD license.
I also fixed the signal handlers while I was at it.

Revision 1.11 / (download) - annotate - [select for diffs], Sat Apr 15 11:53:29 2000 UTC (24 years, 1 month ago) by aaron
Branch: MAIN
CVS Tags: OPENBSD_2_8_BASE, OPENBSD_2_8, OPENBSD_2_7_BASE, OPENBSD_2_7
Changes since 1.10: +4 -4 lines
Diff to previous 1.10 (colored)

- `coexist', not `co-exist'; it's not hyphenated.
- Correct some .Nm usage.

Revision 1.10 / (download) - annotate - [select for diffs], Sun Mar 19 17:57:03 2000 UTC (24 years, 2 months ago) by aaron
Branch: MAIN
Changes since 1.9: +33 -21 lines
Diff to previous 1.9 (colored)

Remove hard sentence breaks. Add $OpenBSD$ tags where appropriate. Some other
cleanup along the way.

Revision 1.9 / (download) - annotate - [select for diffs], Mon Jan 10 08:19:18 2000 UTC (24 years, 5 months ago) by deraadt
Branch: MAIN
Changes since 1.8: +2 -2 lines
Diff to previous 1.8 (colored)

the the

Revision 1.8 / (download) - annotate - [select for diffs], Fri Jul 9 13:35:53 1999 UTC (24 years, 11 months ago) by aaron
Branch: MAIN
CVS Tags: OPENBSD_2_6_BASE, OPENBSD_2_6
Changes since 1.7: +6 -6 lines
Diff to previous 1.7 (colored)

- remove all trailing whitespace
     * except when it is escaped with a `\' at the end of the line
- fix remaining .Nm usage as well
- this is from a patch I received from kwesterback@home.com, who has been
  working on some scripts for fixing formatting errors in mdoc'd man pages

Ok, so there could be a cost/benefit debate with this commit, but since I have
the patch we might as well commit it...

Revision 1.7 / (download) - annotate - [select for diffs], Wed Jul 7 10:50:11 1999 UTC (24 years, 11 months ago) by aaron
Branch: MAIN
Changes since 1.6: +2 -2 lines
Diff to previous 1.6 (colored)

The proper order of the ``introductory'' macros in a man page is .Dd/.Dt/.Os.
Out of the approximately 1450 man pages, only about 90 of them were wrong.
Thanks to kwesterback@home.com for coming up with a script and patch to repair
this. The patch also inserted a .Os macro in the few man pages that were
missing one.

Revision 1.6 / (download) - annotate - [select for diffs], Fri Jul 2 20:11:48 1999 UTC (24 years, 11 months ago) by aaron
Branch: MAIN
Changes since 1.5: +2 -2 lines
Diff to previous 1.5 (colored)

consistent .Dd usage; proper format is: .Dd Month DD, YYYY

Revision 1.5 / (download) - annotate - [select for diffs], Fri Jun 18 02:11:44 1999 UTC (24 years, 11 months ago) by aaron
Branch: MAIN
Changes since 1.4: +355 -161 lines
Diff to previous 1.4 (colored)

new mandoc cron(8), crontab(1), and crontab(5) man pages; kwesterback@home.com

Revision 1.4 / (download) - annotate - [select for diffs], Sat Jun 5 22:16:35 1999 UTC (25 years ago) by aaron
Branch: MAIN
Changes since 1.3: +3 -3 lines
Diff to previous 1.3 (colored)

remove trailing whitespace, some Nm cleanup

Revision 1.3 / (download) - annotate - [select for diffs], Thu Jul 17 07:34:44 1997 UTC (26 years, 10 months ago) by deraadt
Branch: MAIN
CVS Tags: OPENBSD_2_5_BASE, OPENBSD_2_5, OPENBSD_2_4_BASE, OPENBSD_2_4, OPENBSD_2_3_BASE, OPENBSD_2_3, OPENBSD_2_2_BASE, OPENBSD_2_2
Changes since 1.2: +30 -3 lines
Diff to previous 1.2 (colored)

doc @ commands; mouse

Revision 1.2 / (download) - annotate - [select for diffs], Sat Dec 7 09:13:11 1996 UTC (27 years, 6 months ago) by deraadt
Branch: MAIN
CVS Tags: OPENBSD_2_1_BASE, OPENBSD_2_1
Changes since 1.1: +2 -2 lines
Diff to previous 1.1 (colored)

months are from 1-12 not 0-12, netbsd pr#2806, mouse@Rodents.Montreal.QC.CA

Revision 1.1.1.1 / (download) - annotate - [select for diffs] (vendor branch), Wed Oct 18 08:47:30 1995 UTC (28 years, 7 months ago) by deraadt
CVS Tags: netbsd_1_1, OPENBSD_2_0_BASE, OPENBSD_2_0
Changes since 1.1: +0 -0 lines
Diff to previous 1.1 (colored)

initial import of NetBSD tree

Revision 1.1 / (download) - annotate - [select for diffs], Wed Oct 18 08:47:30 1995 UTC (28 years, 7 months ago) by deraadt
Branch: MAIN

Initial revision

This form allows you to request diff's between any two revisions of a file. You may select a symbolic revision name using the selection box or you may type in a numeric name using the type-in text box.