From: Christian Kastner Date: Thu, 28 Jul 2011 11:07:40 +0200 Subject: Manpage and typo fixes Correct some errors or clarify sections in the manpages; fix some typos --- man/cron.8 | 43 ++++++++++++++++--------------------------- man/crontab.1 | 2 +- man/crontab.5 | 2 +- src/cron.c | 2 +- 4 files changed, 19 insertions(+), 30 deletions(-) diff --git a/man/cron.8 b/man/cron.8 index 184c0bf..48f3bdb 100644 --- a/man/cron.8 +++ b/man/cron.8 @@ -37,23 +37,15 @@ crond \- daemon to execute scheduled commands .B -V .SH DESCRIPTION .I Cron -is started from -.I /etc/rc.d/init.d -or -.I /etc/init.d -when classical sysvinit scripts are used. In case systemd is enabled, then unit file is installed into -.I /lib/systemd/system/crond.service -and daemon is started by -.I systemctl start crond.service -command. It returns immediately, thus, there is no need to need to start it with -the '&' parameter. +is automatically started at boot time. .PP .I Cron searches .I /var/spool/cron -for crontab files which are named after accounts in -.I /etc/passwd; -The found crontabs are loaded into the memory. +for crontab files which are named after user accounts; +together with the system crontab +.IR /etc/crontab , +the found crontabs are loaded into the memory. .I Cron also searches for any files in the @@ -71,12 +63,11 @@ also be sent to syslog by using the option. .PP There are two ways how changes in crontables are checked. The first -method is checking the modtime of a file. The second method is using the -inotify support. Using of inotify is logged in the -.I /var/log/cron -log after the daemon is started. The inotify support checks for changes -in all crontables and accesses the hard disk only when a change is -detected. +method is checking the modtime of a file. The second method +is using inotify support, which is only available on Linux. +When the daemon uses inotify, it logs this fact to syslog on startup. +The inotify support checks for changes in all crontables and accesses the +hard disk only when a change is detected. .PP When using the modtime option, .I Cron @@ -99,13 +90,8 @@ directory that contains system cronjobs stored for different users. .TP .IR /var/spool/cron directory that contains user crontables created by the -.IR crontab -command. -.PP -Note that the .BR crontab (1) -command updates the modtime of the spool directory whenever it changes a -crontab. +command. .PP .SS Daylight Saving Time and other time changes Local time changes of less than three hours, such as those caused by the @@ -153,7 +139,6 @@ This command must accept a fully formatted mail message (with headers) on standard input and send it as a mail message to the recipients specified in the mail headers. Specifying the string .I "off" -(i.e., crond -m off) will disable the sending of mail. .TP .B "\-n" @@ -164,10 +149,14 @@ must not enable .I pam_loginuid.so module. .TP +.B "\-i" +Disables inotify support (if present) +.TP .B "\-p" Allows .I Cron -to accept any user set crontables. +to accept any user set crontables (read: lift owner, type and mode +restrictions) .TP .B "\-P" Don't set PATH. PATH is instead inherited from the environment. diff --git a/man/crontab.1 b/man/crontab.1 index 47b0b8f..3c448f6 100644 --- a/man/crontab.1 +++ b/man/crontab.1 @@ -104,7 +104,7 @@ or modify system cron jobs in the .IR /etc/cron.d/ directory. .PP -The temporary directory can be set in an environment variable. If it is +The temporary directory can be set using the environment variable $TMPDIR. If it is not set by the user, the .I /tmp directory is used. diff --git a/man/crontab.5 b/man/crontab.5 index fe716fc..cb27d23 100644 --- a/man/crontab.5 +++ b/man/crontab.5 @@ -248,7 +248,7 @@ CRON_TZ=Japan # run at 2:15pm on the first of every month -- output mailed to paul 15 14 1 * * $HOME/bin/monthly # run at 10 pm on weekdays, annoy Joe -0 22 * * 1-5 mail -s "It's 10pm" joe%Joe,%%Where are your kids?% +0 22 * * 1-5 mail \-s "It's 10pm" joe%Joe,%%Where are your kids?% 23 0-23/2 * * * echo "run 23 minutes after midn, 2am, 4am ..., everyday" 5 4 * * sun echo "run at 5 after 4 every sunday" .fi diff --git a/src/cron.c b/src/cron.c index 7eabfe9..59fb840 100644 --- a/src/cron.c +++ b/src/cron.c @@ -182,7 +182,7 @@ static void usage(void) { fprintf(stderr, "\n"); fprintf(stderr, "Options:\n"); fprintf(stderr, " -h print this message \n"); - fprintf(stderr, " -i deamon runs without inotify support\n"); + fprintf(stderr, " -i daemon runs without inotify support\n"); fprintf(stderr, " -m off, or specify preferred client for sending mails\n"); fprintf(stderr, " -n run in foreground\n"); fprintf(stderr, " -p permit any crontab\n");