2 * QError: QEMU Error data-type.
4 * Copyright (C) 2009 Red Hat Inc.
7 * Luiz Capitulino <lcapitulino@redhat.com>
9 * This work is licensed under the terms of the GNU LGPL, version 2.1 or later.
10 * See the COPYING.LIB file in the top-level directory.
16 #include "qemu-common.h"
18 static void qerror_destroy_obj(QObject
*obj
);
20 static const QType qerror_type
= {
22 .destroy
= qerror_destroy_obj
,
26 * The 'desc' parameter is a printf-like string, the format of the format
31 * Where KEY is a QDict key, which has to be passed to qerror_from_info().
35 * "foo error on device: %(device) slot: %(slot_nr)"
37 * A single percent sign can be printed if followed by a second one,
40 * "running out of foo: %(foo)%%"
42 static const QErrorStringTable qerror_table
[] = {
44 .error_fmt
= QERR_COMMAND_NOT_FOUND
,
45 .desc
= "The command %(name) has not been found",
48 .error_fmt
= QERR_DEVICE_ENCRYPTED
,
49 .desc
= "The %(device) is encrypted",
52 .error_fmt
= QERR_DEVICE_LOCKED
,
53 .desc
= "Device %(device) is locked",
56 .error_fmt
= QERR_DEVICE_NOT_ACTIVE
,
57 .desc
= "The %(device) device has not been activated by the guest",
60 .error_fmt
= QERR_DEVICE_NOT_FOUND
,
61 .desc
= "The %(device) device has not been found",
64 .error_fmt
= QERR_DEVICE_NOT_REMOVABLE
,
65 .desc
= "Device %(device) is not removable",
68 .error_fmt
= QERR_FD_NOT_FOUND
,
69 .desc
= "Failed to find file descriptor named %(name)",
72 .error_fmt
= QERR_FD_NOT_SUPPLIED
,
73 .desc
= "No file descriptor supplied via SCM_RIGHTS",
76 .error_fmt
= QERR_INVALID_BLOCK_FORMAT
,
77 .desc
= "Invalid block format %(name)",
80 .error_fmt
= QERR_INVALID_PARAMETER_TYPE
,
81 .desc
= "Invalid parameter type, expected: %(expected)",
84 .error_fmt
= QERR_INVALID_PASSWORD
,
85 .desc
= "The entered password is invalid",
88 .error_fmt
= QERR_JSON_PARSING
,
89 .desc
= "Invalid JSON syntax",
92 .error_fmt
= QERR_KVM_MISSING_CAP
,
93 .desc
= "Using KVM without %(capability), %(feature) unavailable",
96 .error_fmt
= QERR_MISSING_PARAMETER
,
97 .desc
= "Parameter %(name) is missing",
100 .error_fmt
= QERR_QMP_BAD_INPUT_OBJECT
,
101 .desc
= "Bad QMP input object",
104 .error_fmt
= QERR_SET_PASSWD_FAILED
,
105 .desc
= "Could not set password",
108 .error_fmt
= QERR_UNDEFINED_ERROR
,
109 .desc
= "An undefined error has ocurred",
112 .error_fmt
= QERR_VNC_SERVER_FAILED
,
113 .desc
= "Could not start VNC server on %(target)",
119 * qerror_new(): Create a new QError
121 * Return strong reference.
123 QError
*qerror_new(void)
127 qerr
= qemu_mallocz(sizeof(*qerr
));
128 QOBJECT_INIT(qerr
, &qerror_type
);
133 static void qerror_abort(const QError
*qerr
, const char *fmt
, ...)
137 fprintf(stderr
, "qerror: bad call in function '%s':\n", qerr
->func
);
138 fprintf(stderr
, "qerror: -> ");
141 vfprintf(stderr
, fmt
, ap
);
144 fprintf(stderr
, "\nqerror: call at %s:%d\n", qerr
->file
, qerr
->linenr
);
148 static void qerror_set_data(QError
*qerr
, const char *fmt
, va_list *va
)
152 obj
= qobject_from_jsonv(fmt
, va
);
154 qerror_abort(qerr
, "invalid format '%s'", fmt
);
156 if (qobject_type(obj
) != QTYPE_QDICT
) {
157 qerror_abort(qerr
, "error format is not a QDict '%s'", fmt
);
160 qerr
->error
= qobject_to_qdict(obj
);
162 obj
= qdict_get(qerr
->error
, "class");
164 qerror_abort(qerr
, "missing 'class' key in '%s'", fmt
);
166 if (qobject_type(obj
) != QTYPE_QSTRING
) {
167 qerror_abort(qerr
, "'class' key value should be a QString");
170 obj
= qdict_get(qerr
->error
, "data");
172 qerror_abort(qerr
, "missing 'data' key in '%s'", fmt
);
174 if (qobject_type(obj
) != QTYPE_QDICT
) {
175 qerror_abort(qerr
, "'data' key value should be a QDICT");
179 static void qerror_set_desc(QError
*qerr
, const char *fmt
)
183 // FIXME: inefficient loop
185 for (i
= 0; qerror_table
[i
].error_fmt
; i
++) {
186 if (strcmp(qerror_table
[i
].error_fmt
, fmt
) == 0) {
187 qerr
->entry
= &qerror_table
[i
];
192 qerror_abort(qerr
, "error format '%s' not found", fmt
);
196 * qerror_from_info(): Create a new QError from error information
198 * The information consists of:
200 * - file the file name of where the error occurred
201 * - linenr the line number of where the error occurred
202 * - func the function name of where the error occurred
203 * - fmt JSON printf-like dictionary, there must exist keys 'class' and
205 * - va va_list of all arguments specified by fmt
207 * Return strong reference.
209 QError
*qerror_from_info(const char *file
, int linenr
, const char *func
,
210 const char *fmt
, va_list *va
)
215 qerr
->linenr
= linenr
;
220 qerror_abort(qerr
, "QDict not specified");
223 qerror_set_data(qerr
, fmt
, va
);
224 qerror_set_desc(qerr
, fmt
);
229 static void parse_error(const QError
*qerror
, int c
)
231 qerror_abort(qerror
, "expected '%c' in '%s'", c
, qerror
->entry
->desc
);
234 static const char *append_field(QString
*outstr
, const QError
*qerror
,
240 const char *end
, *key
;
243 parse_error(qerror
, '%');
246 parse_error(qerror
, '(');
249 end
= strchr(start
, ')');
251 parse_error(qerror
, ')');
253 key_qs
= qstring_from_substr(start
, 0, end
- start
- 1);
254 key
= qstring_get_str(key_qs
);
256 qdict
= qobject_to_qdict(qdict_get(qerror
->error
, "data"));
257 obj
= qdict_get(qdict
, key
);
259 qerror_abort(qerror
, "key '%s' not found in QDict", key
);
262 switch (qobject_type(obj
)) {
264 qstring_append(outstr
, qdict_get_str(qdict
, key
));
267 qstring_append_int(outstr
, qdict_get_int(qdict
, key
));
270 qerror_abort(qerror
, "invalid type '%c'", qobject_type(obj
));
278 * qerror_print(): Print QError data
280 * This function will print the member 'desc' of the specified QError object,
281 * it uses qemu_error() for this, so that the output is routed to the right
282 * place (ie. stderr or Monitor's device).
284 void qerror_print(const QError
*qerror
)
289 assert(qerror
->entry
!= NULL
);
291 qstring
= qstring_new();
293 for (p
= qerror
->entry
->desc
; *p
!= '\0';) {
295 qstring_append_chr(qstring
, *p
++);
296 } else if (*(p
+ 1) == '%') {
297 qstring_append_chr(qstring
, '%');
300 p
= append_field(qstring
, qerror
, p
);
304 qemu_error("%s\n", qstring_get_str(qstring
));
309 * qobject_to_qerror(): Convert a QObject into a QError
311 QError
*qobject_to_qerror(const QObject
*obj
)
313 if (qobject_type(obj
) != QTYPE_QERROR
) {
317 return container_of(obj
, QError
, base
);
321 * qerror_destroy_obj(): Free all memory allocated by a QError
323 static void qerror_destroy_obj(QObject
*obj
)
328 qerr
= qobject_to_qerror(obj
);
330 QDECREF(qerr
->error
);