2 * useful common stuff, mostly error handling and debugging
5 * This is part of ypp-sc-tools, a set of third-party tools for assisting
6 * players of Yohoho Puzzle Pirates.
8 * Copyright (C) 2009 Ian Jackson <ijackson@chiark.greenend.org.uk>
10 * This program is free software: you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation, either version 3 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program. If not, see <http://www.gnu.org/licenses/>.
23 * Yohoho and Puzzle Pirates are probably trademarks of Three Rings and
24 * are used without permission. This program is not endorsed or
25 * sponsored by Three Rings.
52 #include <sys/types.h>
56 const struct RgbImage *rgb;
61 /*----- debugging arrangements, rather contingent -----*/
67 typedef struct { /* both inclusive */
72 #define RECT_W(r) ((r).br.x - (r).tl.x + 1)
73 #define RECT_H(r) ((r).br.y - (r).tl.y + 1)
77 #define DEBUG_FLAG_LIST \
89 #define DF(f) dbg__shift_##f,
94 #define DF(f) dbg_##f = 1 << dbg__shift_##f,
101 #define DEBUGP(f) (!!(debug_flags & dbg_##f))
103 void debug_flush(void);
106 const char *get_vardir(void);
107 const char *get_libdir(void);
109 #define FMT(f,a) __attribute__((format(printf,f,a)))
110 #define SCANFMT(f,a) __attribute__((format(scanf,f,a)))
111 #define NORET __attribute__((noreturn))
113 #define DEFINE_VWRAPPERF(decls, funcf, otherattribs) \
114 decls void funcf(const char *fmt, ...) FMT(1,2) otherattribs; \
115 decls void funcf(const char *fmt, ...) { \
116 va_list al; va_start(al,fmt); v##funcf(fmt,al); va_end(al); \
119 #define DEBUG_DEFINE_SOME_DEBUGF(fl,funcf) \
120 static void v##funcf(const char *fmt, va_list al) { \
122 vfprintf(debug,fmt,al); \
124 DEFINE_VWRAPPERF(static, funcf, )
126 #define DEBUG_DEFINE_DEBUGF(fl) DEBUG_DEFINE_SOME_DEBUGF(fl,debugf)
129 /*---------- error handling ----------*/
131 void vfatal(const char *fmt, va_list) FMT(1,0) NORET;
132 void fatal(const char *fmt, ...) FMT(1,2) NORET;
134 #define sysassert(what) \
135 ((what) ? (void)0 : sysassert_fail(__FILE__, __LINE__, #what))
137 void sysassert_fail(const char *file, int line, const char *what)
138 __attribute__((noreturn));
140 void waitpid_check_exitstatus(pid_t pid, const char *what, int sigpipeok);
143 void *mmalloc(size_t sz);
144 void *mrealloc(void *p, size_t sz);
147 #define dbassert(x) ((x) ? (void)0 : dbfile_assertfail(__FILE__,__LINE__,#x))
148 void dbfile_assertfail(const char *file, int line, const char *m) NORET;
151 void dbfile_getsline(char *lbuf, size_t lbufsz, const char *file, int line);
152 int dbfile_open(const char *tpath); /* 0: ENOENT; 1: worked */
153 int dbfile_gzopen(const char *tpath); /* 0: ENOENT; 1: worked */
154 void dbfile_close(void); /* idempotent */
156 int dbfile_scanf(const char *fmt, ...) SCANFMT(1,2);
157 int dbfile_vscanf(const char *fmt, va_list al) SCANFMT(1,0);
159 int gzopen(const char *zpath, int oflags, FILE **f_r, pid_t *pid_r,
160 const char *gziplevel /* 0 for read; may be 0, or "-1" etc. */);
161 /* returns errno value from open */
162 void gzclose(FILE **f, pid_t *p, const char *what);
163 /* also OK with f==0, or p==-1 */
165 char *masprintf(const char *fmt, ...) FMT(1,2);
167 #define EXECLP_HELPER(helper, ...) do{ \
168 char *helper_path= masprintf("%s/%s",get_libdir(),helper); \
169 execlp(helper_path,helper, __VA_ARGS__); \
170 sysassert(errno==ENOENT); \
171 fatal("Failed to find helper program %s.\n" \
172 "(Are you in the correct directory?)", helper); \
176 #define ARRAYSIZE(a) ((sizeof((a)) / sizeof((a)[0])))
177 #define FILLZERO(obj) (memset(&(obj),0,sizeof((obj))))
179 #define STRING2(x) #x
180 #define STRING(x) STRING2(x)