// -----------------------------------------------------------------------
-// Copyright (C) 2006 - 2007 FRESCOR consortium partners:
+// Copyright (C) 2006 - 2008 FRESCOR consortium partners:
//
// Universidad de Cantabria, SPAIN
// University of York, UK
// Visual Tools S.A. SPAIN
// Rapita Systems Ltd UK
// Evidence ITALY
-//
+//
// See http://www.frescor.org for a link to partners' websites
//
// FRESCOR project (FP6/2005/IST/5-034026) is funded
//
//
// based on previous work (FSF) done in the FIRST project
-//
+//
// Copyright (C) 2005 Mälardalen University, SWEDEN
// Scuola Superiore S.Anna, ITALY
// Universidad de Cantabria, SPAIN
// FSF API web pages: http://marte.unican.es/fsf/docs
// http://shark.sssup.it/contrib/first/docs/
//
-// This file is part of FRSH API
-//
-// FRSH API is free software; you can redistribute it and/or modify
-// it under the terms of the GNU General Public License as published by
-// the Free Software Foundation; either version 2, or (at your option)
-// any later version.
-//
-// FRSH API is distributed in the hope that it will be useful, but
-// WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-// General Public License for more details.
+// This file is part of FRSH (FRescor ScHeduler)
//
-// You should have received a copy of the GNU General Public License
-// distributed with FRSH API; see file COPYING. If not, write to the
-// Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
-// 02111-1307, USA.
+// FRSH is free software; you can redistribute it and/or modify it
+// under terms of the GNU General Public License as published by the
+// Free Software Foundation; either version 2, or (at your option) any
+// later version. FRSH is distributed in the hope that it will be
+// useful, but WITHOUT ANY WARRANTY; without even the implied warranty
+// of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details. You should have received a
+// copy of the GNU General Public License along with FRSH; see file
+// COPYING. If not, write to the Free Software Foundation, 675 Mass Ave,
+// Cambridge, MA 02139, USA.
//
+// As a special exception, including FRSH header files in a file,
+// instantiating FRSH generics or templates, or linking other files
+// with FRSH objects to produce an executable application, does not
+// by itself cause the resulting executable application to be covered
+// by the GNU General Public License. This exception does not
+// however invalidate any other reasons why the executable file might be
+// covered by the GNU Public License.
// As a special exception, if you include this header file into source
// files to be compiled, this header file does not by itself cause
// the resulting executable to be covered by the GNU General Public
#include "frsh_hierarchical_types.h"
#include "frsh_core.h"
+FRSH_CPP_BEGIN_DECLS
#define FRSH_HIERARCHICAL_MODULE_SUPPORTED 1
+/**
+ * @file frsh_hierarchical.h
+ **/
/**
* @defgroup hierarchical Hierarchical Scheduling Module
*
* This module includes the types and functions to use local
- * schedulers within servers allowing to attach more than one thread
- * to a server and define an scheduling policy within.
+ * schedulers within vres allowing to attach more than one thread
+ * to a vres and define an scheduling policy within.
*
* @{
**/
* frsh_local_scheduler_init()
*
* This call has the following effects:
- * FP: none
- * EDF: none
+ * FP: none \n
+ * EDF: none \n
* TABLE_DRIVEN :
* Records the schedule duration, and starts the
* schedule at the time of the call. After the
* schedule duration has elapsed, the schedule in
* the table is repeated.
*
- * @return
- * FRSH_ERR_BAD_ARGUMENT : if the value of the server argument is not in range,
- * or info is NULL
+ * @return 0 if no error \n
+ * FRSH_ERR_BAD_ARGUMENT : if the value of the vres argument is not in range,
+ * or info is NULL \n
* FRSH_ERR_NOT_SCHEDULED_CALLING_THREAD : if the calling thread is not
- * scheduled under the FRSH
- * FRSH_ERR_INVALID_SCHEDULER_REPLY : the scheduler is wrong or not running
- * FRSH_ERR_NOT_CONTRACTED_SERVER : if the server of the calling thread
+ * scheduled under the FRSH \n
+ * FRSH_ERR_INVALID_SCHEDULER_REPLY : the scheduler is wrong or not
+ * running \n
+ * FRSH_ERR_NOT_CONTRACTED_VRES : if the vres of the calling thread
* has been cancelled or it is not valid
**/
int frsh_local_scheduler_init(
* The operation updates the specified contract parameters object by
* setting its scheduling policy to the specified input parameter.
* The default policy is FRSH_NONE, which means that only one thread
- * may be bound to the server
+ * may be bound to the vres
*
- * @return
+ * @return 0 if no error \n
* FRSH_ERR_BAD_ARGUMENT : if sched_policy is not in range,
* or contract is NULL
**/
* object its scheduling policy, and copies it to the place pointed to
* by the corresponding input parameter.
*
- * @return
+ * @return 0 if no error \n
* FRSH_ERR_BAD_ARGUMENT : if sched_policy or contract are NULL
**/
int frsh_contract_get_sched_policy
* frsh_thread_create_local()
*
* This operation creates a thread and binds it to the specified
- * server, which must have a policy different than FRSH_NONE. The new
+ * vres, which must have a policy different than FRSH_NONE. The new
* thread is created with the arguments thread, attr, thread_code and
* arg as they are defined for the pthread_create() POSIX function
* call, and its local scheduling parameters are set to the value
* stored in the variable pointed to by sched_params, which must be
- * compatible with the server's scheduling policy. Then, the function
- * binds the created thread to the new server. The attr /parameter is
+ * compatible with the vres's scheduling policy. Then, the function
+ * binds the created thread to the new vres. The attr /parameter is
* overwritten as necessary to introduce the adequate scheduling
* policy and priority, according to the preemption level given in the
* contract and the frsh_priority_map() function defined by the user.
*
- * @return
- * FRSH_ERR_BAD_ARGUMENT : if the value of the server argument is not in range,
- * or sched_params is NULL
+ * @return 0 if no error \n
+ * FRSH_ERR_BAD_ARGUMENT : if the value of the vres argument is not in range,
+ * or sched_params is NULL \n
* FRSH_ERR_SCHED_POLICY_NOT_COMPATIBLE : if the scheduling policy
- * in sched_params is not compatible to the server's one.
+ * in sched_params is not compatible to the vres's one \n
* FRSH_ERR_INTERNAL_ERROR : erroneous binding or malfunction of the FRSH
- * main scheduler
- * FRSH_ERR_NOT_CONTRACTED_SERVER : if the referenced server is not valid
- * FRSH_ERR_SERVER_WORKLOAD_NOT_COMPATIBLE: if the kind of workload
- * of the server is FRSH_OVERHEAD
- *
+ * main scheduler \n
+ * FRSH_ERR_NOT_CONTRACTED_VRES : if the referenced vres is not
+ * valid \n
+ * FRSH_ERR_VRES_WORKLOAD_NOT_COMPATIBLE: if the kind of workload
+ * of the vres is FRSH_OVERHEAD \n
+ * .
* It may also return any of the errors that may be returned by the
* pthread_create()POSIX function call
**/
/**
* frsh_thread_bind_local()
*
- * This operation associates a thread with a server, which must have a
+ * This operation associates a thread with a vres, which must have a
* policy different than FRSH_NONE. The thread's local scheduling
* parameters are set to the value stored in the variable pointed to
- * by sched_params, which must be compatible with the server's
+ * by sched_params, which must be compatible with the vres's
* scheduling policy. After the call the thread starts consuming the
- * server's budget and is executed according to the contract
- * established for that server and to its scheduling policy. If the
- * thread was already bound to another server, it is effectively
+ * vres's budget and is executed according to the contract
+ * established for that vres and to its scheduling policy. If the
+ * thread was already bound to another vres, it is effectively
* unbound from it and bound to the specified one.
*
* Implementation dependent issue: In order to allow the usage of
* scheduling policy SCHED_APP and at the same time be attached to an
* application scheduler different than the frsh scheduler.
*
- * @return
- * FRSH_ERR_BAD_ARGUMENT : if the server argument does not complain with
+ * @return 0 if no error \n
+ * FRSH_ERR_BAD_ARGUMENT : if the vres argument does not complain with
* the expected format or valid range, the given thread does not exist,
- * or sched_params is NULL
+ * or sched_params is NULL \n
* FRSH_ERR_SCHED_POLICY_NOT_COMPATIBLE : if the scheduling policy
- * in sched_params is not compatible to the server's one.
+ * in sched_params is not compatible to the vres's one. \n
* FRSH_ERR_INTERNAL_ERROR : erroneous binding or malfunction of the FRSH
- * main scheduler
+ * main scheduler \n
* FRSH_ERR_UNKNOWN_APPSCHEDULED_THREAD : if the thread is attached to
- * an application defined scheduler different than the frsh scheduler
- * FRSH_ERR_NOT_CONTRACTED_SERVER : if the referenced server is not valid
- * FRSH_ERR_SERVER_WORKLOAD_NOT_COMPATIBLE: if the kind of workload
- * of the server is FRSH_OVERHEAD
+ * an application defined scheduler different than the frsh
+ * scheduler \n
+ * FRSH_ERR_NOT_CONTRACTED_VRES : if the referenced vres is not
+ * valid \n
+ * FRSH_ERR_VRES_WORKLOAD_NOT_COMPATIBLE: if the kind of workload
+ * of the vres is FRSH_OVERHEAD
**/
-int frsh_thread_bind_local(frsh_vres_id_t server,
+int frsh_thread_bind_local(frsh_vres_id_t vres,
frsh_thread_id_t thread,
frsh_sched_params_t *sched_params);
*
* This function changes the local scheduling parameters of the thread
* to the value pointed to by sched_params. This value must be
- * compatible with the scheduling policy of the server to which the
+ * compatible with the scheduling policy of the vres to which the
* thread is bound.
*
- * @return
+ * @return 0 if no error \n
* FRSH_ERR_BAD_ARGUMENT : if the given thread does not exist,
- * or sched_params is NULL
+ * or sched_params is NULL \n
* FRSH_ERR_SCHED_POLICY_NOT_COMPATIBLE : if the thread is already bound
* and the scheduling policy in sched_params is not compatible to the
- * one of the thread's server.
+ * one of the thread's vres. \n
* FRSH_ERR_NOT_SCHEDULED_THREAD : if the given thread is not scheduled
- * under the FRSH
+ * under FRSH \n
* FRSH_ERR_INTERNAL_ERROR : erroneous binding or malfunction of the FRSH
- * main scheduler
+ * main scheduler \n
* FRSH_ERR_UNKNOWN_APPSCHEDULED_THREAD : if the thread is attached to
- * an application defined scheduler different than the frsh scheduler
- * FRSH_ERR_NOT_CONTRACTED_SERVER : if the thread is bound and its server
+ * an application defined scheduler different than the frsh
+ * scheduler \n
+ * FRSH_ERR_NOT_CONTRACTED_VRES : if the thread is bound and its vres
* is not valid
**/
int frsh_thread_set_local_sched_params (frsh_thread_id_t thread,
* This function stores the local scheduling parameters of the
* specified thread in the variable pointed to by sched_params.
*
- * @return
+ * @return 0 if no error \n
* FRSH_ERR_BAD_ARGUMENT : if sched_params is NULL or the thread does
- * not exist
+ * not exist \n
* FRSH_ERR_NOT_SCHEDULED_THREAD : if the given thread is not scheduled
- * under the FRSH
+ * under FRSH
**/
int frsh_thread_get_local_sched_params(frsh_thread_id_t thread,
frsh_sched_params_t *sched_params);
/*}*/
+FRSH_CPP_END_DECLS
+
#endif // _FRSH_HIERARCHICAL_H_