5eeee3fa2e
This adds a command that allows searching for types that implement a property. This allows you to do things like search for all available PCIDevices. In the future, we'll also have a standard interface for things with a BlockDriverState property that a PCIDevice could implement. This will enable search queries like, "any type that implements the BlockDevice interface" which would allow management tools to present available block devices without having to hard code device names. Since an object can implement multiple interfaces, one device could act both as a BlockDevice and a NetworkDevice. Signed-off-by: Anthony Liguori <aliguori@us.ibm.com>
596 lines
15 KiB
C
596 lines
15 KiB
C
/*
|
|
* QError Module
|
|
*
|
|
* Copyright (C) 2009 Red Hat Inc.
|
|
*
|
|
* Authors:
|
|
* Luiz Capitulino <lcapitulino@redhat.com>
|
|
*
|
|
* This work is licensed under the terms of the GNU LGPL, version 2.1 or later.
|
|
* See the COPYING.LIB file in the top-level directory.
|
|
*/
|
|
|
|
#include "monitor.h"
|
|
#include "qjson.h"
|
|
#include "qerror.h"
|
|
#include "qemu-common.h"
|
|
|
|
static void qerror_destroy_obj(QObject *obj);
|
|
|
|
static const QType qerror_type = {
|
|
.code = QTYPE_QERROR,
|
|
.destroy = qerror_destroy_obj,
|
|
};
|
|
|
|
/**
|
|
* The 'desc' parameter is a printf-like string, the format of the format
|
|
* string is:
|
|
*
|
|
* %(KEY)
|
|
*
|
|
* Where KEY is a QDict key, which has to be passed to qerror_from_info().
|
|
*
|
|
* Example:
|
|
*
|
|
* "foo error on device: %(device) slot: %(slot_nr)"
|
|
*
|
|
* A single percent sign can be printed if followed by a second one,
|
|
* for example:
|
|
*
|
|
* "running out of foo: %(foo)%%"
|
|
*
|
|
* Please keep the entries in alphabetical order.
|
|
* Use scripts/check-qerror.sh to check.
|
|
*/
|
|
static const QErrorStringTable qerror_table[] = {
|
|
{
|
|
.error_fmt = QERR_ADD_CLIENT_FAILED,
|
|
.desc = "Could not add client",
|
|
},
|
|
{
|
|
.error_fmt = QERR_BAD_BUS_FOR_DEVICE,
|
|
.desc = "Device '%(device)' can't go on a %(bad_bus_type) bus",
|
|
},
|
|
{
|
|
.error_fmt = QERR_BASE_NOT_FOUND,
|
|
.desc = "Base '%(base)' not found",
|
|
},
|
|
{
|
|
.error_fmt = QERR_BLOCK_FORMAT_FEATURE_NOT_SUPPORTED,
|
|
.desc = "Block format '%(format)' used by device '%(name)' does not support feature '%(feature)'",
|
|
},
|
|
{
|
|
.error_fmt = QERR_BUS_NO_HOTPLUG,
|
|
.desc = "Bus '%(bus)' does not support hotplugging",
|
|
},
|
|
{
|
|
.error_fmt = QERR_BUS_NOT_FOUND,
|
|
.desc = "Bus '%(bus)' not found",
|
|
},
|
|
{
|
|
.error_fmt = QERR_COMMAND_DISABLED,
|
|
.desc = "The command %(name) has been disabled for this instance",
|
|
},
|
|
{
|
|
.error_fmt = QERR_COMMAND_NOT_FOUND,
|
|
.desc = "The command %(name) has not been found",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_ENCRYPTED,
|
|
.desc = "Device '%(device)' is encrypted",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_FEATURE_BLOCKS_MIGRATION,
|
|
.desc = "Migration is disabled when using feature '%(feature)' in device '%(device)'",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_HAS_NO_MEDIUM,
|
|
.desc = "Device '%(device)' has no medium",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_INIT_FAILED,
|
|
.desc = "Device '%(device)' could not be initialized",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_IN_USE,
|
|
.desc = "Device '%(device)' is in use",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_IS_READ_ONLY,
|
|
.desc = "Device '%(device)' is read only",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_LOCKED,
|
|
.desc = "Device '%(device)' is locked",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_MULTIPLE_BUSSES,
|
|
.desc = "Device '%(device)' has multiple child busses",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_NO_BUS,
|
|
.desc = "Device '%(device)' has no child bus",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_NO_HOTPLUG,
|
|
.desc = "Device '%(device)' does not support hotplugging",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_NOT_ACTIVE,
|
|
.desc = "Device '%(device)' has not been activated",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_NOT_ENCRYPTED,
|
|
.desc = "Device '%(device)' is not encrypted",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_NOT_FOUND,
|
|
.desc = "Device '%(device)' not found",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DEVICE_NOT_REMOVABLE,
|
|
.desc = "Device '%(device)' is not removable",
|
|
},
|
|
{
|
|
.error_fmt = QERR_DUPLICATE_ID,
|
|
.desc = "Duplicate ID '%(id)' for %(object)",
|
|
},
|
|
{
|
|
.error_fmt = QERR_FD_NOT_FOUND,
|
|
.desc = "File descriptor named '%(name)' not found",
|
|
},
|
|
{
|
|
.error_fmt = QERR_FD_NOT_SUPPLIED,
|
|
.desc = "No file descriptor supplied via SCM_RIGHTS",
|
|
},
|
|
{
|
|
.error_fmt = QERR_FEATURE_DISABLED,
|
|
.desc = "The feature '%(name)' is not enabled",
|
|
},
|
|
{
|
|
.error_fmt = QERR_INVALID_BLOCK_FORMAT,
|
|
.desc = "Invalid block format '%(name)'",
|
|
},
|
|
{
|
|
.error_fmt = QERR_INVALID_PARAMETER,
|
|
.desc = "Invalid parameter '%(name)'",
|
|
},
|
|
{
|
|
.error_fmt = QERR_INVALID_PARAMETER_COMBINATION,
|
|
.desc = "Invalid parameter combination",
|
|
},
|
|
{
|
|
.error_fmt = QERR_INVALID_PARAMETER_TYPE,
|
|
.desc = "Invalid parameter type for '%(name)', expected: %(expected)",
|
|
},
|
|
{
|
|
.error_fmt = QERR_INVALID_PARAMETER_VALUE,
|
|
.desc = "Parameter '%(name)' expects %(expected)",
|
|
},
|
|
{
|
|
.error_fmt = QERR_INVALID_PASSWORD,
|
|
.desc = "Password incorrect",
|
|
},
|
|
{
|
|
.error_fmt = QERR_IO_ERROR,
|
|
.desc = "An IO error has occurred",
|
|
},
|
|
{
|
|
.error_fmt = QERR_JSON_PARSE_ERROR,
|
|
.desc = "JSON parse error, %(message)",
|
|
|
|
},
|
|
{
|
|
.error_fmt = QERR_JSON_PARSING,
|
|
.desc = "Invalid JSON syntax",
|
|
},
|
|
{
|
|
.error_fmt = QERR_KVM_MISSING_CAP,
|
|
.desc = "Using KVM without %(capability), %(feature) unavailable",
|
|
},
|
|
{
|
|
.error_fmt = QERR_MIGRATION_EXPECTED,
|
|
.desc = "An incoming migration is expected before this command can be executed",
|
|
},
|
|
{
|
|
.error_fmt = QERR_MISSING_PARAMETER,
|
|
.desc = "Parameter '%(name)' is missing",
|
|
},
|
|
{
|
|
.error_fmt = QERR_NO_BUS_FOR_DEVICE,
|
|
.desc = "No '%(bus)' bus found for device '%(device)'",
|
|
},
|
|
{
|
|
.error_fmt = QERR_NOT_SUPPORTED,
|
|
.desc = "Not supported",
|
|
},
|
|
{
|
|
.error_fmt = QERR_OPEN_FILE_FAILED,
|
|
.desc = "Could not open '%(filename)'",
|
|
},
|
|
{
|
|
.error_fmt = QERR_PERMISSION_DENIED,
|
|
.desc = "Insufficient permission to perform this operation",
|
|
},
|
|
{
|
|
.error_fmt = QERR_PROPERTY_NOT_FOUND,
|
|
.desc = "Property '%(device).%(property)' not found",
|
|
},
|
|
{
|
|
.error_fmt = QERR_PROPERTY_VALUE_BAD,
|
|
.desc = "Property '%(device).%(property)' doesn't take value '%(value)'",
|
|
},
|
|
{
|
|
.error_fmt = QERR_PROPERTY_VALUE_IN_USE,
|
|
.desc = "Property '%(device).%(property)' can't take value '%(value)', it's in use",
|
|
},
|
|
{
|
|
.error_fmt = QERR_PROPERTY_VALUE_NOT_FOUND,
|
|
.desc = "Property '%(device).%(property)' can't find value '%(value)'",
|
|
},
|
|
{
|
|
.error_fmt = QERR_PROPERTY_VALUE_OUT_OF_RANGE,
|
|
.desc = "Property '%(device).%(property)' doesn't take "
|
|
"value %(value) (minimum: %(min), maximum: %(max)'",
|
|
},
|
|
{
|
|
.error_fmt = QERR_QGA_COMMAND_FAILED,
|
|
.desc = "Guest agent command failed, error was '%(message)'",
|
|
},
|
|
{
|
|
.error_fmt = QERR_QGA_LOGGING_FAILED,
|
|
.desc = "Guest agent failed to log non-optional log statement",
|
|
},
|
|
{
|
|
.error_fmt = QERR_QMP_BAD_INPUT_OBJECT,
|
|
.desc = "Expected '%(expected)' in QMP input",
|
|
},
|
|
{
|
|
.error_fmt = QERR_QMP_BAD_INPUT_OBJECT_MEMBER,
|
|
.desc = "QMP input object member '%(member)' expects '%(expected)'",
|
|
},
|
|
{
|
|
.error_fmt = QERR_QMP_EXTRA_MEMBER,
|
|
.desc = "QMP input object member '%(member)' is unexpected",
|
|
},
|
|
{
|
|
.error_fmt = QERR_RESET_REQUIRED,
|
|
.desc = "Resetting the Virtual Machine is required",
|
|
},
|
|
{
|
|
.error_fmt = QERR_SET_PASSWD_FAILED,
|
|
.desc = "Could not set password",
|
|
},
|
|
{
|
|
.error_fmt = QERR_TOO_MANY_FILES,
|
|
.desc = "Too many open files",
|
|
},
|
|
{
|
|
.error_fmt = QERR_UNDEFINED_ERROR,
|
|
.desc = "An undefined error has occurred",
|
|
},
|
|
{
|
|
.error_fmt = QERR_UNKNOWN_BLOCK_FORMAT_FEATURE,
|
|
.desc = "'%(device)' uses a %(format) feature which is not "
|
|
"supported by this qemu version: %(feature)",
|
|
},
|
|
{
|
|
.error_fmt = QERR_UNSUPPORTED,
|
|
.desc = "this feature or command is not currently supported",
|
|
},
|
|
{
|
|
.error_fmt = QERR_VIRTFS_FEATURE_BLOCKS_MIGRATION,
|
|
.desc = "Migration is disabled when VirtFS export path '%(path)' "
|
|
"is mounted in the guest using mount_tag '%(tag)'",
|
|
},
|
|
{
|
|
.error_fmt = QERR_VNC_SERVER_FAILED,
|
|
.desc = "Could not start VNC server on %(target)",
|
|
},
|
|
{}
|
|
};
|
|
|
|
/**
|
|
* qerror_new(): Create a new QError
|
|
*
|
|
* Return strong reference.
|
|
*/
|
|
QError *qerror_new(void)
|
|
{
|
|
QError *qerr;
|
|
|
|
qerr = g_malloc0(sizeof(*qerr));
|
|
QOBJECT_INIT(qerr, &qerror_type);
|
|
|
|
return qerr;
|
|
}
|
|
|
|
static void GCC_FMT_ATTR(2, 3) qerror_abort(const QError *qerr,
|
|
const char *fmt, ...)
|
|
{
|
|
va_list ap;
|
|
|
|
fprintf(stderr, "qerror: bad call in function '%s':\n", qerr->func);
|
|
fprintf(stderr, "qerror: -> ");
|
|
|
|
va_start(ap, fmt);
|
|
vfprintf(stderr, fmt, ap);
|
|
va_end(ap);
|
|
|
|
fprintf(stderr, "\nqerror: call at %s:%d\n", qerr->file, qerr->linenr);
|
|
abort();
|
|
}
|
|
|
|
static void GCC_FMT_ATTR(2, 0) qerror_set_data(QError *qerr,
|
|
const char *fmt, va_list *va)
|
|
{
|
|
QObject *obj;
|
|
|
|
obj = qobject_from_jsonv(fmt, va);
|
|
if (!obj) {
|
|
qerror_abort(qerr, "invalid format '%s'", fmt);
|
|
}
|
|
if (qobject_type(obj) != QTYPE_QDICT) {
|
|
qerror_abort(qerr, "error format is not a QDict '%s'", fmt);
|
|
}
|
|
|
|
qerr->error = qobject_to_qdict(obj);
|
|
|
|
obj = qdict_get(qerr->error, "class");
|
|
if (!obj) {
|
|
qerror_abort(qerr, "missing 'class' key in '%s'", fmt);
|
|
}
|
|
if (qobject_type(obj) != QTYPE_QSTRING) {
|
|
qerror_abort(qerr, "'class' key value should be a QString");
|
|
}
|
|
|
|
obj = qdict_get(qerr->error, "data");
|
|
if (!obj) {
|
|
qerror_abort(qerr, "missing 'data' key in '%s'", fmt);
|
|
}
|
|
if (qobject_type(obj) != QTYPE_QDICT) {
|
|
qerror_abort(qerr, "'data' key value should be a QDICT");
|
|
}
|
|
}
|
|
|
|
static void qerror_set_desc(QError *qerr, const char *fmt)
|
|
{
|
|
int i;
|
|
|
|
// FIXME: inefficient loop
|
|
|
|
for (i = 0; qerror_table[i].error_fmt; i++) {
|
|
if (strcmp(qerror_table[i].error_fmt, fmt) == 0) {
|
|
qerr->entry = &qerror_table[i];
|
|
return;
|
|
}
|
|
}
|
|
|
|
qerror_abort(qerr, "error format '%s' not found", fmt);
|
|
}
|
|
|
|
/**
|
|
* qerror_from_info(): Create a new QError from error information
|
|
*
|
|
* The information consists of:
|
|
*
|
|
* - file the file name of where the error occurred
|
|
* - linenr the line number of where the error occurred
|
|
* - func the function name of where the error occurred
|
|
* - fmt JSON printf-like dictionary, there must exist keys 'class' and
|
|
* 'data'
|
|
* - va va_list of all arguments specified by fmt
|
|
*
|
|
* Return strong reference.
|
|
*/
|
|
QError *qerror_from_info(const char *file, int linenr, const char *func,
|
|
const char *fmt, va_list *va)
|
|
{
|
|
QError *qerr;
|
|
|
|
qerr = qerror_new();
|
|
loc_save(&qerr->loc);
|
|
qerr->linenr = linenr;
|
|
qerr->file = file;
|
|
qerr->func = func;
|
|
|
|
if (!fmt) {
|
|
qerror_abort(qerr, "QDict not specified");
|
|
}
|
|
|
|
qerror_set_data(qerr, fmt, va);
|
|
qerror_set_desc(qerr, fmt);
|
|
|
|
return qerr;
|
|
}
|
|
|
|
static void parse_error(const QErrorStringTable *entry, int c)
|
|
{
|
|
fprintf(stderr, "expected '%c' in '%s'", c, entry->desc);
|
|
abort();
|
|
}
|
|
|
|
static const char *append_field(QDict *error, QString *outstr,
|
|
const QErrorStringTable *entry,
|
|
const char *start)
|
|
{
|
|
QObject *obj;
|
|
QDict *qdict;
|
|
QString *key_qs;
|
|
const char *end, *key;
|
|
|
|
if (*start != '%')
|
|
parse_error(entry, '%');
|
|
start++;
|
|
if (*start != '(')
|
|
parse_error(entry, '(');
|
|
start++;
|
|
|
|
end = strchr(start, ')');
|
|
if (!end)
|
|
parse_error(entry, ')');
|
|
|
|
key_qs = qstring_from_substr(start, 0, end - start - 1);
|
|
key = qstring_get_str(key_qs);
|
|
|
|
qdict = qobject_to_qdict(qdict_get(error, "data"));
|
|
obj = qdict_get(qdict, key);
|
|
if (!obj) {
|
|
abort();
|
|
}
|
|
|
|
switch (qobject_type(obj)) {
|
|
case QTYPE_QSTRING:
|
|
qstring_append(outstr, qdict_get_str(qdict, key));
|
|
break;
|
|
case QTYPE_QINT:
|
|
qstring_append_int(outstr, qdict_get_int(qdict, key));
|
|
break;
|
|
default:
|
|
abort();
|
|
}
|
|
|
|
QDECREF(key_qs);
|
|
return ++end;
|
|
}
|
|
|
|
static QString *qerror_format_desc(QDict *error,
|
|
const QErrorStringTable *entry)
|
|
{
|
|
QString *qstring;
|
|
const char *p;
|
|
|
|
assert(entry != NULL);
|
|
|
|
qstring = qstring_new();
|
|
|
|
for (p = entry->desc; *p != '\0';) {
|
|
if (*p != '%') {
|
|
qstring_append_chr(qstring, *p++);
|
|
} else if (*(p + 1) == '%') {
|
|
qstring_append_chr(qstring, '%');
|
|
p += 2;
|
|
} else {
|
|
p = append_field(error, qstring, entry, p);
|
|
}
|
|
}
|
|
|
|
return qstring;
|
|
}
|
|
|
|
QString *qerror_format(const char *fmt, QDict *error)
|
|
{
|
|
const QErrorStringTable *entry = NULL;
|
|
int i;
|
|
|
|
for (i = 0; qerror_table[i].error_fmt; i++) {
|
|
if (strcmp(qerror_table[i].error_fmt, fmt) == 0) {
|
|
entry = &qerror_table[i];
|
|
break;
|
|
}
|
|
}
|
|
|
|
return qerror_format_desc(error, entry);
|
|
}
|
|
|
|
/**
|
|
* qerror_human(): Format QError data into human-readable string.
|
|
*/
|
|
QString *qerror_human(const QError *qerror)
|
|
{
|
|
return qerror_format_desc(qerror->error, qerror->entry);
|
|
}
|
|
|
|
/**
|
|
* qerror_print(): Print QError data
|
|
*
|
|
* This function will print the member 'desc' of the specified QError object,
|
|
* it uses error_report() for this, so that the output is routed to the right
|
|
* place (ie. stderr or Monitor's device).
|
|
*/
|
|
void qerror_print(QError *qerror)
|
|
{
|
|
QString *qstring = qerror_human(qerror);
|
|
loc_push_restore(&qerror->loc);
|
|
error_report("%s", qstring_get_str(qstring));
|
|
loc_pop(&qerror->loc);
|
|
QDECREF(qstring);
|
|
}
|
|
|
|
void qerror_report_internal(const char *file, int linenr, const char *func,
|
|
const char *fmt, ...)
|
|
{
|
|
va_list va;
|
|
QError *qerror;
|
|
|
|
va_start(va, fmt);
|
|
qerror = qerror_from_info(file, linenr, func, fmt, &va);
|
|
va_end(va);
|
|
|
|
if (monitor_cur_is_qmp()) {
|
|
monitor_set_error(cur_mon, qerror);
|
|
} else {
|
|
qerror_print(qerror);
|
|
QDECREF(qerror);
|
|
}
|
|
}
|
|
|
|
/* Evil... */
|
|
struct Error
|
|
{
|
|
QDict *obj;
|
|
const char *fmt;
|
|
char *msg;
|
|
};
|
|
|
|
void qerror_report_err(Error *err)
|
|
{
|
|
QError *qerr;
|
|
int i;
|
|
|
|
qerr = qerror_new();
|
|
loc_save(&qerr->loc);
|
|
QINCREF(err->obj);
|
|
qerr->error = err->obj;
|
|
|
|
for (i = 0; qerror_table[i].error_fmt; i++) {
|
|
if (strcmp(qerror_table[i].error_fmt, err->fmt) == 0) {
|
|
qerr->entry = &qerror_table[i];
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (monitor_cur_is_qmp()) {
|
|
monitor_set_error(cur_mon, qerr);
|
|
} else {
|
|
qerror_print(qerr);
|
|
QDECREF(qerr);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* qobject_to_qerror(): Convert a QObject into a QError
|
|
*/
|
|
QError *qobject_to_qerror(const QObject *obj)
|
|
{
|
|
if (qobject_type(obj) != QTYPE_QERROR) {
|
|
return NULL;
|
|
}
|
|
|
|
return container_of(obj, QError, base);
|
|
}
|
|
|
|
/**
|
|
* qerror_destroy_obj(): Free all memory allocated by a QError
|
|
*/
|
|
static void qerror_destroy_obj(QObject *obj)
|
|
{
|
|
QError *qerr;
|
|
|
|
assert(obj != NULL);
|
|
qerr = qobject_to_qerror(obj);
|
|
|
|
QDECREF(qerr->error);
|
|
g_free(qerr);
|
|
}
|