Thread Execution Abstraction. More...

#include "apt.h"
#include "apt_task_msg.h"

Include dependency graph for apt_task.h:

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

Data Structures
struct	apt_task_vtable_t

Typedefs
typedef typedefAPT_BEGIN_EXTERN_C struct apt_task_t	apt_task_t

typedef struct apt_task_vtable_t	apt_task_vtable_t

typedef apt_bool_t(*	apt_task_method_f) (apt_task_t *task)

typedef void(*	apt_task_event_f) (apt_task_t *task)

Functions
apt_task_t *	apt_task_create (void obj, apt_task_msg_pool_t msg_pool, apr_pool_t *pool)

apt_bool_t	apt_task_destroy (apt_task_t *task)

apt_bool_t	apt_task_add (apt_task_t task, apt_task_t child_task)

apt_bool_t	apt_task_start (apt_task_t *task)

apt_bool_t	apt_task_offline (apt_task_t *task)

apt_bool_t	apt_task_online (apt_task_t *task)

apt_bool_t	apt_task_terminate (apt_task_t *task, apt_bool_t wait_till_complete)

apt_bool_t	apt_task_wait_till_complete (apt_task_t *task)

apt_task_msg_t *	apt_task_msg_get (apt_task_t *task)

apt_bool_t	apt_task_msg_signal (apt_task_t task, apt_task_msg_t msg)

apt_bool_t	apt_task_msg_parent_signal (apt_task_t task, apt_task_msg_t msg)

apt_bool_t	apt_task_msg_process (apt_task_t task, apt_task_msg_t msg)

apt_bool_t	apt_task_start_request_process (apt_task_t *task)

apt_bool_t	apt_task_terminate_request_process (apt_task_t *task)

apt_task_t *	apt_task_parent_get (const apt_task_t *task)

apr_pool_t *	apt_task_pool_get (const apt_task_t *task)

void *	apt_task_object_get (const apt_task_t *task)

apt_task_vtable_t *	apt_task_vtable_get (apt_task_t *task)

void	apt_task_name_set (apt_task_t task, const char name)

const char *	apt_task_name_get (const apt_task_t *task)

void	apt_task_auto_ready_set (apt_task_t *task, apt_bool_t auto_ready)

apt_bool_t	apt_task_ready (apt_task_t *task)

apt_bool_t *	apt_task_running_flag_get (apt_task_t *task)

apt_bool_t	apt_task_start_request_add (apt_task_t *task)

apt_bool_t	apt_task_start_request_remove (apt_task_t *task)

apt_bool_t	apt_task_terminate_request_add (apt_task_t *task)

apt_bool_t	apt_task_terminate_request_remove (apt_task_t *task)

void	apt_task_delay (apr_size_t msec)

Detailed Description

Thread Execution Abstraction.

Typedef Documentation

◆ apt_task_event_f

typedef void(* apt_task_event_f) (apt_task_t *task)

Opaque task event declaration

◆ apt_task_method_f

typedef apt_bool_t(* apt_task_method_f) (apt_task_t *task)

Opaque task method declaration

◆ apt_task_t

typedef typedefAPT_BEGIN_EXTERN_C struct apt_task_t apt_task_t

Opaque task declaration

◆ apt_task_vtable_t

typedef struct apt_task_vtable_t apt_task_vtable_t

Opaque task virtual table declaration

Function Documentation

◆ apt_task_add()

apt_bool_t apt_task_add	(	apt_task_t *	task,
		apt_task_t *	child_task
	)

Add child task.

Parameters

task	the task to add child task to
child_task	the child task to add

◆ apt_task_auto_ready_set()

void apt_task_auto_ready_set	(	apt_task_t *	task,
		apt_bool_t	auto_ready
	)

Enable/disable auto ready mode.

Parameters

task	the task to set mode for
auto_ready	the enabled/disabled auto ready mode

◆ apt_task_create()

apt_task_t* apt_task_create	(	void *	obj,
		apt_task_msg_pool_t *	msg_pool,
		apr_pool_t *	pool
	)

Create task.

Parameters

obj	the external object to associate with the task
msg_pool	the pool of task messages
pool	the pool to allocate memory from

◆ apt_task_delay()

void apt_task_delay ( apr_size_t msec )

Hold task execution.

Parameters

msec	the time to hold

◆ apt_task_destroy()

apt_bool_t apt_task_destroy ( apt_task_t * task )

Destroy task.

Parameters

task	the task to destroy

◆ apt_task_msg_get()

apt_task_msg_t* apt_task_msg_get ( apt_task_t * task )

Get (acquire) task message.

Parameters

task	the task to get task message from

◆ apt_task_msg_parent_signal()

apt_bool_t apt_task_msg_parent_signal	(	apt_task_t *	task,
		apt_task_msg_t *	msg
	)

Signal (post) message to the parent of the specified task.

Parameters

task	the task to signal message to
msg	the message to signal

◆ apt_task_msg_process()

apt_bool_t apt_task_msg_process	(	apt_task_t *	task,
		apt_task_msg_t *	msg
	)

Process message signaled to the task.

Parameters

task	the task to process message
msg	the message to process

◆ apt_task_msg_signal()

apt_bool_t apt_task_msg_signal	(	apt_task_t *	task,
		apt_task_msg_t *	msg
	)

Signal (post) message to the task.

Parameters

task	the task to signal message to
msg	the message to signal

◆ apt_task_name_get()

const char* apt_task_name_get ( const apt_task_t * task )

Get task name.

Parameters

task	the task to get name from

◆ apt_task_name_set()

void apt_task_name_set	(	apt_task_t *	task,
		const char *	name
	)

Give a name to the task.

Parameters

task	the task to give name for
name	the name to set

◆ apt_task_object_get()

void* apt_task_object_get ( const apt_task_t * task )

Get external object associated with the task.

Parameters

task	the task to get object from

◆ apt_task_offline()

apt_bool_t apt_task_offline ( apt_task_t * task )

Take task offline.

Parameters

task	the task to take offline

◆ apt_task_online()

apt_bool_t apt_task_online ( apt_task_t * task )

Bring task online.

Parameters

task	the task to bring online

◆ apt_task_parent_get()

apt_task_t* apt_task_parent_get ( const apt_task_t * task )

Get parent (master) task.

Parameters

task	the task to get parent from

◆ apt_task_pool_get()

apr_pool_t* apt_task_pool_get ( const apt_task_t * task )

Get memory pool associated with task.

Parameters

task	the task to get pool from

◆ apt_task_ready()

apt_bool_t apt_task_ready ( apt_task_t * task )

Explicitly indicate task is ready to process messages.

Parameters

task the task

◆ apt_task_running_flag_get()

apt_bool_t* apt_task_running_flag_get ( apt_task_t * task )

Get the running flag.

Parameters

task the task

◆ apt_task_start()

apt_bool_t apt_task_start ( apt_task_t * task )

Start task.

Parameters

task	the task to start

◆ apt_task_start_request_add()

apt_bool_t apt_task_start_request_add ( apt_task_t * task )

Add start request.

Parameters

task the task

◆ apt_task_start_request_process()

apt_bool_t apt_task_start_request_process ( apt_task_t * task )

Process task start request.

Parameters

task	the task being started

◆ apt_task_start_request_remove()

apt_bool_t apt_task_start_request_remove ( apt_task_t * task )

Remove start request.

Parameters

task the task

◆ apt_task_terminate()

apt_bool_t apt_task_terminate	(	apt_task_t *	task,
		apt_bool_t	wait_till_complete
	)

Terminate task.

Parameters

task	the task to terminate
wait_till_complete	whether to wait for task to complete or process termination asynchronously

◆ apt_task_terminate_request_add()

apt_bool_t apt_task_terminate_request_add ( apt_task_t * task )

Add termination request.

Parameters

task the task

◆ apt_task_terminate_request_process()

apt_bool_t apt_task_terminate_request_process ( apt_task_t * task )

Process task termination request.

Parameters

task	the task being terminated

◆ apt_task_terminate_request_remove()

apt_bool_t apt_task_terminate_request_remove ( apt_task_t * task )

Remove termination request.

Parameters

task the task

◆ apt_task_vtable_get()

apt_task_vtable_t* apt_task_vtable_get ( apt_task_t * task )

Get task vtable.

Parameters

task	the task to get vtable from

◆ apt_task_wait_till_complete()

apt_bool_t apt_task_wait_till_complete ( apt_task_t * task )

Wait for task till complete.

Parameters

task	the task to wait for

Data Structures

Typedefs

Functions

Detailed Description

Typedef Documentation

◆ apt_task_event_f

◆ apt_task_method_f

◆ apt_task_t

◆ apt_task_vtable_t

Function Documentation

◆ apt_task_add()

◆ apt_task_auto_ready_set()

◆ apt_task_create()

◆ apt_task_delay()

◆ apt_task_destroy()

◆ apt_task_msg_get()

◆ apt_task_msg_parent_signal()

◆ apt_task_msg_process()

◆ apt_task_msg_signal()

◆ apt_task_name_get()

◆ apt_task_name_set()

◆ apt_task_object_get()

◆ apt_task_offline()

◆ apt_task_online()

◆ apt_task_parent_get()

◆ apt_task_pool_get()

◆ apt_task_ready()

◆ apt_task_running_flag_get()

◆ apt_task_start()

◆ apt_task_start_request_add()

◆ apt_task_start_request_process()

◆ apt_task_start_request_remove()

◆ apt_task_terminate()

◆ apt_task_terminate_request_add()

◆ apt_task_terminate_request_process()

◆ apt_task_terminate_request_remove()

◆ apt_task_vtable_get()

◆ apt_task_wait_till_complete()