// -----------------------------------------------------------------------
+// Copyright (C) 2006 - 2007 FRESCOR consortium partners:
+//
+// Universidad de Cantabria, SPAIN
+// University of York, UK
+// Scuola Superiore Sant'Anna, ITALY
+// Kaiserslautern University, GERMANY
+// Univ. Politécnica Valencia, SPAIN
+// Czech Technical University in Prague, CZECH REPUBLIC
+// ENEA SWEDEN
+// Thales Communication S.A. FRANCE
+// 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
+// in part by the European Union Sixth Framework Programme
+// The European Union is not liable of any use that may be
+// made of this code.
+//
+//
+// 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
// University of York, UK
//
-// FRSH API web pages: http://marte.unican.es/frsh/docs/
+// 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_error.h
//==============================================
-// ******** ******* ******** ** **
-// **///// /**////** **////// /** /**
-// ** /** /** /** /** /**
-// ******* /******* /*********/**********
-// **//// /**///** ////////**/**//////**
-// ** /** //** /**/** /**
-// ** /** //** ******** /** /**
-// // // // //////// // //
+// ******** ******* ******** ** **
+// **///// /**////** **////// /** /**
+// ** /** /** /** /** /**
+// ******* /******* /********* /**********
+// **//// /**///** ////////** /**//////**
+// ** /** //** /** /** /**
+// ** /** //** ******** /** /**
+// // // // //////// // //
//
// FRSH(FRescor ScHeduler), pronounced "fresh"
-//================================================
+//==============================================
#ifndef FRSH_ERROR_H_
#define FRSH_ERROR_H_
+/**
+ * @file frsh_error.h
+ **/
+
/**
* addtogroup core
*
**/
/* Error codes */
+#define FRSH_NO_ERROR 0
+
#define FRSH_ERR_BASE_VALUE 0x02004000
#define FRSH_ERR_TOO_MANY_TASKS 0x02004001
#define FRSH_ERR_NOT_SCHEDULED_CALLING_THREAD 0x02004006
#define FRSH_ERR_NOT_BOUND 0x02004007
#define FRSH_ERR_UNKNOWN_SCHEDULED_THREAD 0x02004008
-#define FRSH_ERR_NOT_CONTRACTED_SERVER 0x02004009
+#define FRSH_ERR_NOT_CONTRACTED_VRES 0x02004009
#define FRSH_ERR_NOT_SCHEDULED_THREAD 0x0200400A
#define FRSH_ERR_TOO_MANY_SERVICE_JOBS 0x0200400B
#define FRSH_ERR_TOO_MANY_SYNCH_OBJS 0x0200400C
-#define FRSH_ERR_TOO_MANY_SERVERS_IN_SYNCH_OBJ 0x0200400D
+#define FRSH_ERR_TOO_MANY_VRES_IN_SYNCH_OBJ 0x0200400D
#define FRSH_ERR_TOO_MANY_EVENTS_IN_SYNCH_OBJ 0x0200400E
#define FRSH_ERR_INTERNAL_ERROR 0x0200400F
-#define FRSH_ERR_TOO_MANY_SERVERS 0x02004010
+#define FRSH_ERR_TOO_MANY_VRES 0x02004010
#define FRSH_ERR_INVALID_SCHEDULER_REPLY 0x02004011
#define FRSH_ERR_TOO_MANY_PENDING_REPLENISHMENTS 0x02004012
#define FRSH_ERR_SYSTEM_ALREADY_INITIALIZED 0x02004013
#define FRSH_ERR_SHARED_OBJ_ALREADY_INITIALIZED 0x02004014
#define FRSH_ERR_SHARED_OBJ_NOT_INITIALIZED 0x02004015
#define FRSH_ERR_SCHED_POLICY_NOT_COMPATIBLE 0x02004016
-#define FRSH_ERR_SERVER_WORKLOAD_NOT_COMPATIBLE 0x02004017
+#define FRSH_ERR_VRES_WORKLOAD_NOT_COMPATIBLE 0x02004017
#define FRSH_ERR_ALREADY_BOUND 0x02004018
-#define FRSH_ERR_WRONG_NETWORK 0x02004019
+#define FRSH_ERR_RESOURCE_ID_INVALID 0x02004019
#define FRSH_ERR_TOO_LARGE 0x0200401A
#define FRSH_ERR_BUFFER_FULL 0x0200401B
#define FRSH_ERR_NO_SPACE 0x0200401C
#define FRSH_ERR_NO_MESSAGES 0x0200401D
#define FRSH_WRN_MODULE_NOT_SUPPORTED 0x0200401E
-#define FRSH_ERR_SYSTEM_NOT_INITIALIZED 0x0200401F
+#define FRSH_ERR_NOT_INITIALIZED 0x0200401F
#define FRSH_ERR_TOO_MANY_SHARED_OBJS 0x02004020
+#define FRSH_ERR_CONTRACT_LABEL_ALREADY_EXISTS 0x02004021
+#define FRSH_ERR_BUDGET_EXPIRED 0x02004022
+#define FRSH_ERR_SHARED_OBJECT_NOT_PROTECTED 0x02004023
+#define FRSH_ERR_NOT_IMPLEMENTED 0x02004024
+#define FRSH_ERR_CONTRACT_TYPE_NOT_COMPATIBLE 0x02004025
+#define FRSH_ERR_CAPACITY_NOT_DECREASING 0x02004026
+#define FRSH_ERR_CONTRACT_LABEL_UNKNOWN 0x02004027
+
+#define FRSH_ERR_LAST_VALUE 0x02004028
+
+#define ERROR(nn,ss) do {if(nn>FRSH_ERR_BASE_VALUE) my_frsh_strerror(nn, ss); else perror(ss); exit (nn);} while (0)
+
-#define FRSH_ERR_LAST_VALUE 0x02004020
int frsh_strerror (int error, char *message, size_t size);
+void my_frsh_strerror(int error, char *sss);
+
+
+/**
+ * This str_helper is needed to ensure argument expansion,
+ * see http://www.iar.com/p180591/p180591_eng.php
+ **/
+#define STR_HELPER(x) #x
+
+/**
+ * PERROR_FRESCOR
+ *
+ * This macro checks the given error number and composes a messages accordingly.
+ *
+ * @param nn Error number
+ * @param ss Error string (to be appended to FRSH or system error string)
+ **/
+#define PERROR_FRESCOR(_nn_,_ss_) do { \
+ \
+ char error_string[1024]; \
+ \
+ sprintf(error_string, "File: %s, in function %s at line %d, error %d: %s\n", __FILE__, __FUNCTION__, __LINE__, (_nn_), _ss_); \
+ \
+ if( (_nn_)>FRSH_ERR_BASE_VALUE ) { \
+ my_frsh_strerror( (_nn_), error_string); \
+ } else { \
+ perror(error_string); \
+ } \
+} while(0)
+
+
+
+/**
+ * PERROR_AND_RETURN
+ *
+ * Macro that displays an error code and message and then returns from
+ * the current function
+ *
+ * @param nn Error number
+ * @param ss Error string (to be appended to FRSH or system error string)
+ **/
+#define PERROR_AND_RETURN(nn,ss) do { \
+ PERROR_FRESCOR(nn, ss); \
+ return (nn); \
+ } while (0)
+
+
+
+
+/**
+ * PERROR_AND_EXIT
+ *
+ * Macro that displays an error code and message and then aborts the
+ * program.
+ *
+ * @param nn Error number
+ * @param ss Error string (to be appended to FRSH or system error string)
+ **/
+#define PERROR_AND_EXIT(nn,ss) do { \
+ PERROR_FRESCOR(nn,ss); \
+ exit(nn); \
+ } while (0)
+
+
+/**
+ * PRW: Perror and Return Wrapper
+ *
+ * Function that calls funccall and checks the result != 0.
+ * In case of error it displays the error code with the function call
+ * as extra error string and returns from the function.
+ *
+ * terror (int) needs to be visible in the point of call.
+ *
+ * @param funccall Code to execute that should return 0 in a non error
+ * case.
+ **/
+#define PRW(funccall) do { \
+ if ( (terror = funccall ) != 0) \
+ { \
+ PERROR_AND_RETURN( terror, STR_HELPER(funccall) ); \
+ } \
+} while(0)
+
+
+
+/**
+ * PXW: Perror and eXit Wrapper
+ *
+ * Function that calls funccall and checks the result != 0.
+ * In case of error it displays the error code with the function call
+ * as extra error string and ABORTS the program.
+ *
+ * terror (int) needs to be visible in the point of call.
+ *
+ * @param funccall Code to execute that should return 0 in a non error
+ * case.
+ **/
+#define PXW(funccall) do { \
+ if ( (terror = funccall ) != 0) \
+ { \
+ PERROR_AND_EXIT( terror, STR_HELPER(funccall) ); \
+ } \
+} while(0)
+
+
+
+/**
+ * PERROR_KERN_AND_EXIT
+ *
+ * Function that displays an error code and message and then aborts the
+ * program.
+ *
+ * @param nn Error number
+ * @param ss Error string (to be appended to FRSH or system error string)
+ **/
+#define PERROR_KERN_AND_EXIT(nn, ss) do { \
+ errno = errno ? errno : (nn); \
+ kern_printf(ss); \
+ exit(nn); \
+ } while (0)
+
+
+
/*}*/
projects / frescor / frsh-include.git / blobdiff