]>
Commit | Line | Data |
---|---|---|
1 | /* | |
2 | * Copyright (C) 2007, 2008, 2010 Apple Inc. All rights reserved. | |
3 | * Copyright (C) 2007 Justin Haygood (jhaygood@reaktix.com) | |
4 | * | |
5 | * Redistribution and use in source and binary forms, with or without | |
6 | * modification, are permitted provided that the following conditions | |
7 | * are met: | |
8 | * | |
9 | * 1. Redistributions of source code must retain the above copyright | |
10 | * notice, this list of conditions and the following disclaimer. | |
11 | * 2. Redistributions in binary form must reproduce the above copyright | |
12 | * notice, this list of conditions and the following disclaimer in the | |
13 | * documentation and/or other materials provided with the distribution. | |
14 | * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of | |
15 | * its contributors may be used to endorse or promote products derived | |
16 | * from this software without specific prior written permission. | |
17 | * | |
18 | * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY | |
19 | * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED | |
20 | * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | |
21 | * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY | |
22 | * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
23 | * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
24 | * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
25 | * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
26 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | |
27 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
28 | */ | |
29 | ||
30 | #ifndef MainThread_h | |
31 | #define MainThread_h | |
32 | ||
33 | #include <stdint.h> | |
34 | ||
35 | namespace WTF { | |
36 | ||
37 | typedef uint32_t ThreadIdentifier; | |
38 | typedef void MainThreadFunction(void*); | |
39 | ||
40 | // Must be called from the main thread. | |
41 | void initializeMainThread(); | |
42 | ||
43 | void callOnMainThread(MainThreadFunction*, void* context); | |
44 | void callOnMainThreadAndWait(MainThreadFunction*, void* context); | |
45 | void cancelCallOnMainThread(MainThreadFunction*, void* context); | |
46 | ||
47 | void setMainThreadCallbacksPaused(bool paused); | |
48 | ||
49 | bool isMainThread(); | |
50 | bool isWebThread(); | |
51 | ||
52 | // NOTE: these functions are internal to the callOnMainThread implementation. | |
53 | void initializeMainThreadPlatform(); | |
54 | void scheduleDispatchFunctionsOnMainThread(); | |
55 | void dispatchFunctionsFromMainThread(); | |
56 | ||
57 | #if PLATFORM(MAC) | |
58 | // This version of initializeMainThread sets up the main thread as corresponding | |
59 | // to the process's main thread, and not necessarily the thread that calls this | |
60 | // function. It should only be used as a legacy aid for Mac WebKit. | |
61 | void initializeMainThreadToProcessMainThread(); | |
62 | void initializeMainThreadToProcessMainThreadPlatform(); | |
63 | #endif | |
64 | ||
65 | } // namespace WTF | |
66 | ||
67 | using WTF::callOnMainThread; | |
68 | using WTF::callOnMainThreadAndWait; | |
69 | using WTF::cancelCallOnMainThread; | |
70 | using WTF::setMainThreadCallbacksPaused; | |
71 | using WTF::isMainThread; | |
72 | #endif // MainThread_h |