xref: /freebsd/usr.sbin/cron/doc/README (revision 84f33dea627930e57209583fc83ffb3202babc0a)
184f33deaSJordan K. Hubbard#/* Copyright 1988,1990,1993 by Paul Vixie
284f33deaSJordan K. Hubbard# * All rights reserved
384f33deaSJordan K. Hubbard# *
484f33deaSJordan K. Hubbard# * Distribute freely, except: don't remove my name from the source or
584f33deaSJordan K. Hubbard# * documentation (don't take credit for my work), mark your changes (don't
684f33deaSJordan K. Hubbard# * get me blamed for your possible bugs), don't alter or remove this
784f33deaSJordan K. Hubbard# * notice.  May be sold if buildable source is provided to buyer.  No
884f33deaSJordan K. Hubbard# * warrantee of any kind, express or implied, is included with this
984f33deaSJordan K. Hubbard# * software; use at your own risk, responsibility for damages (if any) to
1084f33deaSJordan K. Hubbard# * anyone resulting from the use of this software rests entirely with the
1184f33deaSJordan K. Hubbard# * user.
1284f33deaSJordan K. Hubbard# *
1384f33deaSJordan K. Hubbard# * Send bug reports, bug fixes, enhancements, requests, flames, etc., and
1484f33deaSJordan K. Hubbard# * I'll try to keep a version up to date.  I can be reached as follows:
1584f33deaSJordan K. Hubbard# * Paul Vixie          <paul@vix.com>          uunet!decwrl!vixie!paul
1684f33deaSJordan K. Hubbard# */
1784f33deaSJordan K. Hubbard
1884f33deaSJordan K. HubbardVixie Cron V3.0
1984f33deaSJordan K. HubbardDecember 27, 1993
2084f33deaSJordan K. Hubbard[V2.2 was some time in 1992]
2184f33deaSJordan K. Hubbard[V2.1 was May 29, 1991]
2284f33deaSJordan K. Hubbard[V2.0 was July 5, 1990]
2384f33deaSJordan K. Hubbard[V2.0-beta was December 9, 1988]
2484f33deaSJordan K. Hubbard[V1.0 was May 6, 1987]
2584f33deaSJordan K. HubbardPaul Vixie
2684f33deaSJordan K. Hubbard
2784f33deaSJordan K. HubbardThis is a version of 'cron' that is known to run on BSD 4.[23] systems.  It
2884f33deaSJordan K. Hubbardis functionally based on the SysV cron, which means that each user can have
2984f33deaSJordan K. Hubbardtheir own crontab file (all crontab files are stored in a read-protected
3084f33deaSJordan K. Hubbarddirectory, usually /var/cron/tabs).  No direct support is provided for
3184f33deaSJordan K. Hubbard'at'; you can continue to run 'atrun' from the crontab as you have been
3284f33deaSJordan K. Hubbarddoing.  If you don't have atrun (i.e., System V) you are in trouble.
3384f33deaSJordan K. Hubbard
3484f33deaSJordan K. HubbardA messages is logged each time a command is executed; also, the files
3584f33deaSJordan K. Hubbard"allow" and "deny" in /var/cron can be used to control access to the
3684f33deaSJordan K. Hubbard"crontab" command (which installs crontabs).  It hasn't been tested on
3784f33deaSJordan K. HubbardSysV, although some effort has gone into making the port an easy one.
3884f33deaSJordan K. Hubbard
3984f33deaSJordan K. HubbardThis is more or less the copyright that USENET contributed software usually
4084f33deaSJordan K. Hubbardhas.  Since ATT couldn't use this version if they had to freely distribute
4184f33deaSJordan K. Hubbardsource, and since I'd love to see them use it, I'll offer some rediculously
4284f33deaSJordan K. Hubbardlow license fee just to have them take it.  In the unlikely event that they
4384f33deaSJordan K. Hubbarddo this, I will continue to support and distribute the pseudo-PD version, so
4484f33deaSJordan K. Hubbardplease, don't flame me for wanting my work to see a wider distribution.
4584f33deaSJordan K. Hubbard
4684f33deaSJordan K. HubbardTo use this: Sorry, folks, there is no cutesy 'Configure' script.  You'll
4784f33deaSJordan K. Hubbardhave to go edit a couple of files... So, here's the checklist:
4884f33deaSJordan K. Hubbard
4984f33deaSJordan K. Hubbard	Read all the FEATURES, INSTALL, and CONVERSION files
5084f33deaSJordan K. Hubbard	Edit config.h
5184f33deaSJordan K. Hubbard	Edit Makefile
5284f33deaSJordan K. Hubbard		(both of these files have instructions inside; note that
5384f33deaSJordan K. Hubbard		 some things in config.h are definable in Makefile and are
5484f33deaSJordan K. Hubbard		 therefore surrounded by #ifndef...#endif)
5584f33deaSJordan K. Hubbard	'make'
5684f33deaSJordan K. Hubbard	'su' and 'make install'
5784f33deaSJordan K. Hubbard		(you may have to install the man pages by hand)
5884f33deaSJordan K. Hubbard	kill your existing cron process
5984f33deaSJordan K. Hubbard		(actually you can run your existing cron if you want, but why?)
6084f33deaSJordan K. Hubbard	build new crontabs using /usr/lib/{crontab,crontab.local}
6184f33deaSJordan K. Hubbard		(either put them all in "root"'s crontab, or divide it up
6284f33deaSJordan K. Hubbard		 and rip out all the 'su' commands, collapse the lengthy
6384f33deaSJordan K. Hubbard		 lists into ranges with steps -- basically, this step is
6484f33deaSJordan K. Hubbard		 as much work as you want to make it)
6584f33deaSJordan K. Hubbard	start up the new cron
6684f33deaSJordan K. Hubbard		(must be done as root)
6784f33deaSJordan K. Hubbard	watch it. test it with 'crontab -r' and watch the daemon track your
6884f33deaSJordan K. Hubbard		changes.
6984f33deaSJordan K. Hubbard	if you like it, change your /etc/{rc,rc.local} to use it instead of
7084f33deaSJordan K. Hubbard		the old one.
7184f33deaSJordan K. Hubbard
7284f33deaSJordan K. Hubbard$Id: README,v 2.3 1993/12/28 08:34:43 vixie Exp $
73