Generated by groff

fcron.8

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
n d newspooldir d
RETURN VALUES
SIGNALS
CONFORMING TO
FILES
SEE ALSO
AUTHOR

NAME

fcron - daemon to execute scheduled commands

SYNOPSIS

fcron [d] [f] [b] [s t] [m n] [c f]
fcron [n d]
fcron [h]
fcron [V]

DESCRIPTION

Fcron should be started from /etc/rc or /etc/rc.local. Unless the f (or foreground) option is given, it will return immediately, so you don't need to start it with '&'.

Fcron loads users fcrontabs (see fcrontab(5)) files previously installed by fcrontab (see fcrontab(1)). Then, fcron calculates the time and date of each job's next execution, and determines how long it has to sleep, and sleeps for this amount of time. When it wakes up, it checks all jobs loaded and runs them if needed. When a job is executed, fcron forks, changes its user and group permissions to match those of the user the job is being done for, executes that job and mails the outputs to the user (this can be changed : see fcrontab(5)).

Informative message about what fcron is doing are sent to syslogd(8) under facility cron, pri ority notice. Warning and error messages are sent respectively at priority warning and error.

Note that fcron sleeps at least 20 seconds after it has been started before executing a job to avoid to use too much resources during system boot.

OPTIONS

	f foreground	Don't fork to the background. In this mode, fcron will output informa tional message to standard error as well as to syslogd.
	b background	Force running in background, even if fcron has been compiled to run in foreground as default.
	s t savetime t m n maxserial n	Save fcrontabs on disk every t sec (default is 1800). Set to n the maximum number of serial jobs which can run simultane ously. By default, this value is set to 1. see also : option serial in fcrontab(5).
	c f configfile f	Make fcron use config file f instead of default config file /etc/fcron.conf. To interact with that running fcron process, fcrontab must use the same config file (which is defined by fcrontab's option c). That way, several fcron processes can run simultaneously on an only system (but each fcron process must have a different spool dir and pid file from the other processes).

n d newspooldir d

Create d as a new spool directory for fcron. Set correctly its mode and owner. Then, exit.

h help

V version

Display a brief description of the options.

Display an informational message about fcron, including its version and the license under which it is distributed.

d debug

Run in debug mode (more details on stderr (if option f is set) and in log file)

RETURN VALUES

Fcron returns 0 on normal exit, and 1 on error.

SIGNALS

	SIGTERM	Save configuration (time remaining until next execution, time and date of next execution, etc), wait for all running jobs and exit.
	SIGUSR1	Force fcron to reload its configuration.

	SIGUSR2	Make fcron print its current schedule on syslog. It also toggles on/off the printing on debug info on syslog.
	SIGHUP	Tell fcron to check if there is any configuration update (this signal is used by fcrontab(5))

CONFORMING TO

Should be POSIX compliant.

FILES

	/etc/fcron.conf	Configuration file for fcron and fcrontab : contains paths (spool dir, pid file) and default programs to use (editor, shell, etc). See fcron.conf(5) for more details.
	/etc/fcron.allow	Users allowed to use fcrontab (one name per line, special name "all" acts for everyone)
	/etc/fcron.deny	Users who are not allowed to use fcrontab (same format as allow file)

AUTHOR

Thibault Godouet <fcron@free.fr>