include/xbt/ex.h

   1 /* Copyright (c) 2005-2015. The SimGrid Team.
   2  * All rights reserved.                                                     */
   3
   4 /*  Copyright (c) 2002-2004 Ralf S. Engelschall <rse@engelschall.com>       */
   5 /*  Copyright (c) 2002-2004 The OSSP Project <http://www.ossp.org/>         */
   6 /*  Copyright (c) 2002-2004 Cable & Wireless <http://www.cw.com/>           */
   7 /*  All rights reserved.                                                    */
   8
   9 /* This code is inspirated from the OSSP version (as retrieved back in 2004)*/
  10 /* It was heavily modified to fit the SimGrid framework.                    */
  11
  12 /* The OSSP version has the following copyright notice:
  13 **  OSSP ex - Exception Handling
  14 **  Copyright (c) 2002-2004 Ralf S. Engelschall <rse@engelschall.com>
  15 **  Copyright (c) 2002-2004 The OSSP Project <http://www.ossp.org/>
  16 **  Copyright (c) 2002-2004 Cable & Wireless <http://www.cw.com/>
  17 **
  18 **  This file is part of OSSP ex, an exception handling library
  19 **  which can be found at http://www.ossp.org/pkg/lib/ex/.
  20 **
  21 **  Permission to use, copy, modify, and distribute this software for
  22 **  any purpose with or without fee is hereby granted, provided that
  23 **  the above copyright notice and this permission notice appear in all
  24 **  copies.
  25 **
  26 **  THIS SOFTWARE IS PROVIDED `AS IS'' AND ANY EXPRESSED OR IMPLIED
  27 **  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  28 **  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  29 **  IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
  30 **  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  31 **  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  32 **  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  33 **  USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  34 **  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  35 **  OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  36 **  OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  37 **  SUCH DAMAGE.
  38  */
  39
  40 /* The extensions made for the SimGrid project can either be distributed    */
  41 /* under the same license, or under the LGPL v2.1                           */
  42
  43 #ifndef __XBT_EX_H__
  44 #define __XBT_EX_H__
  45
  46 #include <stdlib.h>
  47
  48 #include "xbt/base.h"
  49 #include "xbt/sysdep.h"
  50 #include "xbt/misc.h"
  51 #include "xbt/virtu.h"
  52
  53 /*-*-* Emergency debuging: define this when the exceptions get crazy *-*-*/
  54 #undef __EX_MAYDAY
  55 #ifdef __EX_MAYDAY
  56 # include <stdio.h>
  57 #include <errno.h>
  58 #  define MAYDAY_SAVE(m)    printf("%d %s:%d save %p\n",                \
  59                                    xbt_getpid(), __FILE__, __LINE__,    \
  60                                    (m)->jb                              \
  61                                   ),
  62 #  define MAYDAY_RESTORE(m) printf("%d %s:%d restore %p\n",             \
  63                                    xbt_getpid(), __FILE__, __LINE__,    \
  64                                    (m)->jb                              \
  65                                   ),
  66 #  define MAYDAY_CATCH(e)   printf("%d %s:%d Catched '%s'\n",           \
  67                                    xbt_getpid(), __FILE__, __LINE__,    \
  68                                    (e).msg                              \
  69           ),
  70 #else
  71 #  define MAYDAY_SAVE(m)
  72 #  define MAYDAY_RESTORE(m)
  73 #  define MAYDAY_CATCH(e)
  74 #endif
  75 /*-*-* end of debugging stuff *-*-*/
  76
  77 /** @addtogroup XBT_ex_c
  78  *  @brief Exceptions support (C)
  79  *
  80  *  Those fonctions are used to throw C++ exceptions from C code. This feature
  81  *  should probably be removed in the future because C and exception do not
  82  *  exactly play nicely together.
  83  */
  84
  85 /** Categories of errors
  86  *
  87  *  This very similar to std::error_catgory and should probably be replaced
  88  *  by this in the future.
  89  *
  90  *  @ingroup XBT_ex_c
  91  */
  92 typedef enum {
  93   unknown_error = 0,            /**< unknown error */
  94   arg_error,                    /**< Invalid argument */
  95   bound_error,                  /**< Out of bounds argument */
  96   mismatch_error,               /**< The provided ID does not match */
  97   not_found_error,              /**< The searched element was not found */
  98   system_error,                 /**< a syscall did fail */
  99   network_error,                /**< error while sending/receiving data */
 100   timeout_error,                /**< not quick enough, dude */
 101   cancel_error,                 /**< an action was canceled */
 102   thread_error,                 /**< error while [un]locking */
 103   host_error,                   /**< host failed */
 104   tracing_error,                /**< error during the simulation tracing */
 105   io_error,                     /**< disk or file error */
 106   vm_error                      /**< vm  error */
 107 } xbt_errcat_t;
 108
 109 SG_BEGIN_DECL()
 110
 111 /** Get the name of a category
 112  *  @ingroup XBT_ex_c
 113  */
 114 XBT_PUBLIC(const char *) xbt_ex_catname(xbt_errcat_t cat);
 115
 116 typedef struct xbt_ex xbt_ex_t;
 117
 118 /** Helper function used to throw exceptions in C */
 119 XBT_PUBLIC(void) _xbt_throw(char* message, xbt_errcat_t errcat, int value, const char* file, int line, const char* func) XBT_ATTRIB_NORETURN;
 120
 121 /** Builds and throws an exception
 122  *  @ingroup XBT_ex_c
 123  *  @hideinitializer
 124  */
 125 #define THROW(c, v)             { _xbt_throw(NULL, (xbt_errcat_t) c, v, __FILE__, __LINE__, __func__); }
 126
 127 /** Builds and throws an exception with a printf-like formatted message
 128  *  @ingroup XBT_ex_c
 129  *  @hideinitializer
 130  */
 131 #define THROWF(c, v, ...)       _xbt_throw(bprintf(__VA_ARGS__), (xbt_errcat_t) c, v, __FILE__, __LINE__, __func__)
 132
 133 /** Throw an exception because someting impossible happened
 134  *  @ingroup XBT_ex_c
 135  */
 136 #define THROW_IMPOSSIBLE \
 137   THROWF(unknown_error, 0, "The Impossible Did Happen (yet again)")
 138
 139 /** Throw an exception because someting unimplemented stuff has been attempted
 140  *  @ingroup XBT_ex_c
 141  */
 142 #define THROW_UNIMPLEMENTED \
 143   THROWF(unknown_error, 0, "Function %s unimplemented",__func__)
 144
 145 /** Throw an exception because some dead code was reached
 146  *  @ingroup XBT_ex_c
 147  */
 148 #define THROW_DEADCODE \
 149   THROWF(unknown_error, 0, "Function %s was supposed to be DEADCODE, but it's not",__func__)
 150
 151 /** Die because something impossible happened
 152  *  @ingroup XBT_ex_c
 153  */
 154 #define DIE_IMPOSSIBLE xbt_die("The Impossible Did Happen (yet again)")
 155
 156 /** Display an exception */
 157 XBT_PUBLIC(void) xbt_ex_display(xbt_ex_t * e);
 158
 159 SG_END_DECL()
 160
 161 /** @} */
 162 #endif                          /* __XBT_EX_H__ */