Index: base/watchdog.h |
=================================================================== |
--- base/watchdog.h (revision 70312) |
+++ base/watchdog.h (working copy) |
@@ -1,94 +0,0 @@ |
-// Copyright (c) 2006-2008 The Chromium Authors. All rights reserved. |
-// Use of this source code is governed by a BSD-style license that can be |
-// found in the LICENSE file. |
- |
-// The Watchdog class creates a second thread that can Alarm if a specific |
-// duration of time passes without proper attention. The duration of time is |
-// specified at construction time. The Watchdog may be used many times by |
-// simply calling Arm() (to start timing) and Disarm() (to reset the timer). |
-// The Watchdog is typically used under a debugger, where the stack traces on |
-// other threads can be examined if/when the Watchdog alarms. |
- |
-// Some watchdogs will be enabled or disabled via command line switches. To |
-// facilitate such code, an "enabled" argument for the constuctor can be used |
-// to permanently disable the watchdog. Disabled watchdogs don't even spawn |
-// a second thread, and their methods call (Arm() and Disarm()) return very |
-// quickly. |
- |
-#ifndef BASE_WATCHDOG_H__ |
-#define BASE_WATCHDOG_H__ |
-#pragma once |
- |
-#include <string> |
- |
-#include "base/condition_variable.h" |
-#include "base/lock.h" |
-#include "base/platform_thread.h" |
-#include "base/time.h" |
- |
-class Watchdog { |
- public: |
- // Constructor specifies how long the Watchdog will wait before alarming. |
- Watchdog(const base::TimeDelta& duration, |
- const std::string& thread_watched_name, |
- bool enabled); |
- virtual ~Watchdog(); |
- |
- // Start timing, and alarm when time expires (unless we're disarm()ed.) |
- void Arm(); // Arm starting now. |
- void ArmSomeTimeDeltaAgo(const base::TimeDelta& time_delta); |
- void ArmAtStartTime(const base::TimeTicks start_time); |
- |
- // Reset time, and do not set off the alarm. |
- void Disarm(); |
- |
- // Alarm is called if the time expires after an Arm() without someone calling |
- // Disarm(). This method can be overridden to create testable classes. |
- virtual void Alarm(); |
- |
- // Reset static data to initial state. Useful for tests, to ensure |
- // they are independent. |
- static void ResetStaticData(); |
- |
- private: |
- class ThreadDelegate : public PlatformThread::Delegate { |
- public: |
- explicit ThreadDelegate(Watchdog* watchdog) : watchdog_(watchdog) { |
- } |
- virtual void ThreadMain(); |
- private: |
- Watchdog* watchdog_; |
- |
- void SetThreadName() const; |
- }; |
- |
- enum State {ARMED, DISARMED, SHUTDOWN }; |
- |
- bool init_successful_; |
- |
- Lock lock_; // Mutex for state_. |
- ConditionVariable condition_variable_; |
- State state_; |
- const base::TimeDelta duration_; // How long after start_time_ do we alarm? |
- const std::string thread_watched_name_; |
- PlatformThreadHandle handle_; |
- ThreadDelegate delegate_; // Store it, because it must outlive the thread. |
- |
- base::TimeTicks start_time_; // Start of epoch, and alarm after duration_. |
- |
- // When the debugger breaks (when we alarm), all the other alarms that are |
- // armed will expire (also alarm). To diminish this effect, we track any |
- // delay due to debugger breaks, and we *try* to adjust the effective start |
- // time of other alarms to step past the debugging break. |
- // Without this safety net, any alarm will typically trigger a host of follow |
- // on alarms from callers that specify old times. |
- static Lock static_lock_; // Lock for access of static data... |
- // When did we last alarm and get stuck (for a while) in a debugger? |
- static base::TimeTicks last_debugged_alarm_time_; |
- // How long did we sit on a break in the debugger? |
- static base::TimeDelta last_debugged_alarm_delay_; |
- |
- DISALLOW_COPY_AND_ASSIGN(Watchdog); |
-}; |
- |
-#endif // BASE_WATCHDOG_H__ |