Thread

Threading utility interfaces More...

Files
file	thread.h
	spa/support/thread.h

Data Structures
struct	spa_thread_utils
struct	spa_thread_utils_methods
	thread utils More...
struct	spa_thread

Macros
#define	SPA_TYPE_INFO_Thread   SPA_TYPE_INFO_POINTER_BASE "Thread"
	a thread object.
#define	SPA_TYPE_INTERFACE_ThreadUtils   SPA_TYPE_INFO_INTERFACE_BASE "ThreadUtils"
#define	SPA_VERSION_THREAD_UTILS   0
#define	SPA_VERSION_THREAD_UTILS_METHODS   0
#define	SPA_KEY_THREAD_NAME   "thread.name" /* the thread name */
#define	SPA_KEY_THREAD_STACK_SIZE   "thread.stack-size" /* the stack size of the thread */
#define	SPA_KEY_THREAD_AFFINITY   "thread.affinity" /* array of CPUs for this thread */
#define	SPA_KEY_THREAD_CREATOR   "thread.creator" /* platform specific thread creator function */

Functions
static struct spa_thread *	spa_thread_utils_create (struct spa_thread_utils *o, const struct spa_dict *props, void *(*start_routine)(void *), void *arg)
	create a new thread that runs start with arg
static int	spa_thread_utils_join (struct spa_thread_utils *o, struct spa_thread *thread, void **retval)
	stop and join a thread
static int	spa_thread_utils_get_rt_range (struct spa_thread_utils *o, const struct spa_dict *props, int *min, int *max)
	get realtime priority range for threads created with props
static int	spa_thread_utils_acquire_rt (struct spa_thread_utils *o, struct spa_thread *thread, int priority)
	acquire realtime priority, a priority of -1 refers to the priority configured in the realtime module
static int	spa_thread_utils_drop_rt (struct spa_thread_utils *o, struct spa_thread *thread)
	drop realtime priority

Detailed Description

Threading utility interfaces

Macro Definition Documentation

SPA_TYPE_INFO_Thread

#define SPA_TYPE_INFO_Thread   SPA_TYPE_INFO_POINTER_BASE "Thread"

a thread object.

This can be cast to a platform native thread, like pthread on posix systems

SPA_TYPE_INTERFACE_ThreadUtils

#define SPA_TYPE_INTERFACE_ThreadUtils   SPA_TYPE_INFO_INTERFACE_BASE "ThreadUtils"

SPA_VERSION_THREAD_UTILS

#define SPA_VERSION_THREAD_UTILS   0

SPA_VERSION_THREAD_UTILS_METHODS

#define SPA_VERSION_THREAD_UTILS_METHODS   0

SPA_KEY_THREAD_NAME

#define SPA_KEY_THREAD_NAME   "thread.name" /* the thread name */

SPA_KEY_THREAD_STACK_SIZE

#define SPA_KEY_THREAD_STACK_SIZE   "thread.stack-size" /* the stack size of the thread */

SPA_KEY_THREAD_AFFINITY

#define SPA_KEY_THREAD_AFFINITY   "thread.affinity" /* array of CPUs for this thread */

SPA_KEY_THREAD_CREATOR

#define SPA_KEY_THREAD_CREATOR   "thread.creator" /* platform specific thread creator function */

Function Documentation

spa_thread_utils_create()

static struct spa_thread * spa_thread_utils_create ( struct spa_thread_utils * o, const struct spa_dict * props, void *(*)(void *) start_routine, void * arg )

inlinestatic

create a new thread that runs start with arg

See also

spa_thread_utils_methods.create

spa_thread_utils_join()

static int spa_thread_utils_join ( struct spa_thread_utils * o, struct spa_thread * thread, void ** retval )

inlinestatic

stop and join a thread

See also

spa_thread_utils_methods.join

spa_thread_utils_get_rt_range()

static int spa_thread_utils_get_rt_range ( struct spa_thread_utils * o, const struct spa_dict * props, int * min, int * max )

inlinestatic

get realtime priority range for threads created with props

See also

spa_thread_utils_methods.get_rt_range

spa_thread_utils_acquire_rt()

static int spa_thread_utils_acquire_rt ( struct spa_thread_utils * o, struct spa_thread * thread, int priority )

inlinestatic

acquire realtime priority, a priority of -1 refers to the priority configured in the realtime module

See also

spa_thread_utils_methods.acquire_rt

spa_thread_utils_drop_rt()

static int spa_thread_utils_drop_rt ( struct spa_thread_utils * o, struct spa_thread * thread )

inlinestatic

drop realtime priority

See also

spa_thread_utils_methods.drop_rt