5 whenjobsd - whenjobs per-user daemon
11 To start the daemon as a user, do:
13 whenjobs --daemon-start
15 To start the daemon as root (eg. from C</etc/rc.local>) for a
16 particular user called C<username> do:
18 su username -c /usr/sbin/whenjobsd
22 C<whenjobsd> is the daemon that runs whenjobs. Normally users do not
23 need to run this program directly. You can start and stop the daemon
24 using the L<whenjobs(1)> tool:
26 whenjobs --daemon-start
27 whenjobs --daemon-stop
28 whenjobs --daemon-status
29 whenjobs --daemon-restart
31 All documentation on the whenjobs cron replacement system can be found
32 in the L<whenjobs(1)> man page. This man page documents the daemon
35 Unlike cron, each user that wants to use whenjobs runs their own
36 whenjobsd. They operate completely separately.
38 The daemon sends log messages to syslog using the "cron" facility.
39 Where these end up depends on the configuration of your syslog system,
40 which can vary from Linux distro to Linux distro. Typically the file
41 to look at might be one of:
53 Enable extra debugging messages. These are sent to syslog.
57 Don't fork into the background.
63 Display the name and version of the program and exit.
69 Display brief usage and exit.
77 =item C<$HOME/.whenjobs/daemon_pid>
79 This contains the process ID of the daemon. The daemon also holds an
80 advisory (L<flock(2)>-style) exclusive lock on this file while it is
83 =item C<$HOME/.whenjobs/*.cmo>
85 The compiled jobs specification file(s) which the daemon loads on
86 start up, or reloads when instructed to by the L<whenjobs(1)> tool.
88 Normally you only have one, called C<jobs.cmo>, corresponding to the
89 source file C<jobs.ml> which is edited by C<whenjobs -e>. It is
90 possible to have multiple files, see L<whenjobs(1)/MULTIPLE JOBS FILES>.
92 =item C<$HOME/.whenjobs/socket>
94 The daemon creates this socket and listens for incoming connections
95 from the L<whenjobs(1)> tool.
99 =head1 ENVIRONMENT VARIABLES
105 The user's home directory. This directory must exist and must be
106 owned by the same user as the daemon.
110 The shell used to execute shell scripts. If not set, C</bin/sh> is
121 Richard W.M. Jones L<http://people.redhat.com/~rjones/>
125 Copyright (C) 2012 Red Hat Inc.
127 This program is free software; you can redistribute it and/or modify
128 it under the terms of the GNU General Public License as published by
129 the Free Software Foundation; either version 2 of the License, or
130 (at your option) any later version.
132 This program is distributed in the hope that it will be useful,
133 but WITHOUT ANY WARRANTY; without even the implied warranty of
134 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
135 GNU General Public License for more details.
137 You should have received a copy of the GNU General Public License
138 along with this program; if not, write to the Free Software
139 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.