platform_thread_win.cc revision 5821806d5e7f356e8fa4b058a389a808ea183019
15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/threading/platform_thread.h" 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/debug/alias.h" 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/debug/profiler.h" 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/logging.h" 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/threading/thread_local.h" 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/threading/thread_restrictions.h" 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/tracked_objects.h" 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/win/windows_version.h" 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace base { 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace { 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)static ThreadLocalPointer<char> current_thread_name; 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// The information on how to set the thread name comes from 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// a MSDN article: http://msdn2.microsoft.com/en-us/library/xcb2z8hs.aspx 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const DWORD kVCThreadNameException = 0x406D1388; 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct tagTHREADNAME_INFO { 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DWORD dwType; // Must be 0x1000. 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LPCSTR szName; // Pointer to name (in user addr space). 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DWORD dwThreadID; // Thread ID (-1=caller thread). 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DWORD dwFlags; // Reserved for future use, must be zero. 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} THREADNAME_INFO; 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This function has try handling, so it is separated out of its caller. 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void SetNameInternal(PlatformThreadId thread_id, const char* name) { 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) THREADNAME_INFO info; 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) info.dwType = 0x1000; 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) info.szName = name; 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) info.dwThreadID = thread_id; 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) info.dwFlags = 0; 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) __try { 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) RaiseException(kVCThreadNameException, 0, sizeof(info)/sizeof(DWORD), 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) reinterpret_cast<DWORD_PTR*>(&info)); 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } __except(EXCEPTION_CONTINUE_EXECUTION) { 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct ThreadParams { 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PlatformThread::Delegate* delegate; 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool joinable; 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)DWORD __stdcall ThreadFunc(void* params) { 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ThreadParams* thread_params = static_cast<ThreadParams*>(params); 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PlatformThread::Delegate* delegate = thread_params->delegate; 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (!thread_params->joinable) 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::ThreadRestrictions::SetSingletonAllowed(false); 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) delete thread_params; 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) delegate->ThreadMain(); 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return NULL; 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// CreateThreadInternal() matches PlatformThread::Create(), except that 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// |out_thread_handle| may be NULL, in which case a non-joinable thread is 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// created. 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)bool CreateThreadInternal(size_t stack_size, 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PlatformThread::Delegate* delegate, 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PlatformThreadHandle* out_thread_handle) { 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PlatformThreadHandle thread_handle; 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int flags = 0; 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (stack_size > 0 && base::win::GetVersion() >= base::win::VERSION_XP) { 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) flags = STACK_SIZE_PARAM_IS_A_RESERVATION; 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } else { 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) stack_size = 0; 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ThreadParams* params = new ThreadParams; 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) params->delegate = delegate; 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) params->joinable = out_thread_handle != NULL; 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Using CreateThread here vs _beginthreadex makes thread creation a bit 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // faster and doesn't require the loader lock to be available. Our code will 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // have to work running on CreateThread() threads anyway, since we run code 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // on the Windows thread pool, etc. For some background on the difference: 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // http://www.microsoft.com/msj/1099/win32/win321099.aspx 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) thread_handle = CreateThread( 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NULL, stack_size, ThreadFunc, params, flags, NULL); 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (!thread_handle) { 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) delete params; 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return false; 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (out_thread_handle) 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *out_thread_handle = thread_handle; 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) else 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CloseHandle(thread_handle); 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return true; 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)PlatformThreadId PlatformThread::CurrentId() { 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return GetCurrentThreadId(); 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void PlatformThread::YieldCurrentThread() { 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ::Sleep(0); 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void PlatformThread::Sleep(TimeDelta duration) { 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ::Sleep(duration.InMillisecondsRoundedUp()); 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void PlatformThread::SetName(const char* name) { 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) current_thread_name.Set(const_cast<char*>(name)); 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // On Windows only, we don't need to tell the profiler about the "BrokerEvent" 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // thread, as it exists only in the chrome.exe image, and never spawns or runs 1235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // tasks (items which could be profiled). This test avoids the notification, 1245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // which would also (as a side effect) initialize the profiler in this unused 1255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // context, including setting up thread local storage, etc. The performance 1265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // impact is not terrible, but there is no reason to do initialize it. 1275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (0 != strcmp(name, "BrokerEvent")) 1285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) tracked_objects::ThreadData::InitializeThreadContext(name); 1295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The debugger needs to be around to catch the name in the exception. If 1315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // there isn't a debugger, we are just needlessly throwing an exception. 1325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // If this image file is instrumented, we raise the exception anyway 1335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // to provide the profiler with human-readable thread names. 1345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (!::IsDebuggerPresent() && !base::debug::IsBinaryInstrumented()) 1355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return; 1365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SetNameInternal(CurrentId(), name); 1385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 1415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const char* PlatformThread::GetName() { 1425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return current_thread_name.Get(); 1435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 1465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)bool PlatformThread::Create(size_t stack_size, Delegate* delegate, 1475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PlatformThreadHandle* thread_handle) { 1485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_handle); 1495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return CreateThreadInternal(stack_size, delegate, thread_handle); 1505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 1535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)bool PlatformThread::CreateWithPriority(size_t stack_size, Delegate* delegate, 1545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PlatformThreadHandle* thread_handle, 1555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ThreadPriority priority) { 1565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool result = Create(stack_size, delegate, thread_handle); 1575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (result) 1585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SetThreadPriority(*thread_handle, priority); 1595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return result; 1605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 1635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)bool PlatformThread::CreateNonJoinable(size_t stack_size, Delegate* delegate) { 1645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return CreateThreadInternal(stack_size, delegate, NULL); 1655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 1685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void PlatformThread::Join(PlatformThreadHandle thread_handle) { 1695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_handle); 1705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // TODO(willchan): Enable this check once I can get it to work for Windows 1715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // shutdown. 1725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Joining another thread may block the current thread for a long time, since 1735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the thread referred to by |thread_handle| may still be running long-lived / 1745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // blocking tasks. 1755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#if 0 1765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::ThreadRestrictions::AssertIOAllowed(); 1775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 1785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Wait for the thread to exit. It should already have terminated but make 1805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // sure this assumption is valid. 1815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DWORD result = WaitForSingleObject(thread_handle, INFINITE); 1825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (result != WAIT_OBJECT_0) { 1835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Debug info for bug 127931. 1845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DWORD error = GetLastError(); 1855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) debug::Alias(&error); 1865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) debug::Alias(&result); 1875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) debug::Alias(&thread_handle); 1885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CHECK(false); 1895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CloseHandle(thread_handle); 1925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 1955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void PlatformThread::SetThreadPriority(PlatformThreadHandle handle, 1965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ThreadPriority priority) { 1975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) switch (priority) { 1985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) case kThreadPriority_Normal: 1995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ::SetThreadPriority(handle, THREAD_PRIORITY_NORMAL); 2005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) break; 2015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) case kThreadPriority_RealtimeAudio: 2025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ::SetThreadPriority(handle, THREAD_PRIORITY_TIME_CRITICAL); 2035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) break; 2045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 2055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 2065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace base 208