// -----------------------------------------------------------------------
-// Copyright (C) 2006 - 2007 FRESCOR consortium partners:
+// Copyright (C) 2006 - 2009 FRESCOR consortium partners:
//
// Universidad de Cantabria, SPAIN
// University of York, UK
// FSF API web pages: http://marte.unican.es/fsf/docs
// http://shark.sssup.it/contrib/first/docs/
//
-// This file is part of FRSH API
+// This file is part of FRSH (FRescor ScHeduler)
//
-// 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 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.
//
-// 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.
-//
-// 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.
-//
-// 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
-// License. This exception does not however invalidate any other
-// reasons why the executable file might be covered by the GNU General
-// Public License.
+// 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.
// -----------------------------------------------------------------------
//frsh_core_types.h
//==============================================
#define FRSH_CORE_TYPES_H_
#include <stdbool.h>
+#include "frsh_time_types.h"
#include "frsh_configuration_parameters.h"
#include "frsh_opaque_types.h"
#include "frsh_shared_objects_types.h"
#include "frsh_hierarchical_types.h"
#include "frsh_distributed_types.h"
#include "frsh_error.h"
-#include "frsh_fosa.h"
+
+#include "fosa.h"
+
+FRSH_CPP_BEGIN_DECLS
/**
* @file frsh_core_types.h
/*@{*/
+/** identifier of a frsh thread **/
+typedef fosa_thread_id_t frsh_thread_id_t;
+
+
+/** thread attributes object **/
+typedef fosa_thread_attr_t frsh_thread_attr_t;
+
+/**
+ * The type references a function that may become a thread's
+ * code
+ **/
+typedef fosa_thread_code_t frsh_thread_code_t;
+
+
+/** signal number; it is an integer type **/
+typedef fosa_signal_t frsh_signal_t;
+
+#define FRSH_NULL_SIGNAL FOSA_NULL_SIGNAL
+
+
+#define FRSH_SIGNAL_MIN FOSA_SIGNAL_MIN
+#define FRSH_SIGNAL_MAX FOSA_SIGNAL_MAX
+
+
+typedef fosa_signal_info_t frsh_signal_info_t;
+
+
/** Kind of workload expected in vres: bounded or indeterminate **/
typedef enum {
- FRSH_WT_BOUNDED,
- FRSH_WT_INDETERMINATE
+ FRSH_WT_BOUNDED = 0,
+ FRSH_WT_INDETERMINATE = 1,
+ FRSH_WT_SYNCHRONIZED = 2
} frsh_workload_t;
+/**
+ * In the synchronized workload the virtual resource hosts one or more
+ * threads that synchronize the execution of their jobs with the start
+ * of the virtual resource's period. In this kind of workload, once
+ * the threads that were activated at the beginning of the period
+ * finish their current job, the virtual resource may return any
+ * unused capacity to the system. This kind of workload can be
+ * scheduled using a regular periodic server that has the properties
+ * of being simple, having less overhead, and being able to increase
+ * the schedulability of periodic synchronized threads
+ **/
-#define FRSH_DEFAULT_WORKLOAD FRSH_WT_INDETERMINATE
-#define FRSH_DEFAULT_D_EQUALS_T false
-#define FRSH_DEFAULT_DEADLINE {0,0} //struct timespec
-
-
-#define FRSH_NULL_DEADLINE (struct timespec *)NULL
+#define FRSH_NULL_DEADLINE (frsh_rel_time_t *)NULL
// #define FRSH_NULL_SIGNAL 0 /* Defined at frsh_adaption.h */
/** Negotiation status: In_progress, rejected, admitted, not_requested **/
FRSH_RS_ADMITTED,
FRSH_RS_NOT_REQUESTED} frsh_renegotiation_status_t;
-
-
/**
* Vres Id type, that identifies a vres created to manage a given
* contract
**/
-typedef int frsh_vres_id_t; // => 0
+typedef FRSH_VRES_ID_T_OPAQUE frsh_vres_id_t; // => 0
/** Contract ressource type: processor, network, memory **/
typedef enum {
- FRSH_RT_PROCESSOR,
- FRSH_RT_NETWORK,
- FRSH_RT_MEMORY
+ FRSH_RT_PROCESSOR = 0,
+ FRSH_RT_NETWORK = 1,
+ FRSH_RT_MEMORY = 2,
+ FRSH_RT_DISK = 3,
+ FRSH_RT_FPGA = 4,
+ FRSH_RT_LCD = 5
} frsh_resource_type_t;
/** Ressource Id: processor_id or network_id **/
/**********************************************/
-typedef int frsh_resource_id_t;
-
-/** This defines 1 resource_id value for systems that have only one
- resource of a kind. **/
-#define FRSH_RESOURCE_ID_DEFAULT 0
+typedef fosa_resource_id_t frsh_resource_id_t;
/** Kind of contract: regular, background or dummy **/
-typedef enum {FRSH_CT_REGULAR, FRSH_CT_BACKGROUND, FRSH_CT_DUMMY} frsh_contract_type_t;
+typedef enum {
+ FRSH_CT_REGULAR = 0,
+ FRSH_CT_BACKGROUND = 1,
+ FRSH_CT_DUMMY = 2
+} frsh_contract_type_t;
-#define CONTRACT_LABEL_MAXLENGTH 15
-typedef char frsh_contract_label_t[CONTRACT_LABEL_MAXLENGTH + 1];
+// The name of this constant has been updated to have the FRSH_ prefix
+typedef char frsh_contract_label_t[FRSH_CONTRACT_LABEL_MAXLENGTH + 1];
/**
* Contract parameters type; it is an opaque type (i.e. the internal
/** List of vres **/
typedef struct {
int size;
- frsh_vres_id_t vres[FRSH_MAX_N_VRES];
+ frsh_vres_id_t vres[FRSH_MAX_GROUP_OPS];
} frsh_vres_group_t;
/** List of contracts to negotiate **/
typedef struct {
int size;
- frsh_contract_t* contracts[FRSH_MAX_N_VRES];
+ frsh_contract_t contracts[FRSH_MAX_GROUP_OPS];
} frsh_contracts_group_t;
-typedef struct {
- int size;
- frsh_contract_label_t contract_labels[FRSH_MAX_N_VRES];
-} frsh_contract_labels_group_t;
-
+typedef FRSH_GROUP_ID_T_OPAQUE frsh_group_id_t;
/**
* An abstract synchronization object is defined by the application.
/*@}*/
+FRSH_CPP_END_DECLS
#endif /* !FRSH_CORE_TYPES_H_ */
projects / frescor / frsh-include.git / blobdiff