3 Copyright 2000-2013 Thibault Godouet <fcron@free.fr>
4 Permission is granted to copy, distribute and/or modify this
5 document under the terms of the GNU Free Documentation License,
6 Version 1.1 or any later version published by the Free Software
8 A copy of the license is included in gfdl.sgml.
13 <title>Changes</title>
16 <title>From version 3.1.2 to 3.1.3</title>
18 <para>Fixed compilation on Solaris 10, and fixed fcrondyn authentication without a password on that platform.</para>
21 <para>Fixed bug where LONG_MAX could potentially be used in functions like localtime(), which is too big for localtime(). This was unlikely to happen unless there was another problem in the first place.</para>
24 <para>fcrondyn -x no longer adds null characters at the end of the output. This would cause problems if the output was piped to something as grep. Thanks Dimitri Semitsoglou-Tsiapos for pointing this out.</para>
27 <para>Fixed minor bug in fcronsighup resulting in log errors about closing the signal file</para>
30 <para>fcrondyn no longer crashes when receiving an EOF when using readline (thanks Wade Carpenter for the patch)</para>
35 <title>From version 3.1.1 to 3.1.2</title>
37 <para>bug fix: fixed fcron crash bug when using fcrondyn</para>
40 <para>bug fix: the configure option --without-sendmail was not working correctly.</para>
43 <para>bug fix: inline runas wouldn't work with Vixie-cron style shortcut lines.</para>
46 <para>bug fix: fixed bug in the code to log to a file.</para>
49 <para>systemd: fixed the installation on systems using systemd, and also don't kill jobs when killing fcron.</para>
52 <para>Made file closures more robust to prevent bugs difficult to troubleshoot to creep in.</para>
57 <title>From version 3.1.0 to 3.1.1</title>
59 <para>Added readline support for fcrondyn</para>
62 <para>tweaked 'make indent' options and applied</para>
65 <para>Fcron can now log to a file (without syslog) - thanks Matthew Signorini.</para>
68 <para>fixed fcrontab edition of *ly lines (hourly, daily, etc)</para>
71 <para>fixed fcron crashes when noticenotrun was triggered</para>
75 <title>From version 3.0.6 to 3.1.0</title>
77 <para>Vixie cron compatibility: added options @reboot, @daily, @hourly, etc. Also added more generic options runatreboot, rebootreset and runonce.</para>
80 <para>Pass fcrondyn client credentials through the socket when possible so as the user doesn't need to type his password when using fcrondyn.</para>
83 <para>added audit (libaudit) support</para>
86 <para>Better validation of string arguments of fcrontab options. In particular for timezones, previously a space could be added at the beginning or the end of the timezone with no warning, and this led fcron to use an unexpected timezone, which could cause confusion.</para>
89 <para>Allow tasks to run every seconds</para>
92 <para>don't inherit fcron's environment when running a job but build the environment from scratch (cleaner, and this is what Vixie cron does)</para>
95 <para>fcron now sets the email headers X-Cron-Env and Auto-Submitted (as described in RFC 3834).</para>
98 <para>email encoding: fcron now sets the email headers Content-Type and Content-Transfer-Encoding. They can be controlled by setting the CONTENT_TYPE and CONTENT_TRANSFER_ENCODING variables in fcrontabs.</para>
101 <para>Added systemd service definition (thank you Reiner)</para>
104 <para>Allow Makefile parallelism (e.g. make -j 4)</para>
107 <para>bug fix: fcrontab: don't alert about invalid character when correcting fcrontab twice</para>
110 <para>bug fix: fixed free_safe() function (replaced by macro).</para>
113 <para>bug fix: configure script: usage of sendmail couldn't be disabled</para>
116 <para>bug fix: fixed a potential (unlikely) 1 byte overflow in strncat() in socket.c</para>
119 <para>Quite a lot of code clean-up and refactoring -- e.g. implemented generic unordred list for lavgq / exeq.</para>
123 <title>From version 3.0.5 to 3.0.6</title>
125 <para>Fixed bug preventing normal user from running fcrontab -l if fcron's uid!=gid</para>
128 <para>Fixed fcrontab's PAM initialization when working on the systab user.</para>
131 <para>Added check_system_crontabs.sh which is to replace the less portable check_system_crontabs.bash.</para>
134 <para>Added option -c to check_system_crontabs.sh to specify a fcron.conf file to use</para>
137 <para>Fixed Makefile bug preventing installation when building from a different folder than the sources (wrong fcron.conf path)</para>
142 <title>From version 3.0.4 to 3.0.5</title>
144 <para>Security issue: fixed security issue that allowed malicious user to read any file readable by group 'fcron' (in particular fcron's config files and the fcrontabs of non-root users). On systems without seteuid() (i.e. quite exotic systems) then the bug is harder to exploit but any file could be read.</para>
147 <para>Improved general security of fcrontab and fcrondyn by dropping more privileges.</para>
150 <para>Work on portability (aix, hpux, irix, tru64 unix, solaris). Thanks Peter O'Gorman for his patch!</para>
153 <para>Patched startup script to make it more compliant to the LSB.</para>
156 <para>Increased maximum number of fcrontab entries from 256 to 1024.</para>
159 <para>bug fix: if fcron could not fork() to run a job, then the job would still appear to be running until fcron is restarted (thanks Alexander Y. Fomichev for noticing this bug).</para>
162 <para>bug fix: fcrontab used to accept MAXENTRIES+1 fcrontab entries</para>
165 <para>chdir to /tmp before executing the editor (as some editor needs to be able to read information on the current folder).</para>
170 <title>From version 3.0.3 to 3.0.4</title>
172 <para>Initialize the random number generator with some values specific to the machine so as two fcron started exactly at the same time on two different machines run their random jobs at different time. This is useful for clusters for instance.</para>
175 <para>Added option erroronlymail so as the output of a job is emailed only when the job exited with a non-zero status.</para>
178 <para>Bug fix: in certain conditions, jobs could be executed outside their interval of execution when using option random on %-lines.</para>
181 <para>Fixed bug which prevented the pid of the job to be written to the (grand-)parent process. This was not a major issue but would prevent fcrondyn from working well with the concerned jobs. This bug was caused by a close() function applied twice on a file descriptor, which would trigger the bug in some rare occasions (only one affected linux system reported).</para>
184 <para>Fixed bug which would stop fcron from running any job any more on the affected system and until fcron was restarted if the bug above occured.</para>
187 <para>Cleaned-up the closures of file descriptors (check for errors, etc).</para>
192 <title>From version 3.0.3-rc1 to 3.0.3</title>
194 <para>The configure script now check that the make command is GNU make (which is required to build fcron).</para>
195 <para>Bug fix: better handling of getpwnam() errors (we cannot rely on errno to spot an error). This was causing problems for AIX for instance.</para>
200 <title>From version 3.0.2 to 3.0.3-rc1</title>
202 <para>New configure scripts, with more standard default values for paths, etc. This aims at simplifying the packaging of fcron. Thanks go to Patrice Dumas for his patch!</para>
205 <para>New make targets: perms and strip. This aims at simplifying the packaging of fcron. Thanks go to Patrice Dumas for his patch!</para>
208 <para>Set environment variable LOGNAME when running a job (as Vixie Cron does: thanks Martin McGreal for pointing that out).</para>
211 <para>Portability work for AIX 5.2 and Solaris 8 and 10 (thanks Martin McGreal).</para>
214 <para>Chmod()ed fcron's fifo file to 777. It was 666 previously, but the exec bit is needed for AIX and apparently ignored on other platforms, so we now set it to.</para>
217 <para>Set TZ environment variable for lines which uses fcron option timezone.</para>
220 <para>A file was closed twice by fcrontab: removed the duplicate close().</para>
223 <para>Replaced include sys/termios.h by termios.h.</para>
226 <para>Fixed a fcrontab bug cause by an return value not handled and resulting in many useless (but pretty much harmless) iteration in a loop.</para>
231 <title>From version 3.0.1 to 3.0.2</title>
233 <para>Use sockaddr's field sa_len/sun_len on system defining it (BSD, ...). It should allow fcrondyn to connect to fcron on these systems.</para>
236 <para>Non-SELinux systems: run each job in a different session by calling setuid() for each one of them. This is to improve compatibility with Vixie cron.</para>
239 <para>Don't use the shell defined in /etc/passwd by default, but use the default value from fcron.conf instead. This is for compatibility with Vixie cron.</para>
242 <para>Use root name and group instead of root uid and gid. This seems more logical since the configure scripts asks for the name and group and not the uid and gid.</para>
245 <para>Added an init file for Suse in script/ (contribution from Alex: thanks!).</para>
248 <para>Minor spelling fixes in the French documentation.</para>
253 <title>From version 3.0.0 to 3.0.1</title>
255 <para>fcrontab: access user's directory with user's rights (necessary if user/group fcron has not the right to read the directory).</para>
258 <para>improvement in check_system_crontabs: more comments, added some help messages, added command line options, cleaner, safer code.</para>
261 <para>Improved English documentation: clarified some previously-unclear points.</para>
264 <para>Added French translation of the manual pages (thanks go to Alain Portal)</para>
267 <para>Removed old documentation from the package.</para>
270 <para>Better handling of the pipes in job.c: this should remove some problems encountered on BSD systems.</para>
273 <para>bug fix: do not use a tv_usec > 999999: should fix the problem encountered on BSD systems with select().</para>
276 <para>bug fix: fixed a bug in make_msg(): the size of a string written to a buffer was not controlled correctly in some cases. This could result in buffer overflow and thus this was security problem. However the bug seems not exploitable as the part of the string which could overflow the buffer could not be freely defined by an attacker (it was either ": " or one of the strings returned by strerror()).</para>
279 <para>Bug fix: set the FDs correctly for select().</para>
284 <title>From version 2.9.7 to 3.0.0</title>
286 <para>Added a missing entry in changelog (changes from 2.9.6 to 2.9.7, bug fix for NetBSD).</para>
289 <para>Merged a patch for the check_system_crontabs script (Security enhancements and cleanups).</para>
294 <title>From version 2.9.6 to 2.9.7</title>
296 <para>Added time zone support (option timezone).</para>
299 <para>Better support FreeBSD's users and groups modifications in
300 fcron's install scripts.</para>
303 <para>Fixed a bug which used to make fcron send empty mails on very
304 recent systems.</para>
307 <para>Fixed a bug which prevented fcrondyn to being used on NetBSD (thanks go to Gabor Z. Papp).</para>
310 <para>Added some casts in fileconf.c and save.c (to avoid some
311 warnings when compiling on HP-UX).</para>
314 <para>Added a FAQ entry on how to emulate an anacron entry.</para>
319 <title>From version 2.9.5.1 to 2.9.6</title>
321 <para>fixed the bug which made jobs run an hour too early after a
322 daylight saving time change.</para>
323 <para>Added detailed explanations about when a job will run when
324 there is a DST change in the FAQ.</para>
327 <para>fixed fcrondyn's "Unknown command" bug on x86_64 (thanks go to
328 Georgi Georgiev).</para>
331 <para>made fcrontab behave better when there is no space left in the
332 spool directory (used to truncate the fcrontab source file).
335 <para>Added a script, check_system_crontabs, to emulate Vixie cron's
336 behavior about /etc/crontab and /etc/cron.d. Please have a look
337 at the top of script/check_system_crontabs for more information.
341 <para>HP-UX support (needs more tests).</para>
344 <para>bug fix: restore umask even if fcron runs
350 <title>From version 2.9.5 to 2.9.5.1</title>
352 <para>Fixed serious security vulnerabilities in fcronsighup, and
353 improved fcronsighup's overall security (drop privileges, better
354 check user inputs, etc).</para>
357 <para>Fixed several typos in the doc.</para>
360 <para>Updated debian package scripts (patch from debian
366 <title>From version 2.9.4 to 2.9.5</title>
368 <para>Ported to HP-UX (thanks go to Scott Tinsley)</para>
371 <para>Implemented fcrondyn commands run and runnow.</para>
374 <para>Merged patch from Russell Coker for new SE Linux.</para>
377 <para>Merged debian/ dir for debian package.</para>
380 <para>Mail reports: put the same username in the To: field than the
381 one we give as recipient to the MTA. mailto can now also be a
382 fully qualified email address.</para>
385 <para>changed a log message: a job which has ended without error is
386 reported has "completed" (which is more appropriated than
391 <para>Internal changes in log.c: code is more segmented, and code
392 has been added to be able to send log message to fcrondyn. Syslog
393 messages are now never longer than MAX_MSG (even with string from
397 <para>Fixed a bug which happened on Daylight Saving Time change on
398 some systems. It would make fcron run into a nasty infinite loop.
399 Added a sanity check in set_nextexe() to avoid such
403 <para>Fixed a crash bug: in 2.9.4, if a user run ls_exeq when a job
404 is running and has been removed from its fcrontab, it makes fcron
408 <para>Fixed a small bug: scripts were supposing perl was in
412 <para>Fixed a bug which caused the pid of a child process to be
413 incorrectly read</para>
416 <para>fixed memory leak: some strings returned by log.c:make_msg()
417 weren't always free()d.</para>
420 <para>bug fix: fcrondyn commands renice and kill used not to handle
421 correctly the case where a job has several entries in exeq
422 (exesev jobs).</para>
427 <title>From version 2.9.3 to 2.9.4</title>
429 <para>Merged support for SE Linux (patch from Russell Coker: thanks!)
433 <para>Work on the documentation (fixed spelling mistakes, tried to
434 make things clearer in fcrontab.5) (thanks Bill Wohler for your
438 <para>Changed the subject line of mail reports: it now contains the
439 subject line, and is very similar to vixie cron's one.</para>
442 <para>Added a sum-up at the end of ./configure.</para>
445 <para>bug fix: "makewhatis" bug is fixed -- at last!</para>
446 <para>In fact, the problems encountered were due to an abusively
447 ignored signal SIGPIPE.</para>
450 <para>bug fix: possible crash of fcron when trying to save a file
451 if there was no space left on device.</para>
454 <para>bug fix: we don't consider '-' and '_' as word delimiters for
455 a username before the command anymore, since many programs have
456 one of these characters in their name.</para>
459 <para>bug fix: option first was broken in fcron 2.9.3.</para>
462 <para>fixed a little typo in an error message
463 (could->couldn't)</para>
466 <para>bug fix: do not ignore the last line of a fcrontab if there
467 is no \n before the end of file.</para>
470 <para>fixed compile on SunOS 5.9 .</para>
473 <para>Fcron now compiles on MacOS X.</para>
476 <para>added some $srcdir to be able (again ;) ) to run configure
477 from another directory.</para>
480 <para>Perf improvement: use buffer for i/o in run_job().</para>
485 <title>From version 2.9.2 to 2.9.3</title>
487 <para>security issue: fcron used not to check the fcrontabs
488 installed by root for a standard user. This could make an
489 inattentive superuser install a user job runas(root)
493 <para>Perf improvement: we now use buffers to write something to
494 disk (became necessary due to the use of O_SYNC).</para>
497 <para>To avoid loss of data in case of an hardware failure or a
498 system crash, fcron now saves files to a temporary name, and then
499 renames them to their definitive filename if everything's
503 <para>The PID indicated by fcrondyn is now the pid of the job itself
504 (up to now, it was the one of the fcron process controlling the
508 <para>Implemented functions kill (send a signal to a running job)
509 and renice (change the priority of a running job) in
513 <para>Added fcron's option -q to control the lavg and serial queue
518 <para>Added some timeouts in fcron for fcrondyn clients.</para>
521 <para>Fcron is less restrictive concerning mailto addresses. In
522 particular, you can now use address like user@host.</para>
525 <para>bug fix: in 2.9.2, fcrontab and fcron did not set correctly
526 some file modes.</para>
529 <para>bug (introduced in 2.9.1): when a job stops with an non-zero
530 exit status or because it has been signaled, send a mail to its
531 owner to inform him (in 2.9.1 and 2.9.2, the mail was sent, but
532 contained nothing).</para>
535 <para>code clean: use the same scheme for all struct types, removed
536 some code redundancy (save to disk management).</para>
541 <title>From version 2.9.1 to 2.9.2</title>
543 <para>Added a system fcrontab. Root can access it with fcrontab by
544 using "-u systab".</para>
547 <para>fcrondyn's ls_lavgq, ls_serialq and ls_exeq are now
551 <para>mailto can now be set to a non-real user (for ex., an
555 <para>fcron now calls shutdown() when a connection from fcrondyn is
556 closed. Another change in the code should prevent fcrondyn from
557 not returning to the prompt after a command has been run.</para>
560 <para>use open() instead of fopen() to write files, for more
564 <para>fcrontab sets euid=uid before running the editor. This is
565 required by some programs (for instance, perl).</para>
568 <para>bug fix: using DESTDIR with make did not work with the
572 <para>Code clean: changed macros to make parameters clearly
573 different from vars.</para>
578 <title>From version 2.9.0 to 2.9.1</title>
580 <para>fcron can now be run without root's privileges (<link
581 linkend="faq">see FAQ</link>)</para>
584 <para>added configure's option --with-boot-install .</para>
587 <para>Minor change in the PAM code of fcron: may work better on
591 <para>configure script now uses getpwnam() and getgrnam() instead of
592 reading directly /etc/passwd and /etc/group: this makes easier
593 the use of NIS, LDAP, etc.</para>
596 <para>Bug fix: using some "cmd > /dev/stderr" (or stdout) in a
597 script used to make fcron send a bogus output mail. (rewrite of
598 the code managing the output of jobs)</para>
601 <para>Bug fix: typo error prevented fcrontab to be compiled on some
605 <para>Minor bug fix about stdout option.</para>
608 <para>Minor bug fix: giving fcrontab's option -c a relative path
609 now works correctly.</para>
614 <title>From version 2.1.0 to 2.9.0</title>
616 <para>Added some new options to fcron: -y, -o, -l; and some
617 fcrontab options: stdout and volatile. All these permit to make
618 fcron run in foreground, execute all the pending jobs (mainly
619 %-jobs), and return. May be used, for instance, in a ppp-up
620 script with a dialup connection to update a software
624 <para>Added fcrondyn: this software allows users to dialog
625 dyn-amically with a running fcron daemon. Currently, it can list
626 jobs of the user running it (or all jobs for root). In the near
627 future, it should be able to run a job, change its next time and
628 date of execution, renice a running job, send a signal to a
629 running job, etc.</para>
632 <para>All the documentation has been ported to SGML DocBook.</para>
633 <para>It results on a much better HTML version, which I recommand
634 you use. It is installed by default in fcron documentation
635 directory (for instance, on my system:
636 <filename>/usr/share/doc/fcron-X.X.X/</filename>).</para>
639 <para>Fcrontab.5 has been updated and improved. Some examples have
640 been added and some possible use of the different lines and
641 options are mentioned.</para>
644 <para>Added option random, which allows an entry run periodically to
645 be run at a random time in its intervals of execution, instead of
646 being run as soon as possible.</para>
649 <para>added some more checks in fileconf.c: allow user to use
650 hours, days, hourly, daily, etc options only with %-lines: it is
651 ignored if set for a &-line, which is quite confusing for users
652 who may type, for instance "&hourly" instead of
656 <para>bug fixed: you can now use arguments in the var EDITOR and
660 <para>bug fixed: fcron used to call sometimes a sleep(-1), which
661 causes a freeze (no crash, but a very very long sleep :) ) under
662 system using LIBC5, and maybe on some non-linux systems. It was
663 not causing any problem under GLIBC2. Thanks go to Nick
669 <title>From version 2.0.0 to 2.1.0</title>
671 <para>PAM support for fcron and fcrontab (need testing! - help
672 would be appreciated).</para>
675 <para>Fcron now send a mail if a job has noticenotrun set and could
676 not be run because of a queue full.</para>
679 <para>Fcron now compiles on AIX (thank you, John A. Parker!), and a
680 few AIX-only bugs have been fixed, but it may remain some
681 problems to correct. Please try, and tell me!</para>
684 <para>We now use constants ROOTUID and ROOTGID instead of some
685 hard-coded "0", and those constants are defined by the configure
686 script (we use the uid/gid of the name given with the option
687 "--with-root{name|group}"). It allows fcron to be run on system
688 on which root is not uid/gid 0/0.</para>
691 <para>code cleaning.</para>
694 <para>bug fixed: setting lavg to (0,0,0) used to make the line be
695 added in the lavg queue instead of the serial queue (but the
696 lavgs were ignored anyway).</para>
699 <para>bug fixed: fcrontab's "-z" option was not ignoring previous
700 user's fcrontab version.</para> </listitem>
702 <para>bug fixed: on systems using putenv(), the var HOME, USER and
703 SHELL wasn't correctly assigned. On system supporting setenv()
704 (which is the default), the problem did not occur. (thanks go to
705 Evan A. Zacks).</para>
711 <title>From version 1.1.1 to 2.0.0</title>
713 <para>using SIGUSR2 on fcron makes it print its current schedule on
714 syslog and toggles on/off the printing of debug info on
718 <para>fcron behavior on serial and lavg queues overflow has changed:
719 in previous versions, it used to run a job to make room to put
720 a new one. As it may conduct to a overwhelming of system
721 resources, the new job is now refused (and not run). An error
722 message is also logged through syslog.</para>
725 <para>a mail is now sent if the job exited due to a signal, or if
726 exit status is non-zero. Read FAQ if you experience problems
730 <para>added a FAQ.</para>
733 <para>bug fixed: a midmonthly job executed after the 15th of the
734 month used to cause an endless loop. Thanks go to Guy Geens
735 (thanks a lot!).</para>
738 <para>bug fixed: inserting a job in serial queue or running a job
739 not finished at startup was broken, unless the job was
743 <para>bug fixed: some 1.1.1 changes used to make fcron impossible
744 to compile without sendmail (./configure's option
745 "--with-sendmail=no").</para>
748 <para>bug fixed in sysV boot script: we know specify explicitly the
749 path to fcron.</para>
752 <para>bug fixed: unresolved error used to occur on some system not
753 defining getopt_long().</para>
758 <title>From version 1.1.0 to 1.1.1</title>
760 <para>security fix: sym link attack against fcrontab. Any user
761 allowed to use fcrontab used to be able to remove any fcrontab,
762 and potentially to truncate any file to zero-length (under
763 certain conditions, anyway).</para>
766 <para>fcron and fcrontab now have a configuration file: fcron.conf.
767 It contains the default paths (spool dir, etc) and programs to
768 use (editor, shell, etc). Thanks to that file, several fcron
769 processes can run simultaneously if they have a different config
770 (different spool dir and pid file).</para>
773 <para>added fcron's option "-m" to control the number of serial jobs
774 which can be executed simultaneously.</para>
777 <para>added fcron's option "-n" to create a new spool dir.</para>
780 <para>command line syntax of fcrontab has changed: you can know use
781 "user" (after the file name if any) instead of "-u user". It
782 should make fcrontab a little more intuitive.</para>
785 <para>It is now possible to put a user name between the time/date
786 fields and the shell command of a fcrontab line (for Vixie cron
787 format compatibility): it is equivalent to runas(user).</para>
790 <para>support of Solaris (and SysV).</para>
793 <para>early support of OpenBSD.</para>
796 <para>the installation scripts now use nsswitch.conf to detect if a
797 user or a group exists on the system. That way, naming services
798 (NYS, ldap, etc) are supported.</para>
801 <para>the man page and doc is now installed by default in
802 $prefix/share/{man|doc} (instead of the previous
803 $prefix/{man|doc}) ($prefix is generally "/usr").</para>
806 <para>bug corrected: fcron used not to add a serial_sev line to
807 serial/lavg queue if this line was running, saying "already in
808 serial queue".</para>
812 <para>bug corrected: a "all" in fcron.allow with no fcron.deny file
813 was not considered as an allow rule.</para>
818 <title>From version 1.0.3 to 1.1.0</title>
820 <para>The binary format of the binary fcrontabs has changed: there
821 is now no more need to reinstall the fcrontabs when upgrading
822 fcron (but you need to convert your fcrontabs to the new format
823 once), and this format should allow extensions without losing any
827 <para>better management of the errors in load/save fcrontabs
831 <para>the doc is a clearer about @-lines.</para>
834 <para>more security tests by fcrontab in the case it is suid root
835 (but, if possible, it should be suid fcron as it is far more
839 <para>we now remove unwanted fcrontabs before loading them in memory:
840 well, it seems to be more logical like that :)) .</para>
843 <para>bug fix: using options first with a &-line may have led to
844 some problems during the first read by fcron (mail send
845 erroneously if noticenotrun was used, bad set of the first
846 execution's time and date or immediate execution if bootrun was
847 set: in fact, the line was not recognized as a new line).</para>
850 <para>bug fix: fcron used not to be able to be compiled from any
851 directory because of an absent -I. line option for the compiler
852 (the config.h file was not found).</para>
857 <title>From version 1.0.2 to 1.0.3</title>
859 <para>fcron can now be configured and compiled from any directory
860 (not only from the source dir).</para>
863 <para>bug fix: fcron now sets umask to the value it got at start
864 before running a job.</para>
867 <para>bug corrected: a bug used to make the "truncated" system not
868 to work correctly, so a too long log message used to make fcron
874 <title>From version 1.0.1 to 1.0.2</title>
876 <para>the user for whom a job is run is now logged.</para>
879 <para>installation script is now more explicit about what it is
883 <para>a boolean value can now also be set by "yes" and "no".</para>
886 <para>bug corrected: bootrun option works again.</para>
889 <para>bug corrected: shell variable containing underscore (_) used
890 to be rejected.</para>
893 <para>bug corrected: installation script used not to check if user
894 fcron was in group fcron, in which case fcrontab doesn't work
895 correctly (it cannot, in that case, read the fcrontabs for
896 non-privileged users).</para>
901 <title>From version 1.0.0 to 1.0.1</title>
903 <para>security fix: a user used to be able to read a file owned by
904 root if root runs a "fcrontab -u user -e".</para>
909 <title>From version 0.9.5 to 1.0.0</title>
911 <para>added fcron's option "-s" to control the time between two
912 saves of the fcrontabs on disk.</para>
915 <para>installation scripts now support better FreeBSD and sh.</para>
918 <para>bug corrected: configure's options prefix and
919 without-sendmail used not to work.</para>
922 <para>bug corrected: installing an fcrontab by "fcrontab file"
923 wasn't working correctly with a relative path (a path not
924 beginning by a "/").</para>
929 <title>From version 0.9.4 to 0.9.5</title>
931 <para>security fix: the jobs of a fcrontab reinstalled by root used
932 to be run as root (until the next action of the owner on the
936 <para>added options strict and noticenotrun to tell fcron
937 respectively if a job should be removed from lavg queue if its
938 execution interval is exceeded, and if fcron should mail user to
939 report the non-execution of a job.</para>
942 <para>added option nolog in order to log only errors (i.e. no
943 message like "job x started"). This can help to reduce the disk
944 access and save energy on a laptop, and make the log more
945 readable if some jobs are run very often.</para>
948 <para>better handle of changes of the uids of users in /etc/passwd
949 (no more need to reinstall the fcrontabs).</para>
952 <para>fcron.deny and fcron.allow files are now owned by root (they
953 used to be owned by user fcron).</para>
956 <para>added ./configure's option --with-answer-all to be able to use
957 "make install" in a non-interactive way (can be useful for
958 automatic installers).</para>
961 <para>added option --with-rootname and --with-rootgroup to
962 ./configure script for a better support of exotic systems.</para>
965 <para>bug corrected in make install (script user-group): the script
966 used not to handle correctly the absence of both useradd and
967 adduser commands. This script now checks and tries to add a
968 group fcron if necessary.</para>
973 <title>From version 0.9.3 to 0.9.4</title>
975 <para>security improvement: after the (horrible) root exploit found
976 in version 0.9.3, I decided to improve fcron/fcrontab's security.
977 I've included some strong (I hope :)) ) tests in fcron to ensure
978 that only root can run commands as superuser and use option
979 runas. Even an corrupted fcrontab should not be able to get
980 root's privileges. Pretty reassuring, isn't it?</para>
983 <para>runfreq(1) lines have been replaced and extended by a new kind
984 of line: the lines beginning by a "%". It's now possible to tell
985 fcron to run a command once an hour, a week, etc, but only at
986 some specified moments. For instance: '%weekly * 4-7 echo "foo"'
987 will run the command 'echo "foo"' once a week between 4 and 7 in
988 the morning. (see "man 5 fcrontab" for more details).</para>
991 <para>installation process improved: user is now consulted before
992 anything is done about installation in boot scripts, etc. The
993 default username of fcron is now ... fcron! (this is more secure
994 than daemon, which can be used by other programs). </para>
997 <para>fcron now adds the host name to the addresses of the mails it
1001 <para>fcrontab determines the identity of the running user by his
1002 uid (it used to use the var USER). That way, fcrontab should act
1003 as crontab under a "su".</para>
1006 <para>bug fixed: a tmp file was not removed after a "fcron
1010 <para>bug fixed in fcrontab: an expression of the form "start-stop"
1011 with start > stop used to be incorrectly managed by fcron.</para>
1014 <para>bug fixed: when fcron and fcrontab were installed under a
1015 non-privileged user rights, a normal user used to be not able to
1016 use fcrontab.</para>
1019 <para>bug fixed: while fcrontab was asking user if he would like to
1020 correct an erroneous line, the answer was not correctly
1026 <title>From version 0.9.2.1 to 0.9.3</title>
1028 <para>installation scripts improved.</para>
1031 <para>added code to avoid infinite loops.</para>
1034 <para>bugs corrected in the functions to set the time and date of
1035 next execution.</para>
1038 <para>bug corrected in the check for invalid lines.</para>
1043 <title>From version 0.9.2 to 0.9.2.1</title>
1045 <para>minor bug corrected in Makefile</para>
1050 <title>From version 0.9.1 to 0.9.2</title>
1052 <para>fcron now uses autoconf (the configure script), so it should
1053 be easier to compile and install it and various systems.</para>
1056 <para>support of lavg options for all systems where getloadavg() is
1057 defined (BSD unix, etc) and on Linux systems with a proc
1058 filesystem (fcron can use /proc/loadavg).</para>
1061 <para>a job can now be executed several times simultaneously if
1062 option exesev is set to 1.</para>
1065 <para>user can determine if a job can be put several times in the
1066 serial queue simultaneously thanks to option serialonce.</para>
1069 <para>fcron does not wait anymore for the completion of all jobs of
1070 a file before deleting it from memory.</para>
1073 <para>fcron handles correctly the jobs which are both serial and
1077 <para>fcron now runs under a specific user and group (other than
1078 root) for basic security reasons.</para>
1081 <para>bug corrected: fcron used to crash after a file was deleted
1082 from memory in some conditions.</para>
1085 <para>corrected the bug which used to appear when a line was put
1086 several times in the serial queue: in this case, fcron used not
1087 to count correctly the number of running serial jobs.</para>
1090 <para>bug corrected: fcrontab used not to remove the temporary file
1091 it creates if no modification where done to a file after an
1092 edition using the -e option and on errors.</para>
1095 <para>bug corrected: fcrontab now defines correctly the remain
1096 value of a line based on time and date beginning with a "&" but
1097 without runfreq definition.</para>
1100 <para>bug corrected: fcron used to not install correctly a file
1101 edited if a correction was made.</para>
1104 <para>bug corrected: reset option was not working correctly when
1105 set to a single line.</para>
1110 <title>From version 0.9.0 to 0.9.1</title>
1112 <para>support of the option mailto for each line (it used to be set
1113 for the whole file).</para>
1116 <para>the value of the runas and mailto options are now stored
1117 internally as a uid number: you must reinstall all the system's
1118 fcrontabs if you change the uid of a user.</para>
1121 <para>Support of options "lavg*", in order to run a job under a
1122 specific 1, 5 and/or 15 minutes system load average value(s).
1123 When the job should be run, it is placed in a specific queue and
1124 the load average is checked regularly until the right value(s)
1125 is/are got. The options "lavgor" and "lavgand" permits users to
1126 tell fcron if they prefer to perform a logic OR or AND between
1127 the 1, 5 and 15 load average values. The option "until" can be
1128 use to force the execution of a job after a determined timeout if
1129 the right conditions to run the job are not filled.</para>
1132 <para>fcron now uses putenv() in place of setenv() (setenv() is not
1133 POSIX compliant).</para>
1136 <para>a mailto option set to "" is now equivalent to
1137 "mail(false)".</para>
1140 <para>corrected the bug which used to make a bootrun and runfreq(1)
1141 job executed twice when fcron's start occurs in an interval of
1142 execution of the job.</para>
1145 <para>corrected the bug which used to make fcron crash after
1146 serial_array is resized.</para>
1151 <title>From version 0.8.3 to 0.9.0</title>
1153 <para>support of options in fcrontabs. Options can be specific to a
1154 line or defined once for every line located after their
1155 definition (a special option "reset" set all options to their
1156 default). Some options also have too names: a long name and an
1157 abbreviation.</para>
1160 <para>jobs can now be run be run one after the other (option
1161 "serial"): when the job should normally be run, it is added to a
1162 queue, which entries are executed one by one. It permits to avoid
1163 the use of a lot of system resources for a brief moment by the
1164 simultaneous execution of several tasks.</para>
1167 <para>jobs can be run at system start up if they should have been
1168 run during system down time (option "bootrun").</para>
1171 <para>root can run jobs as an another user (option "runas")</para>
1174 <para>user can set a nice value to a job, but only root can use a
1175 negative value (a negative value will increase priority)</para>
1178 <para>user can choose to perform a logic AND or a logic OR between
1179 day of month and day of week (option "dayor" and "dayand")</para>
1182 <para>user can choose to mail the output of jobs (option "mail") if
1183 any, and can force fcron to send a mail even if output is
1184 zero-length (option "forcemail").</para>
1187 <para>fixed the bug which used to make fcron run a job with a
1188 runfreq set to 1 at a wrong time.</para>
1191 <para>fixed a bug which used to make fcrontab crash after several
1192 corrections in edit mode.</para>
1197 <title>From version 0.8.2 to 0.8.3</title>
1199 <para>(all this bugs appeared in version 0.8.2 :)</para>
1202 <para>fixed the bug which used to make fcron crash after a
1206 <para>fixed the bug which used to prevent fcron from running some
1207 job based on time and date</para>
1210 <para>fixed the bug which used to makes fcron run the jobs one
1211 second too late</para>
1216 <title>From version 0.8.1 to 0.8.2</title>
1218 <para>code has been optimized: The jobs are now queued in order of
1219 execution. It permits avoid useless tests of all jobs every time
1220 fcron wakes up, speeds up the determination of the time fcron
1221 should sleep, speeds up the processing after the end of a job,
1222 etc. I don't know why I haven't made it before :-) ...</para>
1225 <para>fcrontab has been improved: it is now more stable (many bugs
1226 which used to make fcrontab crash in case of errors in the
1227 fcrontab has been fixed). Plus, it now asks if you want to make
1228 corrections if needed when editing.</para>
1233 <title>From version 0.8.0 to 0.8.1</title>
1235 <para>ported to FreeBSD 4.0</para>
1240 <title>From version 0.7.0 to 0.8.0</title>
1242 <para>corrected the bug which keep normal users from listing and
1243 editing their current configuration file with fcrontab -l or
1247 <para>corrected the bugs which used to block fcron when a task was
1248 marked for execution but fcron stopped before it has been
1249 launched, and when fcron stopped after the end of a job but
1250 before the output has been mailed.</para>
1253 <para>day of week 0 and 7 now both mean Sunday.</para>
1256 <para>the abbreviations of months and day of week are not any more
1257 case dependent.</para>
1260 <para>months are now defined from 1 to 12 (and not from 0 to 11) (it
1261 was a little bit illogical :-).</para>
1264 <para>you can now force spaces in strings if you place them in
1268 <para>I discovered ispell :-) ...</para>
1271 <para>I've added a kind of signature in the formated configuration
1272 files in order to keep the daemon from attempting to read an old
1273 configuration file which doesn't use the same syntax.</para>
1276 <para>You can now install a file with fcrontab from standard
1280 <para>others minor adds and bug corrections.</para>
1285 <!-- Keep this comment at the end of the file
1288 sgml-parent-document:("fcron-doc.sgml" "book" "chapter" "sect1" "")