core.thread.osthread

The osthread module provides low-level, OS-dependent code for thread creation and management.

Members

Aliases

getpid
alias getpid = core.sys.posix.unistd.getpid

Returns the process ID of the calling process, which is guaranteed to be unique on the system. This call is always successful.

Classes

Thread
class Thread

This class encapsulates all threading functionality for the D programming language. As thread manipulation is a required facility for garbage collection, all user threads should derive from this class, and instances of this class should never be explicitly deleted. A new thread may be created using either derivation or composition, as in the following example.

Functions

createLowLevelThread
ThreadID createLowLevelThread(void delegate() nothrow dg, uint stacksize, void delegate() nothrow cbDllUnload)

Create a thread not under control of the runtime, i.e. TLS module constructors are not run and the GC does not suspend it during a collection.

joinLowLevelThread
void joinLowLevelThread(ThreadID tid)

Wait for a thread created with createLowLevelThread to terminate.

thread_attachByAddr
Thread thread_attachByAddr(ThreadID addr)
thread_attachByAddrB
Thread thread_attachByAddrB(ThreadID addr, void* bstack)

Registers the calling thread for use with the D Runtime. If this routine is called for a thread which is already registered, no action is performed.

thread_attachThis
Thread thread_attachThis()

Registers the calling thread for use with the D Runtime. If this routine is called for a thread which is already registered, no action is performed.

thread_init
void thread_init()

Initializes the thread module. This function must be called by the garbage collector on startup and before any other thread routines are called.

thread_setGCSignals
void thread_setGCSignals(int suspendSignalNo, int resumeSignalNo)

Instruct the thread module, when initialized, to use a different set of signals besides SIGRTMIN and SIGRTMIN + 1 for suspension and resumption of threads. This function should be called at most once, prior to thread_init(). This function is Posix-only.

thread_suspendAll
void thread_suspendAll()

Suspend all threads but the calling thread for "stop the world" garbage collection runs. This function may be called multiple times, and must be followed by a matching number of calls to thread_resumeAll before processing is resumed.

thread_term
void thread_term()

Terminates the thread module. No other thread routine may be called afterwards.

Static variables

thread_DLLProcessDetaching
bool thread_DLLProcessDetaching;

set during termination of a DLL on Windows, i.e. while executing DllMain(DLL_PROCESS_DETACH)

Meta

License

Distributed under the Boost Software License 1.0. (See accompanying file LICENSE)

Authors

Sean Kelly, Walter Bright, Alex Rønne Petersen, Martin Nowak