xref: /freebsd/contrib/ntp/libntp/lib/isc/include/isc/error.h (revision a57ca37dd1848cd42844d9082c4a74c2ed57f68a)
1 /*
2  * Copyright (C) 2004-2007, 2009  Internet Systems Consortium, Inc. ("ISC")
3  * Copyright (C) 1998-2001  Internet Software Consortium.
4  *
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.
8  *
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.
16  */
17 
18 /* $Id: error.h,v 1.22 2009/09/29 23:48:04 tbox Exp $ */
19 
20 #ifndef ISC_ERROR_H
21 #define ISC_ERROR_H 1
22 
23 /*! \file isc/error.h */
24 
25 #include <stdarg.h>
26 
27 #include <isc/formatcheck.h>
28 #include <isc/lang.h>
29 #include <isc/platform.h>
30 
31 ISC_LANG_BEGINDECLS
32 
33 typedef void (*isc_errorcallback_t)(const char *, int, const char *, va_list);
34 
35 /*% set unexpected error */
36 void
37 isc_error_setunexpected(isc_errorcallback_t);
38 
39 /*% set fatal error */
40 void
41 isc_error_setfatal(isc_errorcallback_t);
42 
43 /*% unexpected error */
44 void
45 isc_error_unexpected(const char *, int, const char *, ...)
46      ISC_FORMAT_PRINTF(3, 4);
47 
48 /*% fatal error */
49 ISC_PLATFORM_NORETURN_PRE void
50 isc_error_fatal(const char *, int, const char *, ...)
51 ISC_FORMAT_PRINTF(3, 4) ISC_PLATFORM_NORETURN_POST;
52 
53 /*% runtimecheck error */
54 void
55 isc_error_runtimecheck(const char *, int, const char *);
56 
57 #define ISC_ERROR_RUNTIMECHECK(cond) \
58 	((void) ((cond) || \
59 		 ((isc_error_runtimecheck)(__FILE__, __LINE__, #cond), 0)))
60 
61 ISC_LANG_ENDDECLS
62 
63 #endif /* ISC_ERROR_H */
64