2 * Copyright (c) 2001, 2003, 2005 - 2006 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
34 #include "krb5_locl.h"
36 RCSID("$Id: error_string.c 23274 2008-06-23 03:25:08Z lha $");
39 #define __attribute__(X)
41 void KRB5_LIB_FUNCTION
42 krb5_clear_error_string(krb5_context context)
44 HEIMDAL_MUTEX_lock(context->mutex);
45 if (context->error_string)
46 free(context->error_string);
47 context->error_code = 0;
48 context->error_string = NULL;
49 HEIMDAL_MUTEX_unlock(context->mutex);
53 * Set the context full error string for a specific error code.
55 * @param context Kerberos 5 context
56 * @param ret The error code
57 * @param fmt Error string for the error code
58 * @param ... printf(3) style parameters.
63 void KRB5_LIB_FUNCTION
64 krb5_set_error_message(krb5_context context, krb5_error_code ret,
66 __attribute__ ((format (printf, 3, 4)))
71 krb5_vset_error_message (context, ret, fmt, ap);
76 * Set the context full error string for a specific error code.
78 * @param context Kerberos 5 context
79 * @param ret The error code
80 * @param fmt Error string for the error code
81 * @param args printf(3) style parameters.
87 void KRB5_LIB_FUNCTION
88 krb5_vset_error_message (krb5_context context, krb5_error_code ret,
89 const char *fmt, va_list args)
90 __attribute__ ((format (printf, 3, 0)))
93 krb5_clear_error_string(context);
94 HEIMDAL_MUTEX_lock(context->mutex);
95 context->error_code = ret;
96 vasprintf(&context->error_string, fmt, args);
97 HEIMDAL_MUTEX_unlock(context->mutex);
102 * Return the error message in context. On error or no error string,
103 * the function returns NULL.
105 * @param context Kerberos 5 context
107 * @return an error string, needs to be freed with
108 * krb5_free_error_message(). The functions return NULL on error.
110 * @ingroup krb5_error
113 char * KRB5_LIB_FUNCTION
114 krb5_get_error_string(krb5_context context)
118 HEIMDAL_MUTEX_lock(context->mutex);
119 if (context->error_string)
120 ret = strdup(context->error_string);
121 HEIMDAL_MUTEX_unlock(context->mutex);
125 krb5_boolean KRB5_LIB_FUNCTION
126 krb5_have_error_string(krb5_context context)
129 HEIMDAL_MUTEX_lock(context->mutex);
130 str = context->error_string;
131 HEIMDAL_MUTEX_unlock(context->mutex);
136 * Return the error message for `code' in context. On memory
137 * allocation error the function returns NULL.
139 * @param context Kerberos 5 context
140 * @param code Error code related to the error
142 * @return an error string, needs to be freed with
143 * krb5_free_error_message(). The functions return NULL on error.
145 * @ingroup krb5_error
148 const char * KRB5_LIB_FUNCTION
149 krb5_get_error_message(krb5_context context, krb5_error_code code)
154 HEIMDAL_MUTEX_lock(context->mutex);
155 if (context->error_string &&
156 (code == context->error_code || context->error_code == 0))
158 str = strdup(context->error_string);
160 HEIMDAL_MUTEX_unlock(context->mutex);
164 HEIMDAL_MUTEX_unlock(context->mutex);
166 cstr = krb5_get_err_text(context, code);
170 if (asprintf(&str, "<unknown error: %d>", (int)code) == -1)
178 * Free the error message returned by krb5_get_error_message().
180 * @param context Kerberos context
181 * @param msg error message to free, returned byg
182 * krb5_get_error_message().
184 * @ingroup krb5_error
187 void KRB5_LIB_FUNCTION
188 krb5_free_error_message(krb5_context context, const char *msg)
190 free(rk_UNCONST(msg));
193 #ifndef HEIMDAL_SMALLER
196 * Free the error message returned by krb5_get_error_string(),
197 * deprecated, use krb5_free_error_message().
199 * @param context Kerberos context
200 * @param msg error message to free
202 * @ingroup krb5_error
205 void KRB5_LIB_FUNCTION __attribute__((deprecated))
206 krb5_free_error_string(krb5_context context, char *str)
208 krb5_free_error_message(context, str);
211 krb5_error_code KRB5_LIB_FUNCTION
212 krb5_set_error_string(krb5_context context, const char *fmt, ...)
213 __attribute__((format (printf, 2, 3))) __attribute__((deprecated))
218 krb5_vset_error_message (context, 0, fmt, ap);
223 krb5_error_code KRB5_LIB_FUNCTION
224 krb5_vset_error_string(krb5_context context, const char *fmt, va_list args)
225 __attribute__ ((format (printf, 2, 0))) __attribute__((deprecated))
227 krb5_vset_error_message(context, 0, fmt, args);
231 #endif /* !HEIMDAL_SMALLER */