err.h

   1 /*
   2  * libuci - Library for the Unified Configuration Interface
   3  * Copyright (C) 2008 Felix Fietkau <nbd@openwrt.org>
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU Lesser General Public License version 2.1
   7  * as published by the Free Software Foundation
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  */
  14
  15 /*
  16  * functions for debug and error handling, for internal use only
  17  */
  18
  19 #ifdef UCI_DEBUG
  20 #define DPRINTF(...) fprintf(stderr, __VA_ARGS__)
  21 #else
  22 #define DPRINTF(...)
  23 #endif
  24
  25 /*
  26  * throw an uci exception and store the error number
  27  * in the context.
  28  */
  29 #define UCI_THROW(ctx, err) do {        \
  30         DPRINTF("Exception: %s in %s, %s:%d\n", #err, __func__, __FILE__, __LINE__); \
  31         longjmp(ctx->trap, err);        \
  32 } while (0)
  33
  34 /*
  35  * store the return address for handling exceptions
  36  * needs to be called in every externally visible library function
  37  *
  38  * NB: this does not handle recursion at all. Calling externally visible
  39  * functions from other uci functions is only allowed at the end of the
  40  * calling function, or by wrapping the function call in UCI_TRAP_SAVE
  41  * and UCI_TRAP_RESTORE.
  42  */
  43 #define UCI_HANDLE_ERR(ctx) do {        \
  44         int __val = 0;                  \
  45         if (!ctx)                       \
  46                 return UCI_ERR_INVAL;   \
  47         if (!ctx->internal)             \
  48                 __val = setjmp(ctx->trap); \
  49         ctx->internal = false;          \
  50         if (__val) {                    \
  51                 ctx->errno = __val;     \
  52                 return __val;           \
  53         }                               \
  54 } while (0)
  55
  56 /*
  57  * In a block enclosed by UCI_TRAP_SAVE and UCI_TRAP_RESTORE, all exceptions
  58  * are intercepted and redirected to the label specified in 'handler'
  59  * after UCI_TRAP_RESTORE, or when reaching the 'handler' label, the old
  60  * exception handler is restored
  61  */
  62 #define UCI_TRAP_SAVE(ctx, handler) do {   \
  63         jmp_buf __old_trap;             \
  64         int __val;                      \
  65         memcpy(__old_trap, ctx->trap, sizeof(ctx->trap)); \
  66         __val = setjmp(ctx->trap);      \
  67         if (__val) {                    \
  68                 ctx->errno = __val;     \
  69                 memcpy(ctx->trap, __old_trap, sizeof(ctx->trap)); \
  70                 goto handler;           \
  71         }
  72 #define UCI_TRAP_RESTORE(ctx)           \
  73         memcpy(ctx->trap, __old_trap, sizeof(ctx->trap)); \
  74 } while(0)
  75
  76 /**
  77  * UCI_INTERNAL: Do an internal call of a public API function
  78  *
  79  * Sets Exception handling to passthrough mode.
  80  * Allows API functions to change behavior compared to public use
  81  */
  82 #define UCI_INTERNAL(func, ctx, ...) do { \
  83         ctx->internal = true;           \
  84         func(ctx, __VA_ARGS__);         \
  85 } while (0)
  86
  87 /*
  88  * check the specified condition.
  89  * throw an invalid argument exception if it's false
  90  */
  91 #define UCI_ASSERT(ctx, expr) do {      \
  92         if (!(expr)) {                  \
  93                 DPRINTF("[%s:%d] Assertion failed\n", __FILE__, __LINE__); \
  94                 UCI_THROW(ctx, UCI_ERR_INVAL);  \
  95         }                               \
  96 } while (0)
  97