usr.sbin/cron/doc/CHANGES

   1 $FreeBSD$
   2 --------
   3
   4 Vixie Cron              Changes from V2 to V3
   5 Paul Vixie
   6 29-Dec-1993
   7
   8 The crontab command now conforms to POSIX 1003.2.  This means that when you
   9 install it, if you have any "crontab" command lines floating around in shell
  10 scripts (such as /etc/rc or /etc/rc.local), you will need to change them.
  11
  12 I have integrated several changes made by BSDi for their BSD/386 operating
  13 system; these were offerred to me before I started consulting for them, so
  14 it is safe to say that they were intended for publication.  Most notably,
  15 the name of the cron daemon has changed from "crond" to "cron".  This was
  16 done for compatibility with 4.3BSD.  Another change made for the same reason
  17 is the ability to read in an /etc/crontab file which has an extra field in
  18 each entry, between the time fields and the command.  This field is a user
  19 name, and it permits the /etc/crontab command to contain commands which are
  20 to be run by any user on the system.  /etc/crontab is not "installed" via
  21 the crontab(1) command; it is automatically read at startup time and it will
  22 be reread whenever it changes.
  23
  24 I also added a "-e" option to crontab(1).  Nine people also sent me diffs
  25 to add this option, but I had already implemented it on my own.  I actually
  26 released an interim version (V2.2, I think) for limited testing, and got a
  27 chance to fix a bad security bug in the "-e" option thanks to XXX.
  28
  29 The daemon used to be extraordinarily sloppy in its use of file descriptors.
  30 A heck of a lot of them were left open in spawned jobs, which caused problems
  31 for the daemon and also caused problems with the spawned jobs if they were
  32 shell scripts since "sh" and "csh" have traditionally used hidden file
  33 descriptors to pass information to subshells, and cron was causing them to
  34 think they were subshells.  If you had trouble with "sh" or "csh" scripts in
  35 V2, chances are good that V3 will fix your problems.
  36
  37 About a dozen people have reminded me that I forgot to initialize
  38 "crontab_fd" in database.c.  Keith Cantrell was the first, so he gets the
  39 point.
  40
  41 Steve Simmons reminded me that once an account has been deleted from the
  42 system, "crontab -u USER -d" will not work.  My solution is to suggest to
  43 all of you that before you delete a user's account, you first delete that
  44 user's crontab file if any.  From cron's point of view, usernames can never
  45 be treated as arbitrary strings.  Either they are valid user names, or they
  46 are not.  I will not make an exception for the "-d" case, for security
  47 reasons that I consider reasonable.  It is trivial for a root user to delete
  48 the entry by hand if necessary.
  49
  50 Dan O'Neil reminded me that I forgot to reset "log_fd" in misc.c.  A lot of
  51 others also reminded me of this, but Dan gets the point.  I didn't fix it
  52 there, since the real bug was that it should have been open in the parent.
  53
  54 Peter Kabal reminded me that I forgot to "#ifdef DEBUGGING" some code in
  55 misc.c.  Hans Trompert actually told me first, but Peter sent the patch so
  56 he gets the point.
  57
  58 Russell Nelson told me that I'd forgotten to "#include <syslog.h>" in misc.c,
  59 which explains why a lot of other people complained that it wasn't using
  60 syslog even when they configured it that way :-).  Steve Simmons told me
  61 first, though, so he gets the point.
  62
  63 An interim version of the daemon tried to "stat" every file before
  64 executing it; this turned out to be a horribly bad idea since finding the
  65 name of a file from a shell command is a hard job (that's why we have
  66 shells, right?)  I removed this bogus code.  Dave Burgess gets the point.
  67
  68 Dennis R. Conley sent a suggestion for MMDF systems, which I've added to the
  69 comments in cron.h.
  70
  71 Mike Heisler noted that I use comments in the CONVERSION file which are
  72 documented as illegal in the man pages.  Thanks, Mike.
  73
  74 Irving Wolfe sent me some very cheerful changes for a NeXT system, but I
  75 consider the system itself broken and I can't bring myself to #ifdef for
  76 something as screwed up as this system seems to be.  However, various others
  77 did send me smaller patches which appear to have cause cron to build and run
  78 correctly on (the latest) NeXT machines, with or without the "-posix" CFLAG.
  79 Irving also asked for a per-job MAILTO, and this was finally added later when
  80 I integrated the BSD/386 changes contributed by BSDi, and generalized some of
  81 the parsing.
  82
  83 Lots of folks complained that the autogenerated "Date:" header wasn't in
  84 ARPA format.  I didn't understand this -- either folks will use Sendmail and
  85 not generate a Date:  at all (since Sendmail will do it), or folks will use
  86 something other than Sendmail which won't care about Date: formats.  But
  87 I've "fixed" it anyway...
  88
  89 Several people suggested that "*" should be able to take a "/step".  One person
  90 suggested that "N/step" ought to mean "N-last/step", but that's stretching things
  91 a bit far.  "*/step" seems quite intuitive to me, so I've added it.  Colin Plumb
  92 sent in the first and most polite request for this feature.
  93
  94 As with every release of Cron, BIND, and seemingly everything else I do, one
  95 user stands out with the most critical but also the most useful analysis.
  96 Cron V3's high score belongs to Peter Holzer, who sent in the nicest looking
  97 patch for the "%" interpretation problem and also helped me understand a
  98 tricky bit of badness in the "log_fd" problem.
  99
 100 agulbra@flode.nvg.unit.no wins the honors for being the first to point out the
 101 nasty security hole in "crontab -r".  'Nuff said.
 102
 103 Several folks pointed out that log_it() needed to exist even if logging was
 104 disabled.  Some day I will create a tool that will compile a subsystem with
 105 every possible combination and permutation of #ifdef options, but meanwhile
 106 thanks to everybody.
 107
 108 job_runqueue() was using storage after freeing it, since Jordan told me back
 109 in 1983 that C let you do that, and I believed him in 1986 when I wrote all
 110 this junk.  Linux was the first to die from this error, and the Linux people
 111 sent me the most amazing, um, collection of patches for this problem.  Thanks
 112 for all the fish.
 113
 114 Jeremy Bettis reminded me that popen() isn't safe.  I grabbed Ken Arnold's
 115 version of popen/pclose from the ftpd and hacked it to taste.  We're safe now,
 116 from this at least.
 117
 118 Branko Lankester sent me a very timely and helpful fix for a looming security
 119 problem in my "crontab -e" implementation.
 120
 121 --------
 122
 123 Vixie Cron              Changes from V1 to V2
 124 Paul Vixie
 125 8-Feb-1988
 126
 127 Many changes were made in a rash of activity about six months ago, the exact
 128 list of which is no longer clear in my memory.  I know that V1 used a file
 129 called POKECRON in /usr/spool/cron to tell it that it was time to re-read
 130 all the crontab files; V2 uses the modtime the crontab directory as a flag to
 131 check out the crontab files; those whose modtime has changed will be re-read,
 132 and the others left alone.  Note that the crontab(1) command will do a utimes
 133 call to make sure the mtime of the dir changes, since the filename/inode will
 134 often remain the same after a replacement and the mtime wouldn't change in
 135 that case.
 136
 137 8-Feb-88: made it possible to use much larger environment variable strings.
 138         V1 allowed 100 characters; V2 allows 1000.  This was needed for PATH
 139         variables on some systems.  Thanks to Toerless Eckert for this idea.
 140         E-mail: UUCP: ...pyramid!fauern!faui10!eckert
 141
 142 16-Feb-88: added allow/deny, moved /usr/spool/cron/crontabs to
 143         /usr/lib/cron/tabs.  allow and deny are /usr/lib/cron/{allow,deny},
 144         since the sysv naming for this depends on 'at' using the same
 145         dir, which would be stupid (hint: use /usr/{lib,spool}/at).
 146
 147 22-Feb-88: made it read the spool directory for crontabs and look each one
 148         up using getpwnam() rather than reading all passwds with getpwent()
 149         and trying to open each crontab.
 150
 151 9-Dec-88: made it sync to :00 after the minute, makes cron predictable.
 152         added logging to /var/cron/log.
 153
 154 14-Apr-90: (actually, changes since December 1989)
 155         fixed a number of bugs reported from the net and from John Gilmore.
 156         added syslog per Keith Bostic.  security features including not
 157         being willing to run a command owned or writable by other than
 158         the owner of the crontab 9not working well yet)