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 51 // NOTE: these functions are internal to the callOnMainThread implementation. 52 void initializeMainThreadPlatform(); 53 void scheduleDispatchFunctionsOnMainThread(); 54 void dispatchFunctionsFromMainThread(); 55 56 #if PLATFORM(MAC) 57 // This version of initializeMainThread sets up the main thread as corresponding 58 // to the process's main thread, and not necessarily the thread that calls this 59 // function. It should only be used as a legacy aid for Mac WebKit. 60 void initializeMainThreadToProcessMainThread(); 61 void initializeMainThreadToProcessMainThreadPlatform(); 62 #endif 63 64 } // namespace WTF 65 66 using WTF::callOnMainThread; 67 using WTF::callOnMainThreadAndWait; 68 using WTF::cancelCallOnMainThread; 69 using WTF::setMainThreadCallbacksPaused; 70 using WTF::isMainThread; 71 #endif // MainThread_h 72