define.
git-svn-id: http://www.frescor.org/private/svn/frescor/fosa/trunk@1389
35b4ef3e-fd22-0410-ab77-
dab3279adceb
#include "fosa_long_jump.h"
#include "fosa_time.h"
#include "fosa_platform_values.h"
#include "fosa_long_jump.h"
#include "fosa_time.h"
#include "fosa_platform_values.h"
-#include "fosa_thread_groups.h"
+#include "fosa_group_clocks.h"
/**
* @defgroup fosa FOSA Private Interfaces
/**
* @defgroup fosa FOSA Private Interfaces
// however invalidate any other reasons why the executable file might be
// covered by the GNU Public License.
// -----------------------------------------------------------------------
// however invalidate any other reasons why the executable file might be
// covered by the GNU Public License.
// -----------------------------------------------------------------------
//==============================================
// ******** ****** ******** **********
// **///// /** ** **////// /** /**
//==============================================
// ******** ****** ******** **********
// **///// /** ** **////// /** /**
// FOSA(Frescor Operating System Adaptation layer)
//================================================
// FOSA(Frescor Operating System Adaptation layer)
//================================================
-#ifndef _FOSA_THREAD_GROUPS_H
-#define _FOSA_THREAD_GROUPS_H
+#ifndef _FOSA_GROUP_CLOCKS_H
+#define _FOSA_GROUP_CLOCKS_H
#include "fosa_types.h"
#include "fosa_configuration_parameters.h"
#include "fosa_types.h"
#include "fosa_configuration_parameters.h"
- * @defgroup threadgroups Thread Groups
+ * @defgroup groupclockss Group Clocks
- * This module defines the types and functions to manage thread groups
+ * This module defines the types and functions to manage thread sets
* and execution clocks attached to them. These functions are used
* for the hierarchical scheduling module of FRSH
*
* and execution clocks attached to them. These functions are used
* for the hierarchical scheduling module of FRSH
*
- * fosa_thread_group_create()
+ * fosa_thread_set_create()
- * Create an empty thread group and return an identifier
+ * Create an empty thread set and return an identifier
- * This function stores in the variable pointed to by group the
- * identifier of a thread group that is created by the function.
+ * This function stores in the variable pointed to by set the
+ * identifier of a thread set that is created by the function.
*
* Returns 0 if successful; otherwise it returns an error code:
* FOSA_EAGAIN: no resources are currently available to create the
*
* Returns 0 if successful; otherwise it returns an error code:
* FOSA_EAGAIN: no resources are currently available to create the
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* implementation and dependant applications
**/
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* implementation and dependant applications
**/
-
-int fosa_thread_group_create(fosa_thread_group_id_t *group);
+int fosa_thread_set_create(fosa_thread_set_id_t *set);
- * fosa_thread_group_destroy()
+ * fosa_thread_set_destroy()
- * Destroy a thread group
- * This function destroys the thread group identified by group. The
- * threads that were in the group are detached from the group. It is
+ * This function destroys the thread set identified by set. The
+ * threads that were in the set are detached from the set. It is
* an error to use the identifier after this call. The effects of
* using a CPU-time clock associated with the destroyed thread are
* undefined.
*
* Returns 0 if successful; otherwise it returns an error code:
* an error to use the identifier after this call. The effects of
* using a CPU-time clock associated with the destroyed thread are
* undefined.
*
* Returns 0 if successful; otherwise it returns an error code:
- * FOSA_EINVAL: group is invalid
+ * FOSA_EINVAL: set is invalid
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* implementation and dependant applications
**/
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* implementation and dependant applications
**/
-
-int fosa_thread_group_destroy(fosa_thread_group_id_t group);
+int fosa_thread_set_destroy(fosa_thread_set_id_t set);
- * fosa_thread_group_add()
+ * fosa_thread_set_add()
- * Add a thread to a thread group
+ * Add a thread to a thread set
*
* This function adds the thread identified with thread_id to the
*
* This function adds the thread identified with thread_id to the
- * thread group identified by group.
+ * thread set identified by set.
*
* Returns 0 if successful; otherwise it returns an error code:
*
* Returns 0 if successful; otherwise it returns an error code:
- * FOSA_EINVAL: group is invalid
- * FOSA_ENOTSUP: thread already a member of some other group
+ * FOSA_EINVAL: set is invalid
+ * FOSA_ENOTSUP: thread already a member of some other set
* FOSA_EAGAIN: no resources available to add the new thread
* FOSA_ESRCH: thread_id doesn't identify a valid thread
*
* FOSA_EAGAIN: no resources available to add the new thread
* FOSA_ESRCH: thread_id doesn't identify a valid thread
*
* notify it to the system console and then terminate the FRSH
* implementation and dependant applications
**/
* notify it to the system console and then terminate the FRSH
* implementation and dependant applications
**/
-
-int fosa_thread_group_add(fosa_thread_group_id_t group,
+int fosa_thread_set_add(fosa_thread_set_id_t set,
fosa_thread_id_t thread_id);
/**
fosa_thread_id_t thread_id);
/**
- * fosa_thread_group_del()
+ * fosa_thread_set_del()
- * Delete a thread from a thread group
+ * Delete a thread from a thread set
*
* This function deletes the thread identified with thread_id from
*
* This function deletes the thread identified with thread_id from
- * the thread group identified by group.
+ * the thread set identified by set.
*
* Returns 0 if successful; otherwise it returns an error code:
*
* Returns 0 if successful; otherwise it returns an error code:
- * FOSA_EINVAL: group is invalid
- * FOSA_EINVAL: thread is not a member of the group
+ * FOSA_EINVAL: set is invalid
+ * FOSA_EINVAL: thread is not a member of the set
* FOSA_ESRCH: thread_id doesn't identify a valid thread
*
* Alternatively, in case of error the implementation is allowed to
* FOSA_ESRCH: thread_id doesn't identify a valid thread
*
* Alternatively, in case of error the implementation is allowed to
* implementation and dependant applications
**/
* implementation and dependant applications
**/
-int fosa_thread_group_del(fosa_thread_group_id_t group,
+int fosa_thread_set_del(fosa_thread_set_id_t set,
fosa_thread_id_t thread_id);
/**
fosa_thread_id_t thread_id);
/**
- * fosa_get_groupcpu_clock()
+ * fosa_get_setcpu_clock()
*
* Get the identifier of a cpu-time clock associated to a thread
*
* Get the identifier of a cpu-time clock associated to a thread
*
* This function stores in the variable pointed to by clockid the
*
* This function stores in the variable pointed to by clockid the
- * identifier of a cpu-time clock for the thread group specified
- * by group.
+ * identifier of a cpu-time clock for the thread set specified
+ * by set.
*
* Returns 0 if successful; otherwise it returns an error code:
*
* Returns 0 if successful; otherwise it returns an error code:
- * FOSA_EINVAL: the group is invalid
+ * FOSA_EINVAL: the set is invalid
* FOSA_EINVAL: clock_id is a null pointer
*
* Alternatively, in case of error the implementation is allowed to
* FOSA_EINVAL: clock_id is a null pointer
*
* Alternatively, in case of error the implementation is allowed to
* implementation and dependant applications
**/
* implementation and dependant applications
**/
-int fosa_get_groupcpu_clock(const fosa_thread_group_id_t group,
+int fosa_get_groupcpu_clock(const fosa_thread_set_id_t set,
fosa_clock_id_t *clock_id);
fosa_clock_id_t *clock_id);
-/* Thread groups */
-/*****************/
-typedef marte_thread_set_t FOSA_THREAD_GROUP_ID_T_OPAQUE;
+/* Group clocks */
+/****************/
+typedef marte_thread_set_t FOSA_THREAD_SET_ID_T_OPAQUE;
-#define FOSA_NULL_THREAD_GROUP_ID_OPAQUE 0 /* In MaRTE-OS thread_set_t are
+#define FOSA_NULL_THREAD_SET_ID_OPAQUE 0 /* In MaRTE-OS thread_set_t are
* pointers */
/* FOSA errors */
* pointers */
/* FOSA errors */
#define FOSA_ETIMEDOUT ETIMEDOUT
#define FOSA_ETIMEDOUT ETIMEDOUT
-/* Not found in search (non existing thread, thread_group...) */
+/* Not found in search (non existing thread, thread_set...) */
#define FOSA_ESRCH ESRCH
#define FOSA_ENOTSUP ENOTSUP
#define FOSA_ESRCH ESRCH
#define FOSA_ENOTSUP ENOTSUP
/* Thread groups */
/*****************/
/* Thread groups */
/*****************/
-typedef int FOSA_THREAD_GROUP_ID_T_OPAQUE
+typedef int FOSA_THREAD_SET_ID_T_OPAQUE
/* FOSA Errors */
/***************/
/* FOSA Errors */
/***************/
/* Thread groups */
/*****************/
/* Thread groups */
/*****************/
-typedef int FOSA_THREAD_GROUP_ID_T_OPAQUE;
+typedef int FOSA_THREAD_SET_ID_T_OPAQUE;
/* Clocks and signals */
/**********************/
/* Clocks and signals */
/**********************/
*********************/
/**
* @addtogroup threadgroups
*
* @{
**/
*********************/
/**
* @addtogroup threadgroups
*
* @{
**/
-typedef FOSA_THREAD_GROUP_ID_T_OPAQUE fosa_thread_group_id_t;
+typedef FOSA_THREAD_SET_ID_T_OPAQUE fosa_thread_set_id_t;
-//#define FOSA_NULL_THREAD_GROUP_ID FOSA_NULL_THREAD_GROUP_ID_OPAQUE
+//#define FOSA_NULL_THREAD_SET_ID FOSA_NULL_THREAD_SET_ID_OPAQUE