xref: /openbmc/qemu/util/error.c (revision 8714d366e7e29d3ca8cebc8504e18c4cd7b5cf48) 
1 /*
2  * QEMU Error Objects
3  *
4  * Copyright IBM, Corp. 2011
5  * Copyright (C) 2011-2015 Red Hat, Inc.
6  *
7  * Authors:
8  *  Anthony Liguori   <aliguori@us.ibm.com>
9  *  Markus Armbruster <armbru@redhat.com>,
10  *
11  * This work is licensed under the terms of the GNU LGPL, version 2.  See
12  * the COPYING.LIB file in the top-level directory.
13  */
14 
15 #include "qemu/osdep.h"
16 #include "qapi/error.h"
17 #include "qemu/error-report.h"
18 #include "qapi/error-internal.h"
19 
20 Error *error_abort;
21 Error *error_fatal;
22 Error *error_warn;
23 
24 static void error_handle(Error **errp, Error *err)
25 {
26     if (errp == &error_abort) {
27         fprintf(stderr, "Unexpected error in %s() at %s:%d:\n",
28                 err->func, err->src, err->line);
29         error_report("%s", error_get_pretty(err));
30         if (err->hint) {
31             error_printf("%s", err->hint->str);
32         }
33         abort();
34     }
35     if (errp == &error_fatal) {
36         error_report_err(err);
37         exit(1);
38     }
39     if (errp == &error_warn) {
40         warn_report_err(err);
41     } else if (errp && !*errp) {
42         *errp = err;
43     } else {
44         error_free(err);
45     }
46 }
47 
48 G_GNUC_PRINTF(6, 0)
49 static void error_setv(Error **errp,
50                        const char *src, int line, const char *func,
51                        ErrorClass err_class, const char *fmt, va_list ap,
52                        const char *suffix)
53 {
54     Error *err;
55     int saved_errno = errno;
56 
57     if (errp == NULL) {
58         return;
59     }
60     assert(*errp == NULL);
61 
62     err = g_malloc0(sizeof(*err));
63     err->msg = g_strdup_vprintf(fmt, ap);
64     if (suffix) {
65         char *msg = err->msg;
66         err->msg = g_strdup_printf("%s: %s", msg, suffix);
67         g_free(msg);
68     }
69     err->err_class = err_class;
70     err->src = src;
71     err->line = line;
72     err->func = func;
73 
74     error_handle(errp, err);
75 
76     errno = saved_errno;
77 }
78 
79 void error_set_internal(Error **errp,
80                         const char *src, int line, const char *func,
81                         ErrorClass err_class, const char *fmt, ...)
82 {
83     va_list ap;
84 
85     va_start(ap, fmt);
86     error_setv(errp, src, line, func, err_class, fmt, ap, NULL);
87     va_end(ap);
88 }
89 
90 void error_setg_internal(Error **errp,
91                          const char *src, int line, const char *func,
92                          const char *fmt, ...)
93 {
94     va_list ap;
95 
96     va_start(ap, fmt);
97     error_setv(errp, src, line, func, ERROR_CLASS_GENERIC_ERROR, fmt, ap, NULL);
98     va_end(ap);
99 }
100 
101 void error_setg_errno_internal(Error **errp,
102                                const char *src, int line, const char *func,
103                                int os_errno, const char *fmt, ...)
104 {
105     va_list ap;
106     int saved_errno = errno;
107 
108     va_start(ap, fmt);
109     error_setv(errp, src, line, func, ERROR_CLASS_GENERIC_ERROR, fmt, ap,
110                os_errno != 0 ? strerror(os_errno) : NULL);
111     va_end(ap);
112 
113     errno = saved_errno;
114 }
115 
116 void error_setg_file_open_internal(Error **errp,
117                                    const char *src, int line, const char *func,
118                                    int os_errno, const char *filename)
119 {
120     error_setg_errno_internal(errp, src, line, func, os_errno,
121                               "Could not open '%s'", filename);
122 }
123 
124 void error_vprepend(Error *const *errp, const char *fmt, va_list ap)
125 {
126     GString *newmsg;
127 
128     if (!errp) {
129         return;
130     }
131 
132     newmsg = g_string_new(NULL);
133     g_string_vprintf(newmsg, fmt, ap);
134     g_string_append(newmsg, (*errp)->msg);
135     g_free((*errp)->msg);
136     (*errp)->msg = g_string_free(newmsg, 0);
137 }
138 
139 void error_prepend(Error *const *errp, const char *fmt, ...)
140 {
141     va_list ap;
142 
143     va_start(ap, fmt);
144     error_vprepend(errp, fmt, ap);
145     va_end(ap);
146 }
147 
148 void error_append_hint(Error *const *errp, const char *fmt, ...)
149 {
150     va_list ap;
151     int saved_errno = errno;
152     Error *err;
153 
154     if (!errp) {
155         return;
156     }
157     err = *errp;
158     assert(err && errp != &error_abort && errp != &error_fatal);
159 
160     if (!err->hint) {
161         err->hint = g_string_new(NULL);
162     }
163     va_start(ap, fmt);
164     g_string_append_vprintf(err->hint, fmt, ap);
165     va_end(ap);
166 
167     errno = saved_errno;
168 }
169 
170 #ifdef _WIN32
171 
172 void error_setg_win32_internal(Error **errp,
173                                const char *src, int line, const char *func,
174                                int win32_err, const char *fmt, ...)
175 {
176     va_list ap;
177     char *suffix = NULL;
178 
179     if (errp == NULL) {
180         return;
181     }
182 
183     if (win32_err != 0) {
184         suffix = g_win32_error_message(win32_err);
185     }
186 
187     va_start(ap, fmt);
188     error_setv(errp, src, line, func, ERROR_CLASS_GENERIC_ERROR,
189                fmt, ap, suffix);
190     va_end(ap);
191 
192     g_free(suffix);
193 }
194 
195 #endif
196 
197 Error *error_copy(const Error *err)
198 {
199     Error *err_new;
200 
201     err_new = g_malloc0(sizeof(*err));
202     err_new->msg = g_strdup(err->msg);
203     err_new->err_class = err->err_class;
204     err_new->src = err->src;
205     err_new->line = err->line;
206     err_new->func = err->func;
207     if (err->hint) {
208         err_new->hint = g_string_new(err->hint->str);
209     }
210 
211     return err_new;
212 }
213 
214 ErrorClass error_get_class(const Error *err)
215 {
216     return err->err_class;
217 }
218 
219 const char *error_get_pretty(const Error *err)
220 {
221     return err->msg;
222 }
223 
224 void error_report_err(Error *err)
225 {
226     error_report("%s", error_get_pretty(err));
227     if (err->hint) {
228         error_printf("%s", err->hint->str);
229     }
230     error_free(err);
231 }
232 
233 void warn_report_err(Error *err)
234 {
235     warn_report("%s", error_get_pretty(err));
236     if (err->hint) {
237         error_printf("%s", err->hint->str);
238     }
239     error_free(err);
240 }
241 
242 bool warn_report_err_once_cond(bool *printed, Error *err)
243 {
244     if (*printed) {
245         error_free(err);
246         return false;
247     }
248     *printed = true;
249     warn_report_err(err);
250     return true;
251 }
252 
253 void error_reportf_err(Error *err, const char *fmt, ...)
254 {
255     va_list ap;
256 
257     va_start(ap, fmt);
258     error_vprepend(&err, fmt, ap);
259     va_end(ap);
260     error_report_err(err);
261 }
262 
263 
264 void warn_reportf_err(Error *err, const char *fmt, ...)
265 {
266     va_list ap;
267 
268     va_start(ap, fmt);
269     error_vprepend(&err, fmt, ap);
270     va_end(ap);
271     warn_report_err(err);
272 }
273 
274 void error_free(Error *err)
275 {
276     if (err) {
277         g_free(err->msg);
278         if (err->hint) {
279             g_string_free(err->hint, true);
280         }
281         g_free(err);
282     }
283 }
284 
285 void error_free_or_abort(Error **errp)
286 {
287     assert(errp && *errp);
288     error_free(*errp);
289     *errp = NULL;
290 }
291 
292 void error_propagate(Error **dst_errp, Error *local_err)
293 {
294     if (!local_err) {
295         return;
296     }
297     error_handle(dst_errp, local_err);
298 }
299 
300 void error_propagate_prepend(Error **dst_errp, Error *err,
301                              const char *fmt, ...)
302 {
303     va_list ap;
304 
305     if (dst_errp && !*dst_errp) {
306         va_start(ap, fmt);
307         error_vprepend(&err, fmt, ap);
308         va_end(ap);
309     } /* else error is being ignored, don't bother with prepending */
310     error_propagate(dst_errp, err);
311 }
312