THRD_CREATE(3C) Standard C Library Functions THRD_CREATE(3C)

thrd_createcreate a thread

#include <threads.h>

typedef int (*thrd_start_t)(void *);

int
thrd_create(thrd_t *thrdp, thrd_start_t func, void *arg);

The () function creates a new thread of execution inside of the current process and stores its identifier in thrdp. Each thread operates concurrently within the process.

When a thread is created, it begins its execution at the function func with the argument arg. A created thread has access to all global data within a process; however, it has its own private stack. Currently 32-bit processes have a default stack of 1 megabyte, while 64-bit systems have a default stack size of 2 megabytes. In addition, newly created threads inherit the signal mask of the thread which created them; however, they do not inherit any pending signals.

Once created, a thread will continue to execute until either, it returns from its initial function, the thread explicitly calls thrd_exit(3C), or the process itself terminates, such as with a call to exit(2). When the initial function returns, it behaves as though a call to thrd_exit(3C) was made, and, if the thread has not been detached with a call to thrd_detach(3C), the exit status remains available and the corresponding thread ID will not be reused until a process calls thrd_join(3C). This is similar to how a parent must call wait(3C), to clean up a child process that has terminated.

For a richer interface interface with more control over aspects of the newly created thread, such as stack size, stack placement, and the like, see thr_create(3C) and pthread_create(3C).

Upon successful completion, the thrd_create() function returns . If insufficient memory was available, then is returned. Otherwise, is returned, indicating that a non-memory related error.

pthread_create(3C), thr_create(3C), thrd_detach(3C), thrd_join(3C), attributes(7), threads(7)

January 13, 2015 OmniOS