wtf/Threading.cpp

   1 /*
   2  * Copyright (C) 2008, 2009 Apple Inc. All rights reserved.
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions
   6  * are met:
   7  *
   8  * 1.  Redistributions of source code must retain the above copyright
   9  *     notice, this list of conditions and the following disclaimer.
  10  * 2.  Redistributions in binary form must reproduce the above copyright
  11  *     notice, this list of conditions and the following disclaimer in the
  12  *     documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
  15  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  16  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  17  * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
  18  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  19  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  20  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  21  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  23  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  24  */
  25
  26 #include "config.h"
  27 #include "Threading.h"
  28
  29 #include <string.h>
  30
  31 namespace WTF {
  32
  33 struct NewThreadContext {
  34     WTF_MAKE_FAST_ALLOCATED;
  35 public:
  36     NewThreadContext(ThreadFunction entryPoint, void* data, const char* name)
  37         : entryPoint(entryPoint)
  38         , data(data)
  39         , name(name)
  40     {
  41     }
  42
  43     ThreadFunction entryPoint;
  44     void* data;
  45     const char* name;
  46
  47     Mutex creationMutex;
  48 };
  49
  50 static void* threadEntryPoint(void* contextData)
  51 {
  52     NewThreadContext* context = reinterpret_cast<NewThreadContext*>(contextData);
  53
  54     // Block until our creating thread has completed any extra setup work, including
  55     // establishing ThreadIdentifier.
  56     {
  57         MutexLocker locker(context->creationMutex);
  58     }
  59
  60     initializeCurrentThreadInternal(context->name);
  61
  62     // Grab the info that we need out of the context, then deallocate it.
  63     ThreadFunction entryPoint = context->entryPoint;
  64     void* data = context->data;
  65     delete context;
  66
  67     return entryPoint(data);
  68 }
  69
  70 ThreadIdentifier createThread(ThreadFunction entryPoint, void* data, const char* name)
  71 {
  72     // Visual Studio has a 31-character limit on thread names. Longer names will
  73     // be truncated silently, but we'd like callers to know about the limit.
  74 #if !LOG_DISABLED
  75     if (strlen(name) > 31)
  76         LOG_ERROR("Thread name \"%s\" is longer than 31 characters and will be truncated by Visual Studio", name);
  77 #endif
  78
  79     NewThreadContext* context = new NewThreadContext(entryPoint, data, name);
  80
  81     // Prevent the thread body from executing until we've established the thread identifier.
  82     MutexLocker locker(context->creationMutex);
  83
  84     return createThreadInternal(threadEntryPoint, context, name);
  85 }
  86
  87 #if PLATFORM(MAC) || PLATFORM(WIN)
  88
  89 // This function is deprecated but needs to be kept around for backward
  90 // compatibility. Use the 3-argument version of createThread above.
  91
  92 ThreadIdentifier createThread(ThreadFunction entryPoint, void* data);
  93
  94 ThreadIdentifier createThread(ThreadFunction entryPoint, void* data)
  95 {
  96     return createThread(entryPoint, data, 0);
  97 }
  98 #endif
  99
 100 } // namespace WTF