vixie-cron.txt

   1 AUTHOR:         Jim Gifford <lfs-hints at jg555.com>
   2
   3 DATE:           2003-10-22
   4
   5 LICENSE:        GNU Free Documentation License Version 1.2
   6
   7 SYNOPSIS:       Setup vixie-cron for LFS
   8
   9 DESCRIPTION:    This will describe on how to setup vixie-cron for LFS.
  10
  11 PREREQUISITES:  NONE
  12
  13 HINT:
  14
  15 Introduction to vixie-cron
  16
  17 Download location for vixie-cron
  18                         ftp://ftp.roedu.net/pub/mirrors/gentoo.org/distfiles
  19 vixie-cron Version used         3.0.1
  20
  21 cron is a standard UNIX program that runs user-specified programs at
  22 periodic scheduled times. vixie cron adds a number of features to the
  23 basic UNIX cron, including better security and more powerful configuration
  24 options.
  25
  26 ---
  27 Required Patches for vixie-cron
  28
  29 In order to build vixie-cron, you will need to patch it. I have made patches
  30 available and posted to patches.linuxfromscratch.org. The patch order listed
  31 is critical to follow. At this point I have assumed that you have downloaded
  32 the vixie-cron-3.0.1.tar.bz2 file and uncompressed it.
  33
  34 Patch Order
  35
  36 Patch 1 - vixie-cron-3.0.1-redhat-mdk-1.patch
  37 Patch 2 - vixie-cron-3.0.1-security-1.patch
  38 Patch 3 - vixie-cron-3.0.1-makefile-1.patch
  39 Patch 4 - vixie-cron-3.0.1-variables-1.patch
  40
  41 Optional - PAM
  42
  43 Patch 5 - vixie-cron-3.0.1-pam-1.patch
  44
  45 These patches can be retrieved from
  46 http://www.linuxfromscratch.org/patches/downloads/vixie-cron
  47 or
  48 ftp://ftp.jg555.com/pub/patches/vixie-cron
  49
  50 All patches can be installed using patch -Np1 -i NAME
  51
  52 ---
  53 Install vixie-cron by running the following commmands|
  54
  55 make CC="gcc $CFLAGS" &&
  56 make install
  57
  58 ----
  59 How-to use vixie-cron
  60
  61 The cron daemon consults so-called crontabs for jobs to execute. These
  62 crontabs are ordinary textfiles, however you should always use the crontab
  63 tool to manipulate them.
  64
  65 To have a look at your crontab execute crontab -l. If a crontab exists then
  66 it's contents is listed, otherwise "no crontab for <username>" will be
  67 displayed.
  68
  69 To add or delete an entry in your crontab, use crontab -e. Which editor is
  70 used can be customized, but usually it's vi or whatever is in EDITOR variable.
  71
  72 You add or delete entries by adding or deleting the appropriate line in the
  73 crontab (every entry takes exactly one line).
  74
  75 Each line consists of six columns which are seperated by blanks. The sixth
  76 (rightmost) column tells cron which command/file to execute (always use the full
  77 path here), while the other five columns tell cron when to execute it.
  78
  79 The columns (1 stands for the leftmost column, counting to the right) have the
  80 following meaning and take the values in brackets:
  81
  82 Minute (0 - 59)
  83 Hour (0 - 23)
  84 Day of month (1 - 31)
  85 Month (1 - 12)
  86 Day of the week (0 - 6, 0 representing sunday, 6 saturday)
  87
  88 In each of these five columns an asterisk ("*") stands for "every".
  89 Example: "41 5 * * * /home/jim/backupmeup.sh" would mean that everyday at 5:41
  90 in the morning the script backmeup.sh in jim's home directory would be executed
  91 (assuming, of course, that the script is executable).
  92
  93 If you want to specify a group of times, then concatenate the individual values,
  94 seperated by commas (Example: "00,15,30,45" - in the first column this would read
  95 as "every quarter of an hour on the quarter of the hour").
  96
  97 If you want to specify a range of times, you can use the minus (Example: "1-5"
  98 in the fifth column would read as "every workday").
  99
 100 ---
 101 /etc/cron.d
 102
 103 You can also create text files with the same information listed above in /etc/cron.d.
 104 When you add a file to this directory, crond will sense the addition and add it to the
 105 execution schedule.
 106
 107 ---
 108 /etc/crontab
 109
 110
 111 ---
 112 Make cron start on bootup
 113
 114 Create the /etc/rc.d/init.d/cron by running:
 115
 116 cat > /etc/rc.d/init.d/cron << "EOF"
 117 #!/bin/sh
 118 # Begin $rc_base/init.d/cron - cron loader
 119
 120 # Based on sysklogd script from LFS-3.1 and earlier.
 121 # Rewritten by Gerard Beekmans  - gerard@linuxfromscratch.org
 122
 123 source /etc/sysconfig/rc
 124 source $rc_functions
 125
 126 case "$1" in
 127         start)
 128                 echo "Starting Cron Scheduler..."
 129                 loadproc crond
 130                 ;;
 131         stop)
 132                 echo "Stopping Cron Schedular..."
 133                 killproc crond
 134                 rm -f /var/run/crond.pid
 135                 ;;
 136
 137         restart)
 138                 $0 stop
 139                 sleep 1
 140                 $0 start
 141                 ;;
 142
 143         status)
 144                 statusproc crond
 145                 ;;
 146
 147         *)
 148                 echo "Usage: $0 {start|stop|restart|status}"
 149                 exit 1
 150                 ;;
 151 esac
 152
 153 # End $rc_base/init.d/cron
 154 EOF
 155
 156 ---
 157 Make the script executable and create the appropriate symlinks by
 158 running:
 159
 160 chmod 755 /etc/rc.d/init.d/cron &&
 161 ln -s /etc/rc.d/init.d/cron /etc/rc.d/rc0.d/K08cron &&
 162 ln -s /etc/rc.d/init.d/cron /etc/rc.d/rc2.d/S40cron &&
 163 ln -s /etc/rc.d/init.d/cron /etc/rc.d/rc3.d/S40cron &&
 164 ln -s /etc/rc.d/init.d/cron /etc/rc.d/rc4.d/S40cron &&
 165 ln -s /etc/rc.d/init.d/cron /etc/rc.d/rc5.d/S40cron &&
 166 ln -s /etc/rc.d/init.d/cron /etc/rc.d/rc6.d/K08cron
 167
 168 VERSION:        1.1
 169
 170 CHANGELOG:      1.1 Fixed Typos (Thanx Thomas Trepl)
 171                 1.0 Initial Version
 172
 173  New Version of this document can be viewed from http://cvs.jg555.com/viewcvs.cgi/lfs-hints
 174
 175