usr.sbin/cron/doc/INSTALL

   1 /* Copyright 1993,1994 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
   9  * software; use at your own risk, responsibility for damages (if any) to
  10  * anyone resulting from the use of this software rests entirely with the
  11  * user.
  12  *
  13  * Send bug reports, bug fixes, enhancements, requests, flames, etc., and
  14  * I'll try to keep a version up to date.  I can be reached as follows:
  15  * Paul Vixie          <paul@vix.com>          uunet!decwrl!vixie!paul
  16  */
  17
  18 $FreeBSD$
  19
  20 Read the comments at the top of the Makefile, then edit the area marked
  21 'configurable stuff'.
  22
  23 Edit config.h.  The stuff I expect you to change is down a bit from the
  24 top of the file, but it's clearly marked.  Also look at pathnames.h.
  25
  26 You don't have to create the /var/cron or /var/cron/tabs directories, since
  27 both the daemon and the `crontab' program will do this the first time they
  28 run if they don't exist.  You do need to have a /var, though -- just "mkdir
  29 /var" if you don't have one, or you can "mkdir /usr/var; ln -s /usr/var /var"
  30 if you expect your /var to have a lot of stuff in it.
  31
  32 You will also need /usr/local/etc and /usr/local/bin directories unless you
  33 change the Makefile.  These will have to be created by hand, but if you are
  34 a long-time Usenet user you probably have them already.  /usr/local/man is
  35 where I keep my man pages, but I have the source for `man' and you probably
  36 do not.  Therefore you may have to put the man pages into /usr/man/manl,
  37 which will be hard since there will be name collisions.  (Note that the man
  38 command was originally written by Bill Joy before he left Berkeley, and it
  39 contains no AT&T code, so it is in UUNET's archive of freely-distributable
  40 BSD code.)
  41
  42 LINUX note: /usr/include/paths.h on some linux systems shows _PATH_SENDMAIL
  43         to be /usr/bin/sendmail even though sendmail is installed in /usr/lib.
  44         you should check this out.
  45
  46 say:
  47         make all
  48
  49 su and say:
  50         make install
  51
  52 Note that if I can get you to "su and say" something just by asking, you have
  53 a very serious security problem on your system and you should look into it.
  54
  55 Edit your /usr/lib/crontab file into little pieces -- see the CONVERSION file
  56 for help on this.
  57
  58 Use the `crontab' command to install all the little pieces you just created.
  59 Some examples (see below before trying any of these!)
  60
  61         crontab -u uucp -r /usr/lib/uucp/crontab.src
  62         crontab -u news -r /usr/lib/news/crontab.src
  63         crontab -u root -r /usr/adm/crontab.src
  64
  65 Notes on above examples: (1) the .src files are copied at the time the
  66 command is issued; changing the source files later will have no effect until
  67 they are reinstalled with another `crontab -r' command.  (2) The crontab
  68 command will affect the crontab of the person using the command unless `-u
  69 USER' is given; `-u' only works for root.  When using most `su' commands
  70 under most BSD's, `crontab' will still think of you as yourself even though
  71 you may think of yourself as root -- so use `-u' liberally.  (3) the `-r'
  72 option stands for `replace'; check the man page for crontab(1) for other
  73 possibilities.
  74
  75 Kill your existing cron daemon -- do `ps aux' and look for /etc/cron.
  76
  77 Edit your /etc/rc or /etc/rc.local, looking for the line that starts up
  78 /etc/cron.  Comment it out and add a line to start the new cron daemon
  79 -- usually /usr/local/etc/cron, unless you changed it in the Makefile.
  80
  81 Start up this cron daemon yourself as root.  Just type /usr/local/etc/cron
  82 (or whatever); no '&' is needed since the daemon forks itself and the
  83 process you executed returns immediately.
  84
  85 ATT notes: for those people unfortunate enough to be stuck on a AT&T UNIX,
  86 you will need the public-domain "libndir", found in the B News source and in
  87 any comp.sources.unix archive.  You will also need to hack the code some.