2 * Copyright (C) 2004, 2005, 2007-2009 Internet Systems Consortium, Inc. ("ISC")
3 * Copyright (C) 1997-2001 Internet Software Consortium.
5 * Permission to use, copy, modify, and/or distribute this software for any
6 * purpose with or without fee is hereby granted, provided that the above
7 * copyright notice and this permission notice appear in all copies.
9 * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
10 * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
11 * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
12 * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
13 * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14 * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
15 * PERFORMANCE OF THIS SOFTWARE.
18 /* $Id: assertions.c,v 1.26 2009/09/29 15:06:07 fdupont Exp $ */
27 #include <isc/assertions.h>
28 #include <isc/backtrace.h>
30 #include <isc/result.h>
33 * The maximum number of stack frames to dump on assertion failure.
35 #ifndef BACKTRACE_MAXFRAME
36 #define BACKTRACE_MAXFRAME 128
43 default_callback(const char *, int, isc_assertiontype_t, const char *);
45 static isc_assertioncallback_t isc_assertion_failed_cb = default_callback;
51 /*% assertion failed handler */
54 isc_assertion_failed(const char *file, int line, isc_assertiontype_t type,
57 isc_assertion_failed_cb(file, line, type, cond);
64 isc_assertion_setcallback(isc_assertioncallback_t cb) {
66 isc_assertion_failed_cb = default_callback;
68 isc_assertion_failed_cb = cb;
73 isc_assertion_typetotext(isc_assertiontype_t type) {
77 * These strings have purposefully not been internationalized
78 * because they are considered to essentially be keywords of
79 * the ISC development environment.
82 case isc_assertiontype_require:
85 case isc_assertiontype_ensure:
88 case isc_assertiontype_insist:
91 case isc_assertiontype_invariant:
105 default_callback(const char *file, int line, isc_assertiontype_t type,
108 void *tracebuf[BACKTRACE_MAXFRAME];
110 const char *logsuffix = ".";
114 result = isc_backtrace_gettrace(tracebuf, BACKTRACE_MAXFRAME, &nframes);
115 if (result == ISC_R_SUCCESS && nframes > 0)
116 logsuffix = ", back trace";
118 fprintf(stderr, "%s:%d: %s(%s) %s%s\n",
119 file, line, isc_assertion_typetotext(type), cond,
120 isc_msgcat_get(isc_msgcat, ISC_MSGSET_GENERAL,
121 ISC_MSG_FAILED, "failed"), logsuffix);
122 if (result == ISC_R_SUCCESS) {
123 for (i = 0; i < nframes; i++) {
124 unsigned long offset;
127 result = isc_backtrace_getsymbol(tracebuf[i], &fname,
129 if (result == ISC_R_SUCCESS) {
130 fprintf(stderr, "#%d %p in %s()+0x%lx\n", i,
131 tracebuf[i], fname, offset);
133 fprintf(stderr, "#%d %p in ??\n", i,