xref: /aosp_15_r20/external/pigweed/pw_thread_stl/docs.rst (revision 61c4878ac05f98d0ceed94b57d316916de578985)
1.. _module-pw_thread_stl:
2
3=============
4pw_thread_stl
5=============
6This is a set of backends for pw_thread based on the C++ STL.
7
8-------------------
9Compatibility notes
10-------------------
11Windows
12=======
13* `b/317922402 <https://issues.pigweed.dev/317922402>`_\:
14  ``pw::Thread::detach()`` can cause indefinite hangs on Windows targets. For
15  now, this functionality has been disabled. Attempting to detach a thread on
16  Windows will cause the following link-time error to be emitted:
17
18  .. code-block::
19
20     ld.exe: pw_strict_host_gcc_debug/obj/pw_thread/test_thread_context_facade_test.lib.test_thread_context_facade_test.cc.o: in function `pw::Thread::detach()':
21     pw_thread_stl/public/pw_thread_stl/thread_inline.h:55: undefined reference to `pw::thread::internal::ErrorAttemptedToInvokeStdThreadDetachOnMinGW()'
22