/*
- * Bacula thread watchdog routine. General routine that monitors
- * the daemon and signals a thread if it is blocked on a BSOCK
- * too long. This prevents catastropic long waits -- generally
- * due to Windows "hanging" the app.
- *
- * Kern Sibbald, January MMII
- *
- */
-/*
- Copyright (C) 2000, 2001, 2002 Kern Sibbald and John Walker
+ Bacula® - The Network Backup Solution
+
+ Copyright (C) 2002-2008 Free Software Foundation Europe e.V.
- This program is free software; you can redistribute it and/or
- modify it under the terms of the GNU General Public License as
- published by the Free Software Foundation; either version 2 of
- the License, or (at your option) any later version.
+ The main author of Bacula is Kern Sibbald, with contributions from
+ many others, a complete list can be found in the file AUTHORS.
+ This program is Free Software; you can redistribute it and/or
+ modify it under the terms of version two of the GNU General Public
+ License as published by the Free Software Foundation and included
+ in the file LICENSE.
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
+ This program is distributed in the hope that it will be useful, but
+ WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
- You should have received a copy of the GNU General Public
- License along with this program; if not, write to the Free
- Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
- MA 02111-1307, USA.
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+ 02110-1301, USA.
+ Bacula® is a registered trademark of Kern Sibbald.
+ The licensor of Bacula is the Free Software Foundation Europe
+ (FSFE), Fiduciary Program, Sumatrastrasse 25, 8006 Zürich,
+ Switzerland, email:ftf@fsfeurope.org.
+*/
+/*
+ * Bacula thread watchdog routine. General routine that
+ * allows setting a watchdog timer with a callback that is
+ * called when the timer goes off.
+ *
+ * Kern Sibbald, January MMII
+ *
*/
#include "bacula.h"
#include "jcr.h"
/* Exported globals */
-time_t watchdog_time; /* this has granularity of SLEEP_TIME */
-
+utime_t watchdog_time = 0; /* this has granularity of SLEEP_TIME */
+utime_t watchdog_sleep_time = 60; /* examine things every 60 seconds */
-#define TIMEOUT_SIGNAL SIGUSR2
-#define SLEEP_TIME 30 /* examine things every 30 seconds */
+/* Locals */
+static pthread_mutex_t timer_mutex = PTHREAD_MUTEX_INITIALIZER;
+static pthread_cond_t timer = PTHREAD_COND_INITIALIZER;
/* Forward referenced functions */
-static void *btimer_thread(void *arg);
-static void stop_btimer(btimer_id wid);
-static btimer_id btimer_start_common(uint32_t wait);
+extern "C" void *watchdog_thread(void *arg);
+
+static void wd_lock();
+static void wd_unlock();
/* Static globals */
-static pthread_mutex_t mutex;
-static pthread_cond_t timer;
-static int quit;
-static btimer_t *timer_chain = NULL;
+static bool quit = false;;
+static bool wd_is_init = false;
+static brwlock_t lock; /* watchdog lock */
+static pthread_t wd_tid;
+static dlist *wd_queue;
+static dlist *wd_inactive;
/*
- * Timeout signal comes here
- */
-static void timeout_handler(int sig)
-{
- return; /* thus interrupting the function */
-}
-
-
-/*
* Start watchdog thread
*
* Returns: 0 on success
- * errno on failure
+ * errno on failure
*/
int start_watchdog(void)
{
int stat;
- pthread_t wdid;
- struct sigaction sigtimer;
-
- sigtimer.sa_flags = 0;
- sigtimer.sa_handler = timeout_handler;
- sigfillset(&sigtimer.sa_mask);
- sigaction(TIMEOUT_SIGNAL, &sigtimer, NULL);
- watchdog_time = time(NULL);
- if ((stat = pthread_mutex_init(&mutex, NULL)) != 0) {
- return stat;
+ watchdog_t *dummy = NULL;
+ int errstat;
+
+ if (wd_is_init) {
+ return 0;
}
- if ((stat = pthread_cond_init(&timer, NULL)) != 0) {
- pthread_mutex_destroy(&mutex);
- return stat;
+ Dmsg0(800, "Initialising NicB-hacked watchdog thread\n");
+ watchdog_time = time(NULL);
+
+ if ((errstat=rwl_init(&lock)) != 0) {
+ berrno be;
+ Jmsg1(NULL, M_ABORT, 0, _("Unable to initialize watchdog lock. ERR=%s\n"),
+ be.bstrerror(errstat));
}
- quit = FALSE;
- if ((stat = pthread_create(&wdid, NULL, btimer_thread, (void *)NULL)) != 0) {
- pthread_mutex_destroy(&mutex);
- pthread_cond_destroy(&timer);
+ wd_queue = New(dlist(dummy, &dummy->link));
+ wd_inactive = New(dlist(dummy, &dummy->link));
+ wd_is_init = true;
+
+ if ((stat = pthread_create(&wd_tid, NULL, watchdog_thread, NULL)) != 0) {
return stat;
}
return 0;
}
+/*
+ * Wake watchdog timer thread so that it walks the
+ * queue and adjusts its wait time (or exits).
+ */
+static void ping_watchdog()
+{
+ P(timer_mutex);
+ pthread_cond_signal(&timer);
+ V(timer_mutex);
+ bmicrosleep(0, 100);
+}
+
/*
* Terminate the watchdog thread
*
* Returns: 0 on success
- * errno on failure
+ * errno on failure
*/
int stop_watchdog(void)
{
int stat;
+ watchdog_t *p;
- P(mutex);
- quit = TRUE;
-
- if ((stat = pthread_cond_signal(&timer)) != 0) {
- V(mutex);
- return stat;
+ if (!wd_is_init) {
+ return 0;
}
- V(mutex);
- return 0;
-}
+ quit = true; /* notify watchdog thread to stop */
+ ping_watchdog();
-/*
- * This is the actual watchdog thread.
- */
-static void *btimer_thread(void *arg)
-{
- struct timespec timeout;
- int stat;
- JCR *jcr;
- BSOCK *fd;
- btimer_t *wid;
+ stat = pthread_join(wd_tid, NULL);
- Dmsg0(200, "Start watchdog thread\n");
- pthread_detach(pthread_self());
+ while (!wd_queue->empty()) {
+ void *item = wd_queue->first();
+ wd_queue->remove(item);
+ p = (watchdog_t *)item;
+ if (p->destructor != NULL) {
+ p->destructor(p);
+ }
+ free(p);
+ }
+ delete wd_queue;
+ wd_queue = NULL;
+
+ while (!wd_inactive->empty()) {
+ void *item = wd_inactive->first();
+ wd_inactive->remove(item);
+ p = (watchdog_t *)item;
+ if (p->destructor != NULL) {
+ p->destructor(p);
+ }
+ free(p);
+ }
+ delete wd_inactive;
+ wd_inactive = NULL;
+ rwl_destroy(&lock);
+ wd_is_init = false;
- P(mutex);
- for ( ;!quit; ) {
- struct timeval tv;
- struct timezone tz;
- time_t timer_start, now;
+ return stat;
+}
- Dmsg0(200, "Top of for loop\n");
+watchdog_t *new_watchdog(void)
+{
+ watchdog_t *wd = (watchdog_t *)malloc(sizeof(watchdog_t));
- watchdog_time = time(NULL); /* update timer */
+ if (!wd_is_init) {
+ start_watchdog();
+ }
- /* Walk through all JCRs checking if any one is
- * blocked for more than specified max time.
- */
- lock_jcr_chain();
- for (jcr=NULL; (jcr=get_next_jcr(jcr)); ) {
- free_locked_jcr(jcr);
- if (jcr->JobId == 0) {
- continue;
- }
- fd = jcr->store_bsock;
- if (fd) {
- timer_start = fd->timer_start;
- if (timer_start && (watchdog_time - timer_start) > fd->timeout) {
- fd->timed_out = TRUE;
- Jmsg(jcr, M_ERROR, 0, _(
-"Watchdog sending kill after %d secs to thread stalled reading Storage daemon.\n"),
- watchdog_time - timer_start);
- pthread_kill(jcr->my_thread_id, TIMEOUT_SIGNAL);
- }
- }
- fd = jcr->file_bsock;
- if (fd) {
- timer_start = fd->timer_start;
- if (timer_start && (watchdog_time - timer_start) > fd->timeout) {
- fd->timed_out = TRUE;
- Jmsg(jcr, M_ERROR, 0, _(
-"Watchdog sending kill after %d secs to thread stalled reading File daemon.\n"),
- watchdog_time - timer_start);
- pthread_kill(jcr->my_thread_id, TIMEOUT_SIGNAL);
- }
- }
- fd = jcr->dir_bsock;
- if (fd) {
- timer_start = fd->timer_start;
- if (timer_start && (watchdog_time - timer_start) > fd->timeout) {
- fd->timed_out = TRUE;
- Jmsg(jcr, M_ERROR, 0, _(
-"Watchdog sending kill after %d secs to thread stalled reading Director.\n"),
- watchdog_time - timer_start);
- pthread_kill(jcr->my_thread_id, TIMEOUT_SIGNAL);
- }
- }
+ if (wd == NULL) {
+ return NULL;
+ }
+ wd->one_shot = true;
+ wd->interval = 0;
+ wd->callback = NULL;
+ wd->destructor = NULL;
+ wd->data = NULL;
- }
- unlock_jcr_chain();
+ return wd;
+}
- gettimeofday(&tv, &tz);
- timeout.tv_nsec = 0;
- timeout.tv_sec = tv.tv_sec + SLEEP_TIME;
+bool register_watchdog(watchdog_t *wd)
+{
+ if (!wd_is_init) {
+ Jmsg0(NULL, M_ABORT, 0, _("BUG! register_watchdog called before start_watchdog\n"));
+ }
+ if (wd->callback == NULL) {
+ Jmsg1(NULL, M_ABORT, 0, _("BUG! Watchdog %p has NULL callback\n"), wd);
+ }
+ if (wd->interval == 0) {
+ Jmsg1(NULL, M_ABORT, 0, _("BUG! Watchdog %p has zero interval\n"), wd);
+ }
- Dmsg1(200, "pthread_cond_timedwait sec=%d\n", timeout.tv_sec);
- /* Note, this unlocks mutex during the sleep */
- stat = pthread_cond_timedwait(&timer, &mutex, &timeout);
- Dmsg1(200, "pthread_cond_timedwait stat=%d\n", stat);
-
- now = time(NULL);
-
- /* Walk child chain killing off any process overdue */
- for (wid = timer_chain; wid; wid=wid->next) {
- int killed = FALSE;
- /* First ask him politely to go away */
- if (!wid->killed && now > (wid->start_time + wid->wait)) {
-// Dmsg1(000, "Watchdog sigterm pid=%d\n", wid->pid);
- if (wid->type == TYPE_CHILD) {
- kill(wid->pid, SIGTERM);
- killed = TRUE;
- } else {
- Dmsg1(200, "watchdog kill thread %d\n", wid->tid);
- pthread_kill(wid->tid, TIMEOUT_SIGNAL);
- wid->killed = TRUE;
- }
- }
- /* If we asked a child to die, wait 3 seconds and slam him */
- if (killed) {
- btimer_t *wid1;
- sleep(3);
- for (wid1 = timer_chain; wid1; wid1=wid1->next) {
- if (wid->type == TYPE_CHILD &&
- !wid1->killed && now > (wid1->start_time + wid1->wait)) {
- kill(wid1->pid, SIGKILL);
-// Dmsg1(000, "Watchdog killed pid=%d\n", wid->pid);
- wid1->killed = TRUE;
- }
- }
- }
- }
-
- } /* end of big for loop */
+ wd_lock();
+ wd->next_fire = watchdog_time + wd->interval;
+ wd_queue->append(wd);
+ Dmsg3(800, "Registered watchdog %p, interval %d%s\n",
+ wd, wd->interval, wd->one_shot ? " one shot" : "");
+ wd_unlock();
+ ping_watchdog();
- V(mutex);
- Dmsg0(200, "End watchdog\n");
- return NULL;
+ return false;
}
-/*
- * Start a timer on a child process of pid, kill it after wait seconds.
- * NOTE! Granularity is SLEEP_TIME (i.e. 30 seconds)
- *
- * Returns: btimer_id (pointer to btimer_t struct) on success
- * NULL on failure
- */
-btimer_id start_child_timer(pid_t pid, uint32_t wait)
+bool unregister_watchdog(watchdog_t *wd)
{
- btimer_t *wid;
- wid = btimer_start_common(wait);
- wid->pid = pid;
- wid->type = TYPE_CHILD;
- Dmsg2(200, "Start child timer 0x%x for %d secs.\n", wid, wait);
- return wid;
-}
+ watchdog_t *p;
+ bool ok = false;
-/*
- * Start a timer on a thread. kill it after wait seconds.
- * NOTE! Granularity is SLEEP_TIME (i.e. 30 seconds)
- *
- * Returns: btimer_id (pointer to btimer_t struct) on success
- * NULL on failure
- */
-btimer_id start_thread_timer(pthread_t tid, uint32_t wait)
-{
- btimer_t *wid;
- wid = btimer_start_common(wait);
- wid->tid = tid;
- wid->type = TYPE_PTHREAD;
- Dmsg2(200, "Start thread timer 0x%x for %d secs.\n", wid, wait);
- return wid;
-}
+ if (!wd_is_init) {
+ Jmsg0(NULL, M_ABORT, 0, _("BUG! unregister_watchdog_unlocked called before start_watchdog\n"));
+ }
-static btimer_id btimer_start_common(uint32_t wait)
-{
- btimer_id wid = (btimer_id)malloc(sizeof(btimer_t));
-
- P(mutex);
- /* Chain it into timer_chain as the first item */
- wid->prev = NULL;
- wid->next = timer_chain;
- if (timer_chain) {
- timer_chain->prev = wid;
+ wd_lock();
+ foreach_dlist(p, wd_queue) {
+ if (wd == p) {
+ wd_queue->remove(wd);
+ Dmsg1(800, "Unregistered watchdog %p\n", wd);
+ ok = true;
+ goto get_out;
+ }
+ }
+
+ foreach_dlist(p, wd_inactive) {
+ if (wd == p) {
+ wd_inactive->remove(wd);
+ Dmsg1(800, "Unregistered inactive watchdog %p\n", wd);
+ ok = true;
+ goto get_out;
+ }
}
- timer_chain = wid;
- wid->start_time = time(NULL);
- wid->wait = wait;
- wid->killed = FALSE;
- V(mutex);
- return wid;
+
+ Dmsg1(800, "Failed to unregister watchdog %p\n", wd);
+
+get_out:
+ wd_unlock();
+ ping_watchdog();
+ return ok;
}
/*
- * Stop child timer
+ * This is the thread that walks the watchdog queue
+ * and when a queue item fires, the callback is
+ * invoked. If it is a one shot, the queue item
+ * is moved to the inactive queue.
*/
-void stop_child_timer(btimer_id wid)
+extern "C" void *watchdog_thread(void *arg)
{
- Dmsg2(200, "Stop child timer 0x%x for %d secs.\n", wid, wid->wait);
- stop_btimer(wid);
+ struct timespec timeout;
+ struct timeval tv;
+ struct timezone tz;
+ utime_t next_time;
+
+ set_jcr_in_tsd(INVALID_JCR);
+ Dmsg0(800, "NicB-reworked watchdog thread entered\n");
+
+ while (!quit) {
+ watchdog_t *p;
+
+ /*
+ *
+ * NOTE. lock_jcr_chain removed, but the message below
+ * was left until we are sure there are no deadlocks.
+ *
+ * We lock the jcr chain here because a good number of the
+ * callback routines lock the jcr chain. We need to lock
+ * it here *before* the watchdog lock because the SD message
+ * thread first locks the jcr chain, then when closing the
+ * job locks the watchdog chain. If the two threads do not
+ * lock in the same order, we get a deadlock -- each holds
+ * the other's needed lock.
+ */
+ wd_lock();
+
+walk_list:
+ watchdog_time = time(NULL);
+ next_time = watchdog_time + watchdog_sleep_time;
+ foreach_dlist(p, wd_queue) {
+ if (p->next_fire <= watchdog_time) {
+ /* Run the callback */
+ Dmsg2(3400, "Watchdog callback p=0x%p fire=%d\n", p, p->next_fire);
+ p->callback(p);
+
+ /* Reschedule (or move to inactive list if it's a one-shot timer) */
+ if (p->one_shot) {
+ wd_queue->remove(p);
+ wd_inactive->append(p);
+ goto walk_list;
+ } else {
+ p->next_fire = watchdog_time + p->interval;
+ }
+ }
+ if (p->next_fire <= next_time) {
+ next_time = p->next_fire;
+ }
+ }
+ wd_unlock();
+
+ /*
+ * Wait sleep time or until someone wakes us
+ */
+ gettimeofday(&tv, &tz);
+ timeout.tv_nsec = tv.tv_usec * 1000;
+ timeout.tv_sec = tv.tv_sec + next_time - time(NULL);
+ while (timeout.tv_nsec >= 1000000000) {
+ timeout.tv_nsec -= 1000000000;
+ timeout.tv_sec++;
+ }
+
+ Dmsg1(1900, "pthread_cond_timedwait %d\n", timeout.tv_sec - tv.tv_sec);
+ /* Note, this unlocks mutex during the sleep */
+ P(timer_mutex);
+ pthread_cond_timedwait(&timer, &timer_mutex, &timeout);
+ V(timer_mutex);
+ }
+
+ Dmsg0(800, "NicB-reworked watchdog thread exited\n");
+ return NULL;
}
/*
- * Stop thread timer
+ * Watchdog lock, this can be called multiple times by the same
+ * thread without blocking, but must be unlocked the number of
+ * times it was locked.
*/
-void stop_thread_timer(btimer_id wid)
+static void wd_lock()
{
- if (!wid) {
- return;
+ int errstat;
+ if ((errstat=rwl_writelock(&lock)) != 0) {
+ berrno be;
+ Jmsg1(NULL, M_ABORT, 0, _("rwl_writelock failure. ERR=%s\n"),
+ be.bstrerror(errstat));
}
- Dmsg2(200, "Stop thread timer 0x%x for %d secs.\n", wid, wid->wait);
- stop_btimer(wid);
}
-
/*
- * Stop btimer
+ * Unlock the watchdog. This can be called multiple times by the
+ * same thread up to the number of times that thread called
+ * wd_ lock()/
*/
-static void stop_btimer(btimer_id wid)
+static void wd_unlock()
{
- if (wid == NULL) {
- Emsg0(M_ABORT, 0, _("NULL btimer_id.\n"));
- }
- P(mutex);
- /* Remove wid from timer_chain */
- if (!wid->prev) { /* if no prev */
- timer_chain = wid->next; /* set new head */
- } else {
- wid->prev->next = wid->next; /* update prev */
- }
- if (wid->next) {
- wid->next->prev = wid->prev; /* unlink it */
+ int errstat;
+ if ((errstat=rwl_writeunlock(&lock)) != 0) {
+ berrno be;
+ Jmsg1(NULL, M_ABORT, 0, _("rwl_writeunlock failure. ERR=%s\n"),
+ be.bstrerror(errstat));
}
- V(mutex);
- free(wid);
}