source: downloads/boost_1_34_1/libs/thread/doc/implementation_notes.xml @ 35

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE library PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN"
  "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd" [
  <!ENTITY % thread.entities SYSTEM "entities.xml">
  %thread.entities;
]>
<!-- Copyright (c) 2002-2003 William E. Kempf, Michael Glassford
     Subject to the Boost Software License, Version 1.0. 
     (See accompanying file LICENSE-1.0 or  http://www.boost.org/LICENSE-1.0)
-->
<section id="thread.implementation_notes" last-revision="$Date: 2006/10/15 14:52:53 $">
        <title>Implementation Notes</title>
        <section id="thread.implementation_notes.win32">
                <title>Win32</title>
                <para>
                        In the current Win32 implementation, creating a boost::thread object
                        during dll initialization will result in deadlock because the thread 
                        class constructor causes the current thread to wait on the thread that 
                        is being created until it signals that it has finished its initialization, 
                        and, as stated in the
                        <ulink url="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dllproc/base/dllmain.asp">MSDN Library, "DllMain" article, "Remarks" section</ulink>,
                        "Because DLL notifications are serialized, entry-point functions should not
                        attempt to communicate with other threads or processes. Deadlocks may occur as a result."
                        (Also see <ulink url="http://www.microsoft.com/msj/archive/S220.aspx">"Under the Hood", January 1996</ulink> 
                        for a more detailed discussion of this issue).
                </para>
                <para>
                        The following non-exhaustive list details some of the situations that
                        should be avoided until this issue can be addressed:
                        <itemizedlist>
                                <listitem>Creating a boost::thread object in DllMain() or in any function called by it.</listitem>
                                <listitem>Creating a boost::thread object in the constructor of a global static object or in any function called by one.</listitem>
                                <listitem>Creating a boost::thread object in MFC's CWinApp::InitInstance() function or in any function called by it.</listitem>
                                <listitem>Creating a boost::thread object in the function pointed to by MFC's _pRawDllMain function pointer or in any function called by it.</listitem>
                        </itemizedlist>
                </para>
        </section>
</section>