2
* Copyright (c) 2006 - 2007 Kungliga Tekniska Högskolan
3
* (Royal Institute of Technology, Stockholm, Sweden).
6
* Redistribution and use in source and binary forms, with or without
7
* modification, are permitted provided that the following conditions
10
* 1. Redistributions of source code must retain the above copyright
11
* notice, this list of conditions and the following disclaimer.
13
* 2. Redistributions in binary form must reproduce the above copyright
14
* notice, this list of conditions and the following disclaimer in the
15
* documentation and/or other materials provided with the distribution.
17
* 3. Neither the name of the Institute nor the names of its contributors
18
* may be used to endorse or promote products derived from this software
19
* without specific prior written permission.
21
* THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
22
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24
* ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
25
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38
* @page page_error Hx509 error reporting functions
40
* See the library functions here: @ref hx509_error
43
struct hx509_error_data {
50
free_error_string(hx509_error msg)
53
hx509_error m2 = msg->next;
61
* Resets the error strings the hx509 context.
63
* @param context A hx509 context.
65
* @ingroup hx509_error
69
hx509_clear_error_string(hx509_context context)
71
free_error_string(context->error);
72
context->error = NULL;
76
* Add an error message to the hx509 context.
78
* @param context A hx509 context.
80
* - HX509_ERROR_APPEND appends the error string to the old messages
82
* @param code error code related to error message
83
* @param fmt error message format
84
* @param ap arguments to error message format
86
* @ingroup hx509_error
90
hx509_set_error_stringv(hx509_context context, int flags, int code,
91
const char *fmt, va_list ap)
95
msg = calloc(1, sizeof(*msg));
97
hx509_clear_error_string(context);
101
if (vasprintf(&msg->msg, fmt, ap) == -1) {
102
hx509_clear_error_string(context);
108
if (flags & HX509_ERROR_APPEND) {
109
msg->next = context->error;
110
context->error = msg;
112
free_error_string(context->error);
113
context->error = msg;
118
* See hx509_set_error_stringv().
120
* @param context A hx509 context.
122
* - HX509_ERROR_APPEND appends the error string to the old messages
124
* @param code error code related to error message
125
* @param fmt error message format
126
* @param ... arguments to error message format
128
* @ingroup hx509_error
132
hx509_set_error_string(hx509_context context, int flags, int code,
133
const char *fmt, ...)
138
hx509_set_error_stringv(context, flags, code, fmt, ap);
143
* Get an error string from context associated with error_code.
145
* @param context A hx509 context.
146
* @param error_code Get error message for this error code.
148
* @return error string, free with hx509_free_error_string().
150
* @ingroup hx509_error
154
hx509_get_error_string(hx509_context context, int error_code)
156
struct rk_strpool *p = NULL;
157
hx509_error msg = context->error;
159
if (msg == NULL || msg->code != error_code) {
163
cstr = com_right(context->et_list, error_code);
166
cstr = strerror(error_code);
169
if (asprintf(&str, "<unknown error: %d>", error_code) == -1)
174
for (msg = context->error; msg; msg = msg->next)
175
p = rk_strpoolprintf(p, "%s%s", msg->msg,
176
msg->next != NULL ? "; " : "");
178
return rk_strpoolcollect(p);
182
* Free error string returned by hx509_get_error_string().
184
* @param str error string to free.
186
* @ingroup hx509_error
190
hx509_free_error_string(char *str)
196
* Print error message and fatally exit from error code
198
* @param context A hx509 context.
199
* @param exit_code exit() code from process.
200
* @param error_code Error code for the reason to exit.
201
* @param fmt format string with the exit message.
202
* @param ... argument to format string.
204
* @ingroup hx509_error
208
hx509_err(hx509_context context, int exit_code,
209
int error_code, const char *fmt, ...)
216
vasprintf(&str, fmt, ap);
218
msg = hx509_get_error_string(context, error_code);
222
errx(exit_code, "%s: %s", str, msg);