threads_arch.c File Reference

#include "modules/core/threads.h"
#include "modules/core/threads_arch.h"
#include "stdbool.h"
#include <semaphore.h>
#include <stdlib.h>
#include <time.h>

Include dependency graph for threads_arch.c:

Go to the source code of this file.

Data Structures
struct	stub_arg

Functions
int	pprz_mtx_init (pprz_mutex_t *mtx)
int	pprz_mtx_lock (pprz_mutex_t *mtx)
int	pprz_mtx_trylock (pprz_mutex_t *mtx)
	Performs a nonblocking lock on the mutex.
int	pprz_mtx_unlock (pprz_mutex_t *mtx)
void	pprz_bsem_init (pprz_bsem_t *bsem, bool taken)
void	pprz_bsem_wait (pprz_bsem_t *bsem)
int	pprz_bsem_wait_timeout (pprz_bsem_t *bsem, float timeout)
	Wait on semaphore no more than timeout.
void	pprz_bsem_signal (pprz_bsem_t *bsem)
static void *	stub (void *arg)
int	pprz_thread_create (pprz_thread_t *thread, size_t size, const char *name, uint8_t prio, void(*func)(void *), void *arg)
	Creates a new thread whose stack is dynamically allocated.
void	pprz_thread_exit (void *retval)
	Exit the current thread.
int	pprz_thread_join (pprz_thread_t *thread, void **retval)
	Wait for the thread to terminate.
int	pprz_thread_tryjoin (pprz_thread_t *thread, void **retval)
	Performs a nonblocking join with the thread.

Function Documentation

pprz_bsem_init()

void pprz_bsem_init	(	pprz_bsem_t *	bsem,
		bool	taken
	)

Definition at line 39 of file threads_arch.c.

References bsem, foo, pprzBSem::mtx, and pprzBSem::sem.

pprz_bsem_signal()

void pprz_bsem_signal

(

pprz_bsem_t *

bsem

)

Definition at line 58 of file threads_arch.c.

References bsem, foo, pprzBSem::mtx, pprzBSem::sem, and val.

pprz_bsem_wait()

void pprz_bsem_wait

(

pprz_bsem_t *

bsem

)

Definition at line 44 of file threads_arch.c.

References bsem, foo, and pprzBSem::sem.

pprz_bsem_wait_timeout()

int pprz_bsem_wait_timeout	(	pprz_bsem_t *	bsem,
		float	timeout
	)

Wait on semaphore no more than timeout.

Parameters

timeout

in seconds

Returns

0 on success

Definition at line 48 of file threads_arch.c.

References bsem, foo, pprzBSem::sem, and timeout.

pprz_mtx_init()

int pprz_mtx_init

(

pprz_mutex_t *

mtx

)

Definition at line 21 of file threads_arch.c.

References foo, pprzMutex::mtx, and mtx.

pprz_mtx_lock()

int pprz_mtx_lock

(

pprz_mutex_t *

mtx

)

Definition at line 25 of file threads_arch.c.

References foo, pprzMutex::mtx, and mtx.

pprz_mtx_trylock()

int pprz_mtx_trylock

(

pprz_mutex_t *

mtx

)

Performs a nonblocking lock on the mutex.

Returns

0 if successful

Definition at line 29 of file threads_arch.c.

References foo, pprzMutex::mtx, and mtx.

pprz_mtx_unlock()

int pprz_mtx_unlock

(

pprz_mutex_t *

mtx

)

Definition at line 33 of file threads_arch.c.

References foo, pprzMutex::mtx, and mtx.

pprz_thread_create()

int pprz_thread_create	(	pprz_thread_t *	thread,
		size_t	size,
		const char *	name,
		uint8_t	prio,
		void(*)(void *)	func,
		void *	arg
	)

Creates a new thread whose stack is dynamically allocated.

Parameters

[in]	size	size of the stack. Unused on linux at the moment.
[in]	prio	the priority level for the new thread. Unused on linux at the moment. NORMALPRIO
[in]	pf	the thread function
[in]	arg	an argument passed to the thread function. It can be NULL.
[out]	thread	pointer to a pprz_thread_t that will be writen with the handle to the thread

Returns

Return 0 on success, or a platform dependant error code.

@api

Definition at line 86 of file threads_arch.c.

References stub_arg::arg, foo, stub_arg::func, and stub().

Here is the call graph for this function:

pprz_thread_exit()

void pprz_thread_exit

(

void *

retval

)

Exit the current thread.

Parameters

[out]

retval

The thread's return value

Definition at line 97 of file threads_arch.c.

References foo.

pprz_thread_join()

int pprz_thread_join	(	pprz_thread_t *	thread,
		void **	retval
	)

Wait for the thread to terminate.

Note

Warning ! This is a blocking function, do not use it in the main AP thread !

Parameters

[in]	thread	The thread to be joined
[out]	retval	The thread's return value will be written to the variable pointed by retval

Definition at line 101 of file threads_arch.c.

References foo.

pprz_thread_tryjoin()

int pprz_thread_tryjoin	(	pprz_thread_t *	thread,
		void **	retval
	)

Performs a nonblocking join with the thread.

Parameters

[in]	thread	The thread to be joined
[out]	retval	The thread's return value will be written to the variable pointed by retval. must not be used if this fuction did not returned 0.

Returns

0 if the thread successfully joined.

Definition at line 105 of file threads_arch.c.

References foo.

stub()

static void * stub ( void *  arg )

static

Definition at line 79 of file threads_arch.c.

References stub_arg::arg, foo, and stub_arg::func.