1 /* Copyright (c) 2005-2015. The SimGrid Team.
2 * All rights reserved. */
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. */
9 /* This code is inspirated from the OSSP version (as retrieved back in 2004)*/
10 /* It was heavily modified to fit the SimGrid framework. */
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/>
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/.
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
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
40 /* The extensions made for the SimGrid project can either be distributed */
41 /* under the same license, or under the LGPL v2.1 */
49 #include "xbt/sysdep.h"
51 #include "xbt/virtu.h"
53 /*-*-* Emergency debuging: define this when the exceptions get crazy *-*-*/
58 # define MAYDAY_SAVE(m) printf("%d %s:%d save %p\n", \
59 xbt_getpid(), __FILE__, __LINE__, \
62 # define MAYDAY_RESTORE(m) printf("%d %s:%d restore %p\n", \
63 xbt_getpid(), __FILE__, __LINE__, \
66 # define MAYDAY_CATCH(e) printf("%d %s:%d Catched '%s'\n", \
67 xbt_getpid(), __FILE__, __LINE__, \
71 # define MAYDAY_SAVE(m)
72 # define MAYDAY_RESTORE(m)
73 # define MAYDAY_CATCH(e)
75 /*-*-* end of debugging stuff *-*-*/
77 /** @addtogroup XBT_ex_c
78 * @brief Exceptions support (C)
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.
85 /** Categories of errors
87 * This very similar to std::error_catgory and should probably be replaced
88 * by this in the future.
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 */
111 /** Get the name of a category
114 XBT_PUBLIC(const char *) xbt_ex_catname(xbt_errcat_t cat);
116 typedef struct xbt_ex xbt_ex_t;
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;
121 /** Builds and throws an exception
125 #define THROW(c, v) { _xbt_throw(NULL, (xbt_errcat_t) c, v, __FILE__, __LINE__, __func__); }
127 /** Builds and throws an exception with a printf-like formatted message
131 #define THROWF(c, v, ...) _xbt_throw(bprintf(__VA_ARGS__), (xbt_errcat_t) c, v, __FILE__, __LINE__, __func__)
133 /** Throw an exception because someting impossible happened
136 #define THROW_IMPOSSIBLE \
137 THROWF(unknown_error, 0, "The Impossible Did Happen (yet again)")
139 /** Throw an exception because someting unimplemented stuff has been attempted
142 #define THROW_UNIMPLEMENTED \
143 THROWF(unknown_error, 0, "Function %s unimplemented",__func__)
145 /** Throw an exception because some dead code was reached
148 #define THROW_DEADCODE \
149 THROWF(unknown_error, 0, "Function %s was supposed to be DEADCODE, but it's not",__func__)
151 /** Die because something impossible happened
154 #define DIE_IMPOSSIBLE xbt_die("The Impossible Did Happen (yet again)")
156 /** Display an exception */
157 XBT_PUBLIC(void) xbt_ex_display(xbt_ex_t * e);
162 #endif /* __XBT_EX_H__ */