blob: dd8ba3ad06891fd6d2409d36c94ced6ffa7f6310 [file] [log] [blame]
jhawkins@chromium.orge194f3d2012-01-05 11:18:18 +09001// Copyright (c) 2012 The Chromium Authors. All rights reserved.
license.botf003cfe2008-08-24 09:55:55 +09002// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
initial.commit3f4a7322008-07-27 06:49:38 +09004
darin@google.com6ddeb842008-08-15 16:31:20 +09005#include "base/message_loop.h"
6
darin@google.com981f3552008-08-16 12:09:05 +09007#include <algorithm>
8
ajwong@chromium.org94d2a582011-04-21 01:02:23 +09009#include "base/bind.h"
mmentovai@google.comfa5f9932008-08-22 07:26:06 +090010#include "base/compiler_specific.h"
apatrick@chromium.org87164042011-05-20 07:28:25 +090011#include "base/debug/alias.h"
jbates@chromium.orgb84db522011-10-04 02:51:25 +090012#include "base/debug/trace_event.h"
deanm@chromium.orgcd1ce302008-09-10 19:54:06 +090013#include "base/lazy_instance.h"
initial.commit3f4a7322008-07-27 06:49:38 +090014#include "base/logging.h"
thestig@chromium.orgefd4aaf2011-06-15 13:14:23 +090015#include "base/memory/scoped_ptr.h"
nduca@chromium.orgba048612011-08-16 05:33:46 +090016#include "base/message_loop_proxy_impl.h"
darin@google.com12d40bb2008-08-20 03:36:23 +090017#include "base/message_pump_default.h"
brettw@chromium.org275c2ec2010-10-14 13:38:38 +090018#include "base/metrics/histogram.h"
timurrrr@chromium.org490200b2011-01-05 04:06:51 +090019#include "base/third_party/dynamic_annotations/dynamic_annotations.h"
sergeyu@chromium.org675d8882012-05-10 05:16:14 +090020#include "base/thread_task_runner_handle.h"
brettw@chromium.org63965582010-12-31 07:18:56 +090021#include "base/threading/thread_local.h"
mbelshe@chromium.orgbee85b32011-05-16 04:20:49 +090022#include "base/time.h"
ajwong@chromium.org94d2a582011-04-21 01:02:23 +090023#include "base/tracked_objects.h"
initial.commit3f4a7322008-07-27 06:49:38 +090024
mark@chromium.org059d0492008-09-24 06:08:28 +090025#if defined(OS_MACOSX)
26#include "base/message_pump_mac.h"
27#endif
dkegel@google.com9e044ae2008-09-19 03:46:26 +090028#if defined(OS_POSIX)
29#include "base/message_pump_libevent.h"
30#endif
michaelbai@google.com686190b2011-08-03 01:11:16 +090031#if defined(OS_ANDROID)
32#include "base/message_pump_android.h"
33#endif
oshima@chromium.org59a08552012-04-05 09:21:22 +090034
35#if defined(TOOLKIT_GTK)
ajwong@chromium.org94d2a582011-04-21 01:02:23 +090036#include <gdk/gdk.h>
37#include <gdk/gdkx.h>
oshima@chromium.org59a08552012-04-05 09:21:22 +090038#endif
dkegel@google.com9e044ae2008-09-19 03:46:26 +090039
jhawkins@chromium.org2af12f22011-11-16 08:36:30 +090040using base::PendingTask;
dsh@google.com0f8dd262008-10-28 05:43:33 +090041using base::TimeDelta;
jar@chromium.org9b0fb062010-11-07 07:23:29 +090042using base::TimeTicks;
dsh@google.com0f8dd262008-10-28 05:43:33 +090043
erg@chromium.orga7528522010-07-16 02:23:23 +090044namespace {
45
deanm@chromium.orgcd1ce302008-09-10 19:54:06 +090046// A lazily created thread local storage for quick access to a thread's message
47// loop, if one exists. This should be safe and free of static constructors.
joth@chromium.orgb24883c2011-11-15 22:31:49 +090048base::LazyInstance<base::ThreadLocalPointer<MessageLoop> > lazy_tls_ptr =
49 LAZY_INSTANCE_INITIALIZER;
initial.commit3f4a7322008-07-27 06:49:38 +090050
initial.commit3f4a7322008-07-27 06:49:38 +090051// Logical events for Histogram profiling. Run with -message-loop-histogrammer
52// to get an accounting of messages and actions taken on each thread.
erg@chromium.orga7528522010-07-16 02:23:23 +090053const int kTaskRunEvent = 0x1;
54const int kTimerEvent = 0x2;
initial.commit3f4a7322008-07-27 06:49:38 +090055
56// Provide range of message IDs for use in histogramming and debug display.
erg@chromium.orga7528522010-07-16 02:23:23 +090057const int kLeastNonZeroMessageId = 1;
58const int kMaxMessageId = 1099;
59const int kNumberOfDistinctMessagesDisplayed = 1100;
60
61// Provide a macro that takes an expression (such as a constant, or macro
62// constant) and creates a pair to initalize an array of pairs. In this case,
63// our pair consists of the expressions value, and the "stringized" version
64// of the expression (i.e., the exrpression put in quotes). For example, if
65// we have:
66// #define FOO 2
67// #define BAR 5
68// then the following:
69// VALUE_TO_NUMBER_AND_NAME(FOO + BAR)
70// will expand to:
71// {7, "FOO + BAR"}
72// We use the resulting array as an argument to our histogram, which reads the
73// number as a bucket identifier, and proceeds to use the corresponding name
74// in the pair (i.e., the quoted string) when printing out a histogram.
75#define VALUE_TO_NUMBER_AND_NAME(name) {name, #name},
76
brettw@chromium.org275c2ec2010-10-14 13:38:38 +090077const base::LinearHistogram::DescriptionPair event_descriptions_[] = {
erg@chromium.orga7528522010-07-16 02:23:23 +090078 // Provide some pretty print capability in our histogram for our internal
79 // messages.
80
81 // A few events we handle (kindred to messages), and used to profile actions.
82 VALUE_TO_NUMBER_AND_NAME(kTaskRunEvent)
83 VALUE_TO_NUMBER_AND_NAME(kTimerEvent)
84
85 {-1, NULL} // The list must be null terminated, per API to histogram.
86};
87
88bool enable_histogrammer_ = false;
89
michaelbai@google.com686190b2011-08-03 01:11:16 +090090MessageLoop::MessagePumpFactory* message_pump_for_ui_factory_ = NULL;
91
erg@chromium.orga7528522010-07-16 02:23:23 +090092} // namespace
initial.commit3f4a7322008-07-27 06:49:38 +090093
94//------------------------------------------------------------------------------
95
darin@google.com981f3552008-08-16 12:09:05 +090096#if defined(OS_WIN)
initial.commit3f4a7322008-07-27 06:49:38 +090097
initial.commit3f4a7322008-07-27 06:49:38 +090098// Upon a SEH exception in this thread, it restores the original unhandled
99// exception filter.
100static int SEHFilter(LPTOP_LEVEL_EXCEPTION_FILTER old_filter) {
101 ::SetUnhandledExceptionFilter(old_filter);
102 return EXCEPTION_CONTINUE_SEARCH;
103}
104
105// Retrieves a pointer to the current unhandled exception filter. There
106// is no standalone getter method.
107static LPTOP_LEVEL_EXCEPTION_FILTER GetTopSEHFilter() {
108 LPTOP_LEVEL_EXCEPTION_FILTER top_filter = NULL;
109 top_filter = ::SetUnhandledExceptionFilter(0);
110 ::SetUnhandledExceptionFilter(top_filter);
111 return top_filter;
112}
113
darin@google.com981f3552008-08-16 12:09:05 +0900114#endif // defined(OS_WIN)
115
initial.commit3f4a7322008-07-27 06:49:38 +0900116//------------------------------------------------------------------------------
117
erg@chromium.org493f5f62010-07-16 06:03:54 +0900118MessageLoop::TaskObserver::TaskObserver() {
119}
120
121MessageLoop::TaskObserver::~TaskObserver() {
122}
123
124MessageLoop::DestructionObserver::~DestructionObserver() {
125}
126
127//------------------------------------------------------------------------------
128
darin@google.comd936b5b2008-08-26 14:53:57 +0900129MessageLoop::MessageLoop(Type type)
130 : type_(type),
darin@google.comee6fa722008-08-13 08:25:43 +0900131 nestable_tasks_allowed_(true),
darin@google.com12d40bb2008-08-20 03:36:23 +0900132 exception_restoration_(false),
jar@chromium.org34571142011-04-05 13:48:53 +0900133 message_histogram_(NULL),
darin@google.combe165ae2008-09-07 17:08:29 +0900134 state_(NULL),
ananta@chromium.orgc542fec2011-03-24 12:40:28 +0900135#ifdef OS_WIN
136 os_modal_loop_(false),
137#endif // OS_WIN
darin@google.combe165ae2008-09-07 17:08:29 +0900138 next_sequence_num_(0) {
deanm@chromium.orgcd1ce302008-09-10 19:54:06 +0900139 DCHECK(!current()) << "should only have one message loop per thread";
140 lazy_tls_ptr.Pointer()->Set(this);
darin@google.comd936b5b2008-08-26 14:53:57 +0900141
nduca@chromium.orgba048612011-08-16 05:33:46 +0900142 message_loop_proxy_ = new base::MessageLoopProxyImpl();
sergeyu@chromium.org675d8882012-05-10 05:16:14 +0900143 thread_task_runner_handle_.reset(
144 new base::ThreadTaskRunnerHandle(message_loop_proxy_));
nduca@chromium.orgba048612011-08-16 05:33:46 +0900145
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900146// TODO(rvargas): Get rid of the OS guards.
darin@google.com981f3552008-08-16 12:09:05 +0900147#if defined(OS_WIN)
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900148#define MESSAGE_PUMP_UI new base::MessagePumpForUI()
149#define MESSAGE_PUMP_IO new base::MessagePumpForIO()
150#elif defined(OS_MACOSX)
151#define MESSAGE_PUMP_UI base::MessagePumpMac::Create()
152#define MESSAGE_PUMP_IO new base::MessagePumpLibevent()
abarth@chromium.org1f1c2172010-12-01 17:45:51 +0900153#elif defined(OS_NACL)
154// Currently NaCl doesn't have a UI or an IO MessageLoop.
155// TODO(abarth): Figure out if we need these.
156#define MESSAGE_PUMP_UI NULL
157#define MESSAGE_PUMP_IO NULL
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900158#elif defined(OS_POSIX) // POSIX but not MACOSX.
piman@chromium.orgbfd272d2011-12-15 01:34:31 +0900159#define MESSAGE_PUMP_UI new base::MessagePumpForUI()
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900160#define MESSAGE_PUMP_IO new base::MessagePumpLibevent()
evan@chromium.org875bb6e2009-12-29 09:32:52 +0900161#else
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900162#error Not implemented
evan@chromium.org875bb6e2009-12-29 09:32:52 +0900163#endif
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900164
165 if (type_ == TYPE_UI) {
michaelbai@google.com686190b2011-08-03 01:11:16 +0900166 if (message_pump_for_ui_factory_)
167 pump_ = message_pump_for_ui_factory_();
168 else
169 pump_ = MESSAGE_PUMP_UI;
dsh@google.com119a2522008-10-04 01:52:59 +0900170 } else if (type_ == TYPE_IO) {
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900171 pump_ = MESSAGE_PUMP_IO;
dkegel@google.com9e044ae2008-09-19 03:46:26 +0900172 } else {
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900173 DCHECK_EQ(TYPE_DEFAULT, type_);
dkegel@google.com9e044ae2008-09-19 03:46:26 +0900174 pump_ = new base::MessagePumpDefault();
175 }
initial.commit3f4a7322008-07-27 06:49:38 +0900176}
177
178MessageLoop::~MessageLoop() {
thestig@chromium.org226880a2010-11-11 05:28:06 +0900179 DCHECK_EQ(this, current());
darin@google.com965e5342008-08-06 08:16:41 +0900180
darin@google.com0e500502008-09-09 14:55:35 +0900181 DCHECK(!state_);
182
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900183 // Clean up any unprocessed tasks, but take care: deleting a task could
184 // result in the addition of more tasks (e.g., via DeleteSoon). We set a
185 // limit on the number of times we will allow a deleted task to generate more
186 // tasks. Normally, we should only pass through this loop once or twice. If
187 // we end up hitting the loop limit, then it is probably due to one task that
188 // is being stubborn. Inspect the queues to see who is left.
189 bool did_work;
190 for (int i = 0; i < 100; ++i) {
191 DeletePendingTasks();
192 ReloadWorkQueue();
193 // If we end up with empty queues, then break out of the loop.
194 did_work = DeletePendingTasks();
195 if (!did_work)
196 break;
darin@google.com0e500502008-09-09 14:55:35 +0900197 }
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900198 DCHECK(!did_work);
199
sanjeevr@chromium.org03b44d52010-11-30 09:25:29 +0900200 // Let interested parties have one last shot at accessing this.
201 FOR_EACH_OBSERVER(DestructionObserver, destruction_observers_,
202 WillDestroyCurrentMessageLoop());
203
sergeyu@chromium.org675d8882012-05-10 05:16:14 +0900204 thread_task_runner_handle_.reset();
205
nduca@chromium.orgba048612011-08-16 05:33:46 +0900206 // Tell the message_loop_proxy that we are dying.
207 static_cast<base::MessageLoopProxyImpl*>(message_loop_proxy_.get())->
208 WillDestroyCurrentMessageLoop();
209 message_loop_proxy_ = NULL;
210
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900211 // OK, now make it so that no one can find us.
deanm@chromium.orge4cc5922008-09-10 20:14:56 +0900212 lazy_tls_ptr.Pointer()->Set(NULL);
mbelshe@chromium.orgbee85b32011-05-16 04:20:49 +0900213
214#if defined(OS_WIN)
215 // If we left the high-resolution timer activated, deactivate it now.
216 // Doing this is not-critical, it is mainly to make sure we track
217 // the high resolution timer activations properly in our unit tests.
218 if (!high_resolution_timer_expiration_.is_null()) {
219 base::Time::ActivateHighResolutionTimer(false);
220 high_resolution_timer_expiration_ = base::TimeTicks();
221 }
222#endif
initial.commit3f4a7322008-07-27 06:49:38 +0900223}
224
erg@google.com67a25432011-01-08 05:23:43 +0900225// static
226MessageLoop* MessageLoop::current() {
227 // TODO(darin): sadly, we cannot enable this yet since people call us even
228 // when they have no intention of using us.
229 // DCHECK(loop) << "Ouch, did you forget to initialize me?";
230 return lazy_tls_ptr.Pointer()->Get();
231}
232
233// static
234void MessageLoop::EnableHistogrammer(bool enable) {
235 enable_histogrammer_ = enable;
236}
237
michaelbai@google.com686190b2011-08-03 01:11:16 +0900238// static
239void MessageLoop::InitMessagePumpForUIFactory(MessagePumpFactory* factory) {
240 DCHECK(!message_pump_for_ui_factory_);
241 message_pump_for_ui_factory_ = factory;
242}
243
sky@chromium.org18c66dc2010-09-16 07:14:36 +0900244void MessageLoop::AddDestructionObserver(
245 DestructionObserver* destruction_observer) {
thestig@chromium.org226880a2010-11-11 05:28:06 +0900246 DCHECK_EQ(this, current());
sky@chromium.org18c66dc2010-09-16 07:14:36 +0900247 destruction_observers_.AddObserver(destruction_observer);
darin@google.com965e5342008-08-06 08:16:41 +0900248}
249
sky@chromium.org18c66dc2010-09-16 07:14:36 +0900250void MessageLoop::RemoveDestructionObserver(
251 DestructionObserver* destruction_observer) {
thestig@chromium.org226880a2010-11-11 05:28:06 +0900252 DCHECK_EQ(this, current());
sky@chromium.org18c66dc2010-09-16 07:14:36 +0900253 destruction_observers_.RemoveObserver(destruction_observer);
darin@google.com965e5342008-08-06 08:16:41 +0900254}
255
darin@google.combe165ae2008-09-07 17:08:29 +0900256void MessageLoop::PostTask(
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900257 const tracked_objects::Location& from_here, const base::Closure& task) {
brettw@chromium.org5faed3c2011-10-27 06:48:00 +0900258 DCHECK(!task.is_null()) << from_here.ToString();
jhawkins@chromium.org2af12f22011-11-16 08:36:30 +0900259 PendingTask pending_task(from_here, task, CalculateDelayedRuntime(0), true);
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900260 AddToIncomingQueue(&pending_task);
261}
262
263void MessageLoop::PostDelayedTask(
tedvessenes@gmail.com658a87f2011-12-30 10:04:36 +0900264 const tracked_objects::Location& from_here,
265 const base::Closure& task,
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900266 int64 delay_ms) {
brettw@chromium.org5faed3c2011-10-27 06:48:00 +0900267 DCHECK(!task.is_null()) << from_here.ToString();
jhawkins@chromium.org2af12f22011-11-16 08:36:30 +0900268 PendingTask pending_task(from_here, task,
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900269 CalculateDelayedRuntime(delay_ms), true);
270 AddToIncomingQueue(&pending_task);
271}
272
tedvessenes@gmail.com658a87f2011-12-30 10:04:36 +0900273void MessageLoop::PostDelayedTask(
274 const tracked_objects::Location& from_here,
275 const base::Closure& task,
276 base::TimeDelta delay) {
277 PostDelayedTask(from_here, task, delay.InMillisecondsRoundedUp());
278}
279
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900280void MessageLoop::PostNonNestableTask(
281 const tracked_objects::Location& from_here, const base::Closure& task) {
brettw@chromium.org5faed3c2011-10-27 06:48:00 +0900282 DCHECK(!task.is_null()) << from_here.ToString();
jhawkins@chromium.org2af12f22011-11-16 08:36:30 +0900283 PendingTask pending_task(from_here, task, CalculateDelayedRuntime(0), false);
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900284 AddToIncomingQueue(&pending_task);
285}
286
287void MessageLoop::PostNonNestableDelayedTask(
288 const tracked_objects::Location& from_here, const base::Closure& task,
289 int64 delay_ms) {
brettw@chromium.org5faed3c2011-10-27 06:48:00 +0900290 DCHECK(!task.is_null()) << from_here.ToString();
jhawkins@chromium.org2af12f22011-11-16 08:36:30 +0900291 PendingTask pending_task(from_here, task,
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900292 CalculateDelayedRuntime(delay_ms), false);
293 AddToIncomingQueue(&pending_task);
darin@google.combe165ae2008-09-07 17:08:29 +0900294}
295
tedvessenes@gmail.com658a87f2011-12-30 10:04:36 +0900296void MessageLoop::PostNonNestableDelayedTask(
297 const tracked_objects::Location& from_here,
298 const base::Closure& task,
299 base::TimeDelta delay) {
300 PostNonNestableDelayedTask(from_here, task, delay.InMillisecondsRoundedUp());
301}
302
erg@google.com67a25432011-01-08 05:23:43 +0900303void MessageLoop::Run() {
304 AutoRunState save_state(this);
305 RunHandler();
306}
darin@google.com0795f572008-08-30 09:22:48 +0900307
erg@google.com67a25432011-01-08 05:23:43 +0900308void MessageLoop::RunAllPending() {
309 AutoRunState save_state(this);
310 state_->quit_received = true; // Means run until we would otherwise block.
311 RunHandler();
312}
darin@google.com0795f572008-08-30 09:22:48 +0900313
erg@google.com67a25432011-01-08 05:23:43 +0900314void MessageLoop::Quit() {
315 DCHECK_EQ(this, current());
316 if (state_) {
317 state_->quit_received = true;
darin@google.com0795f572008-08-30 09:22:48 +0900318 } else {
erg@google.com67a25432011-01-08 05:23:43 +0900319 NOTREACHED() << "Must be inside Run to call Quit";
darin@google.com0795f572008-08-30 09:22:48 +0900320 }
erg@google.com67a25432011-01-08 05:23:43 +0900321}
darin@google.com0795f572008-08-30 09:22:48 +0900322
erg@google.com67a25432011-01-08 05:23:43 +0900323void MessageLoop::QuitNow() {
324 DCHECK_EQ(this, current());
325 if (state_) {
326 pump_->Quit();
327 } else {
328 NOTREACHED() << "Must be inside Run to call Quit";
mbelshe@chromium.orgde50b7d2010-06-29 13:58:15 +0900329 }
initial.commit3f4a7322008-07-27 06:49:38 +0900330}
331
kalman@chromium.orgc89ed902011-10-21 15:21:57 +0900332static void QuitCurrent() {
333 MessageLoop::current()->Quit();
334}
335
jhawkins@chromium.org573d4182011-10-17 10:20:36 +0900336// static
337base::Closure MessageLoop::QuitClosure() {
kalman@chromium.orgc89ed902011-10-21 15:21:57 +0900338 return base::Bind(&QuitCurrent);
jhawkins@chromium.org573d4182011-10-17 10:20:36 +0900339}
340
initial.commit3f4a7322008-07-27 06:49:38 +0900341void MessageLoop::SetNestableTasksAllowed(bool allowed) {
mpcomplete@google.com989d5f82008-08-09 09:14:09 +0900342 if (nestable_tasks_allowed_ != allowed) {
343 nestable_tasks_allowed_ = allowed;
344 if (!nestable_tasks_allowed_)
345 return;
346 // Start the native pump if we are not already pumping.
darin@google.com981f3552008-08-16 12:09:05 +0900347 pump_->ScheduleWork();
mpcomplete@google.com989d5f82008-08-09 09:14:09 +0900348 }
initial.commit3f4a7322008-07-27 06:49:38 +0900349}
350
351bool MessageLoop::NestableTasksAllowed() const {
352 return nestable_tasks_allowed_;
353}
354
jcampan@chromium.orgeac57172009-07-02 04:53:59 +0900355bool MessageLoop::IsNested() {
356 return state_->run_depth > 1;
357}
358
erg@google.com67a25432011-01-08 05:23:43 +0900359void MessageLoop::AddTaskObserver(TaskObserver* task_observer) {
360 DCHECK_EQ(this, current());
361 task_observers_.AddObserver(task_observer);
362}
363
364void MessageLoop::RemoveTaskObserver(TaskObserver* task_observer) {
365 DCHECK_EQ(this, current());
366 task_observers_.RemoveObserver(task_observer);
367}
368
willchan@chromium.org3a397672011-01-26 09:53:48 +0900369void MessageLoop::AssertIdle() const {
370 // We only check |incoming_queue_|, since we don't want to lock |work_queue_|.
371 base::AutoLock lock(incoming_queue_lock_);
372 DCHECK(incoming_queue_.empty());
373}
374
willchan@chromium.orgfe2201e2011-11-02 07:06:58 +0900375bool MessageLoop::is_running() const {
376 DCHECK_EQ(this, current());
377 return state_ != NULL;
378}
379
initial.commit3f4a7322008-07-27 06:49:38 +0900380//------------------------------------------------------------------------------
initial.commit3f4a7322008-07-27 06:49:38 +0900381
erg@google.com67a25432011-01-08 05:23:43 +0900382// Runs the loop in two different SEH modes:
383// enable_SEH_restoration_ = false : any unhandled exception goes to the last
384// one that calls SetUnhandledExceptionFilter().
385// enable_SEH_restoration_ = true : any unhandled exception goes to the filter
386// that was existed before the loop was run.
387void MessageLoop::RunHandler() {
388#if defined(OS_WIN)
389 if (exception_restoration_) {
390 RunInternalInSEHFrame();
391 return;
392 }
393#endif
394
395 RunInternal();
396}
397
398#if defined(OS_WIN)
399__declspec(noinline) void MessageLoop::RunInternalInSEHFrame() {
400 LPTOP_LEVEL_EXCEPTION_FILTER current_filter = GetTopSEHFilter();
401 __try {
402 RunInternal();
403 } __except(SEHFilter(current_filter)) {
404 }
405 return;
406}
407#endif
408
409void MessageLoop::RunInternal() {
410 DCHECK_EQ(this, current());
411
412 StartHistogrammer();
413
michaelbai@google.com686190b2011-08-03 01:11:16 +0900414#if !defined(OS_MACOSX) && !defined(OS_ANDROID)
erg@google.com67a25432011-01-08 05:23:43 +0900415 if (state_->dispatcher && type() == TYPE_UI) {
416 static_cast<base::MessagePumpForUI*>(pump_.get())->
417 RunWithDispatcher(this, state_->dispatcher);
418 return;
419 }
420#endif
421
422 pump_->Run(this);
423}
424
425bool MessageLoop::ProcessNextDelayedNonNestableTask() {
426 if (state_->run_depth != 1)
427 return false;
428
429 if (deferred_non_nestable_work_queue_.empty())
430 return false;
431
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900432 PendingTask pending_task = deferred_non_nestable_work_queue_.front();
erg@google.com67a25432011-01-08 05:23:43 +0900433 deferred_non_nestable_work_queue_.pop();
434
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900435 RunTask(pending_task);
erg@google.com67a25432011-01-08 05:23:43 +0900436 return true;
437}
438
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900439void MessageLoop::RunTask(const PendingTask& pending_task) {
jbates@chromium.org5a97c212012-02-24 04:16:35 +0900440 TRACE_EVENT2("task", "MessageLoop::RunTask",
441 "src_file", pending_task.posted_from.file_name(),
442 "src_func", pending_task.posted_from.function_name());
initial.commit3f4a7322008-07-27 06:49:38 +0900443 DCHECK(nestable_tasks_allowed_);
444 // Execute the task and assume the worst: It is probably not reentrant.
445 nestable_tasks_allowed_ = false;
darin@google.combe165ae2008-09-07 17:08:29 +0900446
apatrick@chromium.org87164042011-05-20 07:28:25 +0900447 // Before running the task, store the program counter where it was posted
448 // and deliberately alias it to ensure it is on the stack if the task
449 // crashes. Be careful not to assume that the variable itself will have the
450 // expected value when displayed by the optimizer in an optimized build.
451 // Look at a memory dump of the stack.
jbates@chromium.orgb84db522011-10-04 02:51:25 +0900452 const void* program_counter =
453 pending_task.posted_from.program_counter();
apatrick@chromium.org87164042011-05-20 07:28:25 +0900454 base::debug::Alias(&program_counter);
455
darin@google.combe165ae2008-09-07 17:08:29 +0900456 HistogramEvent(kTaskRunEvent);
jar@chromium.org79a58c32011-10-16 08:52:45 +0900457
jar@chromium.orgb536eef2011-11-14 14:24:07 +0900458 tracked_objects::TrackedTime start_time =
jar@chromium.orgb5c974b2011-12-14 10:36:48 +0900459 tracked_objects::ThreadData::NowForStartOfRun(pending_task.birth_tally);
jar@chromium.org79a58c32011-10-16 08:52:45 +0900460
willchan@chromium.orga9047632010-06-10 06:20:41 +0900461 FOR_EACH_OBSERVER(TaskObserver, task_observers_,
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900462 WillProcessTask(pending_task.time_posted));
463 pending_task.task.Run();
464 FOR_EACH_OBSERVER(TaskObserver, task_observers_,
465 DidProcessTask(pending_task.time_posted));
jar@chromium.org4be2cb02011-11-01 07:36:21 +0900466
467 tracked_objects::ThreadData::TallyRunOnNamedThreadIfTracking(pending_task,
jar@chromium.orgb536eef2011-11-14 14:24:07 +0900468 start_time, tracked_objects::ThreadData::NowForEndOfRun());
darin@google.combe165ae2008-09-07 17:08:29 +0900469
470 nestable_tasks_allowed_ = true;
initial.commit3f4a7322008-07-27 06:49:38 +0900471}
472
jar@chromium.org79a58c32011-10-16 08:52:45 +0900473bool MessageLoop::DeferOrRunPendingTask(const PendingTask& pending_task) {
darin@google.combe165ae2008-09-07 17:08:29 +0900474 if (pending_task.nestable || state_->run_depth == 1) {
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900475 RunTask(pending_task);
darin@google.combe165ae2008-09-07 17:08:29 +0900476 // Show that we ran a task (Note: a new one might arrive as a
477 // consequence!).
478 return true;
479 }
480
481 // We couldn't run the task now because we're in a nested message loop
482 // and the task isn't nestable.
483 deferred_non_nestable_work_queue_.push(pending_task);
484 return false;
initial.commit3f4a7322008-07-27 06:49:38 +0900485}
486
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900487void MessageLoop::AddToDelayedWorkQueue(const PendingTask& pending_task) {
488 // Move to the delayed work queue. Initialize the sequence number
489 // before inserting into the delayed_work_queue_. The sequence number
490 // is used to faciliate FIFO sorting when two tasks have the same
491 // delayed_run_time value.
492 PendingTask new_pending_task(pending_task);
493 new_pending_task.sequence_num = next_sequence_num_++;
494 delayed_work_queue_.push(new_pending_task);
495}
496
initial.commit3f4a7322008-07-27 06:49:38 +0900497void MessageLoop::ReloadWorkQueue() {
498 // We can improve performance of our loading tasks from incoming_queue_ to
darin@google.com981f3552008-08-16 12:09:05 +0900499 // work_queue_ by waiting until the last minute (work_queue_ is empty) to
500 // load. That reduces the number of locks-per-task significantly when our
darin@google.combe165ae2008-09-07 17:08:29 +0900501 // queues get large.
502 if (!work_queue_.empty())
initial.commit3f4a7322008-07-27 06:49:38 +0900503 return; // Wait till we *really* need to lock and load.
504
505 // Acquire all we can from the inter-thread queue with one lock acquisition.
initial.commit3f4a7322008-07-27 06:49:38 +0900506 {
brettw@chromium.orgabe477a2011-01-21 13:55:52 +0900507 base::AutoLock lock(incoming_queue_lock_);
darin@google.combe165ae2008-09-07 17:08:29 +0900508 if (incoming_queue_.empty())
initial.commit3f4a7322008-07-27 06:49:38 +0900509 return;
darin@chromium.orgb80ef1a2009-09-03 05:05:21 +0900510 incoming_queue_.Swap(&work_queue_); // Constant time
darin@google.combe165ae2008-09-07 17:08:29 +0900511 DCHECK(incoming_queue_.empty());
initial.commit3f4a7322008-07-27 06:49:38 +0900512 }
513}
514
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900515bool MessageLoop::DeletePendingTasks() {
516 bool did_work = !work_queue_.empty();
517 while (!work_queue_.empty()) {
518 PendingTask pending_task = work_queue_.front();
519 work_queue_.pop();
520 if (!pending_task.delayed_run_time.is_null()) {
521 // We want to delete delayed tasks in the same order in which they would
522 // normally be deleted in case of any funny dependencies between delayed
523 // tasks.
524 AddToDelayedWorkQueue(pending_task);
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900525 }
initial.commit3f4a7322008-07-27 06:49:38 +0900526 }
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900527 did_work |= !deferred_non_nestable_work_queue_.empty();
528 while (!deferred_non_nestable_work_queue_.empty()) {
jar@chromium.org2fa6b4b2009-03-12 04:53:50 +0900529 deferred_non_nestable_work_queue_.pop();
initial.commit3f4a7322008-07-27 06:49:38 +0900530 }
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900531 did_work |= !delayed_work_queue_.empty();
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900532
533 // Historically, we always delete the task regardless of valgrind status. It's
534 // not completely clear why we want to leak them in the loops above. This
535 // code is replicating legacy behavior, and should not be considered
536 // absolutely "correct" behavior. See TODO above about deleting all tasks
537 // when it's safe.
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900538 while (!delayed_work_queue_.empty()) {
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900539 delayed_work_queue_.pop();
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900540 }
541 return did_work;
initial.commit3f4a7322008-07-27 06:49:38 +0900542}
543
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900544TimeTicks MessageLoop::CalculateDelayedRuntime(int64 delay_ms) {
545 TimeTicks delayed_run_time;
erg@google.com67a25432011-01-08 05:23:43 +0900546 if (delay_ms > 0) {
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900547 delayed_run_time =
erg@google.com67a25432011-01-08 05:23:43 +0900548 TimeTicks::Now() + TimeDelta::FromMilliseconds(delay_ms);
549
550#if defined(OS_WIN)
551 if (high_resolution_timer_expiration_.is_null()) {
552 // Windows timers are granular to 15.6ms. If we only set high-res
553 // timers for those under 15.6ms, then a 18ms timer ticks at ~32ms,
554 // which as a percentage is pretty inaccurate. So enable high
555 // res timers for any timer which is within 2x of the granularity.
556 // This is a tradeoff between accuracy and power management.
557 bool needs_high_res_timers =
558 delay_ms < (2 * base::Time::kMinLowResolutionThresholdMs);
559 if (needs_high_res_timers) {
mbelshe@chromium.orgbee85b32011-05-16 04:20:49 +0900560 if (base::Time::ActivateHighResolutionTimer(true)) {
561 high_resolution_timer_expiration_ = TimeTicks::Now() +
562 TimeDelta::FromMilliseconds(kHighResolutionTimerModeLeaseTimeMs);
563 }
erg@google.com67a25432011-01-08 05:23:43 +0900564 }
565 }
566#endif
567 } else {
568 DCHECK_EQ(delay_ms, 0) << "delay should not be negative";
569 }
570
571#if defined(OS_WIN)
572 if (!high_resolution_timer_expiration_.is_null()) {
573 if (TimeTicks::Now() > high_resolution_timer_expiration_) {
574 base::Time::ActivateHighResolutionTimer(false);
575 high_resolution_timer_expiration_ = TimeTicks();
576 }
577 }
578#endif
579
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900580 return delayed_run_time;
581}
582
583// Possibly called on a background thread!
584void MessageLoop::AddToIncomingQueue(PendingTask* pending_task) {
erg@google.com67a25432011-01-08 05:23:43 +0900585 // Warning: Don't try to short-circuit, and handle this thread's tasks more
586 // directly, as it could starve handling of foreign threads. Put every task
587 // into this queue.
588
589 scoped_refptr<base::MessagePump> pump;
590 {
brettw@chromium.orgabe477a2011-01-21 13:55:52 +0900591 base::AutoLock locked(incoming_queue_lock_);
erg@google.com67a25432011-01-08 05:23:43 +0900592
593 bool was_empty = incoming_queue_.empty();
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900594 incoming_queue_.push(*pending_task);
595 pending_task->task.Reset();
erg@google.com67a25432011-01-08 05:23:43 +0900596 if (!was_empty)
597 return; // Someone else should have started the sub-pump.
598
599 pump = pump_;
600 }
601 // Since the incoming_queue_ may contain a task that destroys this message
602 // loop, we cannot exit incoming_queue_lock_ until we are done with |this|.
603 // We use a stack-based reference to the message pump so that we can call
604 // ScheduleWork outside of incoming_queue_lock_.
605
606 pump->ScheduleWork();
607}
608
609//------------------------------------------------------------------------------
610// Method and data for histogramming events and actions taken by each instance
611// on each thread.
612
613void MessageLoop::StartHistogrammer() {
jar@chromium.org34571142011-04-05 13:48:53 +0900614 if (enable_histogrammer_ && !message_histogram_
erg@google.com67a25432011-01-08 05:23:43 +0900615 && base::StatisticsRecorder::IsActive()) {
616 DCHECK(!thread_name_.empty());
617 message_histogram_ = base::LinearHistogram::FactoryGet(
618 "MsgLoop:" + thread_name_,
619 kLeastNonZeroMessageId, kMaxMessageId,
620 kNumberOfDistinctMessagesDisplayed,
621 message_histogram_->kHexRangePrintingFlag);
622 message_histogram_->SetRangeDescriptions(event_descriptions_);
623 }
624}
625
626void MessageLoop::HistogramEvent(int event) {
jar@chromium.org34571142011-04-05 13:48:53 +0900627 if (message_histogram_)
erg@google.com67a25432011-01-08 05:23:43 +0900628 message_histogram_->Add(event);
629}
630
darin@google.com981f3552008-08-16 12:09:05 +0900631bool MessageLoop::DoWork() {
darin@google.combe165ae2008-09-07 17:08:29 +0900632 if (!nestable_tasks_allowed_) {
633 // Task can't be executed right now.
634 return false;
635 }
636
637 for (;;) {
638 ReloadWorkQueue();
639 if (work_queue_.empty())
640 break;
641
642 // Execute oldest task.
643 do {
644 PendingTask pending_task = work_queue_.front();
645 work_queue_.pop();
646 if (!pending_task.delayed_run_time.is_null()) {
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900647 AddToDelayedWorkQueue(pending_task);
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900648 // If we changed the topmost task, then it is time to reschedule.
649 if (delayed_work_queue_.top().task.Equals(pending_task.task))
darin@google.combe165ae2008-09-07 17:08:29 +0900650 pump_->ScheduleDelayedWork(pending_task.delayed_run_time);
651 } else {
652 if (DeferOrRunPendingTask(pending_task))
653 return true;
654 }
655 } while (!work_queue_.empty());
656 }
657
658 // Nothing happened.
659 return false;
darin@google.com981f3552008-08-16 12:09:05 +0900660}
661
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900662bool MessageLoop::DoDelayedWork(TimeTicks* next_delayed_work_time) {
jar@chromium.org40355072010-10-21 15:32:33 +0900663 if (!nestable_tasks_allowed_ || delayed_work_queue_.empty()) {
jar@chromium.org9b0fb062010-11-07 07:23:29 +0900664 recent_time_ = *next_delayed_work_time = TimeTicks();
darin@google.combe165ae2008-09-07 17:08:29 +0900665 return false;
666 }
jeremy@chromium.org2ed223c2008-12-09 02:36:06 +0900667
jar@chromium.org9b0fb062010-11-07 07:23:29 +0900668 // When we "fall behind," there will be a lot of tasks in the delayed work
jar@chromium.org94f73832010-11-05 08:23:42 +0900669 // queue that are ready to run. To increase efficiency when we fall behind,
670 // we will only call Time::Now() intermittently, and then process all tasks
671 // that are ready to run before calling it again. As a result, the more we
672 // fall behind (and have a lot of ready-to-run delayed tasks), the more
673 // efficient we'll be at handling the tasks.
jar@chromium.org9b0fb062010-11-07 07:23:29 +0900674
675 TimeTicks next_run_time = delayed_work_queue_.top().delayed_run_time;
jar@chromium.org94f73832010-11-05 08:23:42 +0900676 if (next_run_time > recent_time_) {
jar@chromium.org9b0fb062010-11-07 07:23:29 +0900677 recent_time_ = TimeTicks::Now(); // Get a better view of Now();
jar@chromium.org94f73832010-11-05 08:23:42 +0900678 if (next_run_time > recent_time_) {
679 *next_delayed_work_time = next_run_time;
680 return false;
681 }
darin@google.combe165ae2008-09-07 17:08:29 +0900682 }
darin@google.com981f3552008-08-16 12:09:05 +0900683
jar@chromium.org40355072010-10-21 15:32:33 +0900684 PendingTask pending_task = delayed_work_queue_.top();
685 delayed_work_queue_.pop();
jeremy@chromium.org2ed223c2008-12-09 02:36:06 +0900686
jar@chromium.org40355072010-10-21 15:32:33 +0900687 if (!delayed_work_queue_.empty())
darin@google.combe165ae2008-09-07 17:08:29 +0900688 *next_delayed_work_time = delayed_work_queue_.top().delayed_run_time;
darin@google.com981f3552008-08-16 12:09:05 +0900689
darin@google.combe165ae2008-09-07 17:08:29 +0900690 return DeferOrRunPendingTask(pending_task);
darin@google.com981f3552008-08-16 12:09:05 +0900691}
692
693bool MessageLoop::DoIdleWork() {
694 if (ProcessNextDelayedNonNestableTask())
695 return true;
696
697 if (state_->quit_received)
698 pump_->Quit();
699
700 return false;
701}
702
dcheng@chromium.org36904742011-12-30 13:32:58 +0900703void MessageLoop::DeleteSoonInternal(const tracked_objects::Location& from_here,
704 void(*deleter)(const void*),
705 const void* object) {
706 PostNonNestableTask(from_here, base::Bind(deleter, object));
707}
708
dcheng@chromium.org2116fc92011-12-30 15:46:30 +0900709void MessageLoop::ReleaseSoonInternal(
710 const tracked_objects::Location& from_here,
711 void(*releaser)(const void*),
712 const void* object) {
713 PostNonNestableTask(from_here, base::Bind(releaser, object));
714}
715
darin@google.com981f3552008-08-16 12:09:05 +0900716//------------------------------------------------------------------------------
717// MessageLoop::AutoRunState
718
719MessageLoop::AutoRunState::AutoRunState(MessageLoop* loop) : loop_(loop) {
720 // Make the loop reference us.
721 previous_state_ = loop_->state_;
722 if (previous_state_) {
723 run_depth = previous_state_->run_depth + 1;
darin@google.com6ddeb842008-08-15 16:31:20 +0900724 } else {
darin@google.com981f3552008-08-16 12:09:05 +0900725 run_depth = 1;
darin@google.com6ddeb842008-08-15 16:31:20 +0900726 }
darin@google.com981f3552008-08-16 12:09:05 +0900727 loop_->state_ = this;
728
729 // Initialize the other fields:
730 quit_received = false;
michaelbai@google.com686190b2011-08-03 01:11:16 +0900731#if !defined(OS_MACOSX) && !defined(OS_ANDROID)
darin@google.com981f3552008-08-16 12:09:05 +0900732 dispatcher = NULL;
733#endif
734}
735
736MessageLoop::AutoRunState::~AutoRunState() {
737 loop_->state_ = previous_state_;
darin@google.comee6fa722008-08-13 08:25:43 +0900738}
739
initial.commit3f4a7322008-07-27 06:49:38 +0900740//------------------------------------------------------------------------------
darin@google.comd936b5b2008-08-26 14:53:57 +0900741// MessageLoopForUI
742
743#if defined(OS_WIN)
darin@google.comd936b5b2008-08-26 14:53:57 +0900744void MessageLoopForUI::DidProcessMessage(const MSG& message) {
745 pump_win()->DidProcessMessage(message);
746}
darin@google.comd936b5b2008-08-26 14:53:57 +0900747#endif // defined(OS_WIN)
748
michaelbai@google.com686190b2011-08-03 01:11:16 +0900749#if defined(OS_ANDROID)
750void MessageLoopForUI::Start() {
751 // No Histogram support for UI message loop as it is managed by Java side
752 static_cast<base::MessagePumpForUI*>(pump_.get())->Start(this);
753}
754#endif
755
756#if !defined(OS_MACOSX) && !defined(OS_NACL) && !defined(OS_ANDROID)
jcampan@chromium.org05423582009-08-01 07:53:37 +0900757void MessageLoopForUI::AddObserver(Observer* observer) {
758 pump_ui()->AddObserver(observer);
759}
760
761void MessageLoopForUI::RemoveObserver(Observer* observer) {
762 pump_ui()->RemoveObserver(observer);
763}
764
oshima@google.com08ff65e2011-10-24 16:19:51 +0900765void MessageLoopForUI::RunWithDispatcher(Dispatcher* dispatcher) {
jcampan@chromium.org05423582009-08-01 07:53:37 +0900766 AutoRunState save_state(this);
767 state_->dispatcher = dispatcher;
768 RunHandler();
769}
oshima@google.comc7bc27c2011-10-07 03:19:21 +0900770
771void MessageLoopForUI::RunAllPendingWithDispatcher(Dispatcher* dispatcher) {
772 AutoRunState save_state(this);
773 state_->dispatcher = dispatcher;
774 state_->quit_received = true; // Means run until we would otherwise block.
775 RunHandler();
776}
777
michaelbai@google.com686190b2011-08-03 01:11:16 +0900778#endif // !defined(OS_MACOSX) && !defined(OS_NACL) && !defined(OS_ANDROID)
jcampan@chromium.org05423582009-08-01 07:53:37 +0900779
darin@google.comd936b5b2008-08-26 14:53:57 +0900780//------------------------------------------------------------------------------
781// MessageLoopForIO
782
783#if defined(OS_WIN)
784
rvargas@google.com9e49aa22008-10-10 08:58:43 +0900785void MessageLoopForIO::RegisterIOHandler(HANDLE file, IOHandler* handler) {
786 pump_io()->RegisterIOHandler(file, handler);
787}
788
rvargas@google.com73887542008-11-08 06:52:15 +0900789bool MessageLoopForIO::WaitForIOCompletion(DWORD timeout, IOHandler* filter) {
790 return pump_io()->WaitForIOCompletion(timeout, filter);
rvargas@google.com9e49aa22008-10-10 08:58:43 +0900791}
792
abarth@chromium.org1f1c2172010-12-01 17:45:51 +0900793#elif defined(OS_POSIX) && !defined(OS_NACL)
dkegel@google.com9e044ae2008-09-19 03:46:26 +0900794
jeremy@chromium.orgefc0db02008-12-16 07:02:17 +0900795bool MessageLoopForIO::WatchFileDescriptor(int fd,
796 bool persistent,
797 Mode mode,
798 FileDescriptorWatcher *controller,
799 Watcher *delegate) {
800 return pump_libevent()->WatchFileDescriptor(
801 fd,
802 persistent,
803 static_cast<base::MessagePumpLibevent::Mode>(mode),
804 controller,
805 delegate);
dkegel@google.com9e044ae2008-09-19 03:46:26 +0900806}
807
dkegel@google.com9e044ae2008-09-19 03:46:26 +0900808#endif