TASK.h.px-xxx-xxx File Reference

POSIX specific definitions for the TASK routines. More...

Defines
#define	TASK_IMPLEMENTATION_PX
	Note that we are using the POSIX implementation of the tasking model.
#define	TASK_K_PRIORITY_ORDER_LO_TO_HI   1
	A boolean indicating whether low priority tasks have low numbers and high priority tasks have high numbers. This is a platform dependent value.
#define	TASK_K_STACK_SIZE_MINIMUM   1000000
	Minimum acceptable stack size.
#define	TASK_K_STACK_SIZE_DEFAULT   1000000
	Default stack size.
Typedefs
typedef enum _TASK_options	TASK_options
	Typedef for enum _TASK_options.
typedef enum _TASK_priority_limits	TASK_priority_limits
	Typedef for enum _TASK_priority_limits.
typedef enum _TASK_priority_order	TASK_priority_order
	Typedef for enum _TASK_priority_order.
typedef void *	TASK_block_handle
	The abstract data type for a task block handle.
Enumerations
enum	_TASK_options {   TASK_M_OPTIONS_FP = 0,   TASK_M_OPTIONS_ENV = 1,   TASK_M_OPTIONS_NO_STACK_FILL = 2,   TASK_M_OPTIONS_UNBREAKABLE = 4 }
	POSIX definitions of the option bits. More...
enum	_TASK_priority_limits {   TASK_K_PRIORITY_LIMITS_MIN = 1,   TASK_K_PRIORITY_LIMITS_MAX = 99 }
	Gives the lowest and highest number that can be specified as a priority for a given implementation. More...
enum	_TASK_priority_order {   TASK_K_PRIORITY_ORDER_LO = 1,   TASK_K_PRIORITY_ORDER_HI = 99 }
	Gives the priority number for the task with the lowest and highest priority for a given implementation. More...

---

Detailed Description

POSIX specific definitions for the TASK routines.

Author:

JJRussell - russell@slac.stanford.edu

    CVS $Id: TASK.h.px-xxx-xxx,v 1.5 2005/10/01 01:00:12 russell Exp $

---

Define Documentation

#define TASK_K_PRIORITY_ORDER_LO_TO_HI   1

A boolean indicating whether low priority tasks have low numbers and high priority tasks have high numbers. This is a platform dependent value.

Warning:

This must be a preprocessor symbol since code uses a preprocessor test on this symbol. Remember, the preprocessor knows nothing about the C language, including the value of an enumerated type.

---

Typedef Documentation

TASK_block_handle

The abstract data type for a task block handle.

See also:

TASK_block

TASK_unblock

This is used by the TASK_block/TASK_unblock pair of routines to provide an easy TASK synchronization method. This is useful in implementing synchronous versions of asynchronous interfaces

TASK_options

Typedef for enum _TASK_options.

This enumeration provides the definitions for the bit masks used to set the options in the TASK attribute options parameter. These are NOPS in the POSIX implemenation and are really just synomyns for the This gives at least some feel of portability to the code without going lowest common denominator.

TASK_priority_limits

Typedef for enum _TASK_priority_limits.

The lowest and highest number that can be specified as a priority for a given implementation. Note that this is not the same as the numerical specification of a task with the highest priority and one with the lowest priority. That is given by TASK_priority_order.

TASK_priority_order

Typedef for enum _TASK_priority_order.

This gives the priority number for the task's with the lowest and highest priority for a given implementation. Note that this is not the same as the numerical specification of a task's priority. That is given by TASK_priority_limits.

---

Enumeration Type Documentation

enum _TASK_options

POSIX definitions of the option bits.

Enumerator:

TASK_M_OPTIONS_FP	Provided for compatibility
TASK_M_OPTIONS_ENV	Provided for compatibility
TASK_M_OPTIONS_NO_STACK_FILL	Provided for compatibility
TASK_M_OPTIONS_UNBREAKABLE	Provided for compatibility

enum _TASK_priority_limits

Gives the lowest and highest number that can be specified as a priority for a given implementation.

Enumerator:

TASK_K_PRIORITY_LIMITS_MIN	Minimum priority specification
TASK_K_PRIORITY_LIMITS_MAX	Maximum priority specification

enum _TASK_priority_order

Gives the priority number for the task with the lowest and highest priority for a given implementation.

Enumerator:

TASK_K_PRIORITY_ORDER_LO	Priority specification for the lowest priority task
TASK_K_PRIORITY_ORDER_HI	Priority specification for the highest priority task