Thread creation features. More...

Detailed Description

Thread creation features.

Note: Do not include this header file directly, but pthread.h.

Definition in file pthread_threading.h.

#include "kernel_defines.h"

Include dependency graph for pthread_threading.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

typedef unsigned	pthread_t
	Datatype to identify a POSIX thread. More...

int	pthread_create (pthread_t newthread, const pthread_attr_t attr, void (start_routine)(void ), void arg)
	Spawn a new POSIX thread. More...

void	pthread_exit (void *retval) NORETURN
	Exit calling pthread. More...

int	pthread_join (pthread_t th, void **thread_return)
	Join a pthread. More...

int	pthread_detach (pthread_t th)
	Make a pthread unjoinable. More...

pthread_t	pthread_self (void)
	Returns the pthread id of the calling/current thread. More...

static int	pthread_equal (pthread_t thread1, pthread_t thread2)
	Compared two pthread identifiers. More...

Typedef Documentation

◆ pthread_t

typedef unsigned pthread_t

Datatype to identify a POSIX thread.

Note: The pthread ids are one off to the index in the internal array.

Definition at line 29 of file pthread_threading.h.

Function Documentation

◆ pthread_create()

int pthread_create	(	pthread_t *	newthread,
		const pthread_attr_t *	attr,
		void ()(void *)	start_routine,
		void *	arg
	)

Spawn a new POSIX thread.

This functions starts a new thread. The thread will be joinable (from another pthread), unless attr tells to create the thread detached. A non-detached thread must be joined will stay a zombie into it is joined. You can call pthread_exit() inside the thread, or return from start_routine().

Note: Cancellation is currently not implemented.; In an embedded system you probably want to supply a statically allocated stack in attr.

Parameters

[out]	newthread	The identifier of the new thread.
[in]	attr	An attribute set that describes how the new thread should be started.
[in]	start_routine	The entry point of the new thread.
[in]	arg	Argument supplied to `start_routine`.

Returns: == 0 on success. != 0 on error.

◆ pthread_detach()

int pthread_detach ( pthread_t th )

Make a pthread unjoinable.

The resources of a detached thread get released as soon as it exits, without the need to call pthread_join() out of another pthread. In fact you cannot join a detached thread, it will return an error. Detaching a thread while another thread tries to join it causes undefined behavior. A pthread may detach himself. A non-pthread may call this function, too. A pthread cannot be "attached" again.

Parameters

[in] th pthread to detach.

Returns: == 0 on success. != 0 on error.

◆ pthread_equal()

static int pthread_equal	(	pthread_t	thread1,
		pthread_t	thread2
	)

inlinestatic

Compared two pthread identifiers.

Returns: 0 if the ids identify two different threads.

Definition at line 99 of file pthread_threading.h.

◆ pthread_exit()

void pthread_exit ( void * retval )

Exit calling pthread.

Note: Only pthreads must call this function. Native threads must call sched_thread_exit(). A pthread must not call sched_thread_exit().

Parameters

[out] retval Return value, supplied to a joining thread.

◆ pthread_join()

int pthread_join	(	pthread_t	th,
		void **	thread_return
	)

Join a pthread.

The current thread sleeps until th exits. The exit value of th gets written into thread_return. You can only join pthreads, and only pthreads can join. A thread must not join itself.

Parameters

[in]	th	pthread to join, the id was supplied by pthread_create()
[out]	thread_return	Exit code of `th`.

Returns: == 0 on success. != 0 on error.

◆ pthread_self()

pthread_t pthread_self ( void )

Returns the pthread id of the calling/current thread.

Note: This function should not be used to determine if the calling thread is a pthread. If your logic is sane then there should be no need to do that.

Returns: > 0 identifies the calling pthread. == 0 if the calling thread is not a pthread.