qerror.h

   1 /*
   2  * QError Module
   3  *
   4  * Copyright (C) 2009 Red Hat Inc.
   5  *
   6  * Authors:
   7  *  Luiz Capitulino <lcapitulino@redhat.com>
   8  *
   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.
  11  */
  12 #ifndef QERROR_H
  13 #define QERROR_H
  14
  15 #include "qdict.h"
  16 #include "qstring.h"
  17 #include "qemu-error.h"
  18 #include "error.h"
  19 #include <stdarg.h>
  20
  21 typedef struct QErrorStringTable {
  22     const char *desc;
  23     const char *error_fmt;
  24 } QErrorStringTable;
  25
  26 typedef struct QError {
  27     QObject_HEAD;
  28     QDict *error;
  29     Location loc;
  30     int linenr;
  31     const char *file;
  32     const char *func;
  33     const QErrorStringTable *entry;
  34 } QError;
  35
  36 QError *qerror_new(void);
  37 QError *qerror_from_info(const char *file, int linenr, const char *func,
  38                          const char *fmt, va_list *va) GCC_FMT_ATTR(4, 0);
  39 QString *qerror_human(const QError *qerror);
  40 void qerror_print(QError *qerror);
  41 void qerror_report_internal(const char *file, int linenr, const char *func,
  42                             const char *fmt, ...) GCC_FMT_ATTR(4, 5);
  43 void qerror_report_err(Error *err);
  44 void assert_no_error(Error *err);
  45 QString *qerror_format(const char *fmt, QDict *error);
  46 #define qerror_report(fmt, ...) \
  47     qerror_report_internal(__FILE__, __LINE__, __func__, fmt, ## __VA_ARGS__)
  48 QError *qobject_to_qerror(const QObject *obj);
  49
  50 /*
  51  * QError class list
  52  * Please keep the definitions in alphabetical order.
  53  * Use scripts/check-qerror.sh to check.
  54  */
  55 #define QERR_ADD_CLIENT_FAILED \
  56     "{ 'class': 'AddClientFailed', 'data': {} }"
  57
  58 #define QERR_AMBIGUOUS_PATH \
  59     "{ 'class': 'AmbiguousPath', 'data': { 'path': %s } }"
  60
  61 #define QERR_BAD_BUS_FOR_DEVICE \
  62     "{ 'class': 'BadBusForDevice', 'data': { 'device': %s, 'bad_bus_type': %s } }"
  63
  64 #define QERR_BASE_NOT_FOUND \
  65     "{ 'class': 'BaseNotFound', 'data': { 'base': %s } }"
  66
  67 #define QERR_BLOCK_FORMAT_FEATURE_NOT_SUPPORTED \
  68     "{ 'class': 'BlockFormatFeatureNotSupported', 'data': { 'format': %s, 'name': %s, 'feature': %s } }"
  69
  70 #define QERR_BUFFER_OVERRUN \
  71     "{ 'class': 'BufferOverrun', 'data': {} }"
  72
  73 #define QERR_BUS_NO_HOTPLUG \
  74     "{ 'class': 'BusNoHotplug', 'data': { 'bus': %s } }"
  75
  76 #define QERR_BUS_NOT_FOUND \
  77     "{ 'class': 'BusNotFound', 'data': { 'bus': %s } }"
  78
  79 #define QERR_COMMAND_DISABLED \
  80     "{ 'class': 'CommandDisabled', 'data': { 'name': %s } }"
  81
  82 #define QERR_COMMAND_NOT_FOUND \
  83     "{ 'class': 'CommandNotFound', 'data': { 'name': %s } }"
  84
  85 #define QERR_DEVICE_ENCRYPTED \
  86     "{ 'class': 'DeviceEncrypted', 'data': { 'device': %s, 'filename': %s } }"
  87
  88 #define QERR_DEVICE_FEATURE_BLOCKS_MIGRATION \
  89     "{ 'class': 'DeviceFeatureBlocksMigration', 'data': { 'device': %s, 'feature': %s } }"
  90
  91 #define QERR_DEVICE_HAS_NO_MEDIUM \
  92     "{ 'class': 'DeviceHasNoMedium', 'data': { 'device': %s } }"
  93
  94 #define QERR_DEVICE_INIT_FAILED \
  95     "{ 'class': 'DeviceInitFailed', 'data': { 'device': %s } }"
  96
  97 #define QERR_DEVICE_IN_USE \
  98     "{ 'class': 'DeviceInUse', 'data': { 'device': %s } }"
  99
 100 #define QERR_DEVICE_IS_READ_ONLY \
 101     "{ 'class': 'DeviceIsReadOnly', 'data': { 'device': %s } }"
 102
 103 #define QERR_DEVICE_LOCKED \
 104     "{ 'class': 'DeviceLocked', 'data': { 'device': %s } }"
 105
 106 #define QERR_DEVICE_MULTIPLE_BUSSES \
 107     "{ 'class': 'DeviceMultipleBusses', 'data': { 'device': %s } }"
 108
 109 #define QERR_DEVICE_NO_BUS \
 110     "{ 'class': 'DeviceNoBus', 'data': { 'device': %s } }"
 111
 112 #define QERR_DEVICE_NO_HOTPLUG \
 113     "{ 'class': 'DeviceNoHotplug', 'data': { 'device': %s } }"
 114
 115 #define QERR_DEVICE_NOT_ACTIVE \
 116     "{ 'class': 'DeviceNotActive', 'data': { 'device': %s } }"
 117
 118 #define QERR_DEVICE_NOT_ENCRYPTED \
 119     "{ 'class': 'DeviceNotEncrypted', 'data': { 'device': %s } }"
 120
 121 #define QERR_DEVICE_NOT_FOUND \
 122     "{ 'class': 'DeviceNotFound', 'data': { 'device': %s } }"
 123
 124 #define QERR_DEVICE_NOT_REMOVABLE \
 125     "{ 'class': 'DeviceNotRemovable', 'data': { 'device': %s } }"
 126
 127 #define QERR_DUPLICATE_ID \
 128     "{ 'class': 'DuplicateId', 'data': { 'id': %s, 'object': %s } }"
 129
 130 #define QERR_FD_NOT_FOUND \
 131     "{ 'class': 'FdNotFound', 'data': { 'name': %s } }"
 132
 133 #define QERR_FD_NOT_SUPPLIED \
 134     "{ 'class': 'FdNotSupplied', 'data': {} }"
 135
 136 #define QERR_FEATURE_DISABLED \
 137     "{ 'class': 'FeatureDisabled', 'data': { 'name': %s } }"
 138
 139 #define QERR_INVALID_BLOCK_FORMAT \
 140     "{ 'class': 'InvalidBlockFormat', 'data': { 'name': %s } }"
 141
 142 #define QERR_INVALID_PARAMETER \
 143     "{ 'class': 'InvalidParameter', 'data': { 'name': %s } }"
 144
 145 #define QERR_INVALID_PARAMETER_COMBINATION \
 146     "{ 'class': 'InvalidParameterCombination', 'data': {} }"
 147
 148 #define QERR_INVALID_PARAMETER_TYPE \
 149     "{ 'class': 'InvalidParameterType', 'data': { 'name': %s,'expected': %s } }"
 150
 151 #define QERR_INVALID_PARAMETER_VALUE \
 152     "{ 'class': 'InvalidParameterValue', 'data': { 'name': %s, 'expected': %s } }"
 153
 154 #define QERR_INVALID_PASSWORD \
 155     "{ 'class': 'InvalidPassword', 'data': {} }"
 156
 157 #define QERR_IO_ERROR \
 158     "{ 'class': 'IOError', 'data': {} }"
 159
 160 #define QERR_JSON_PARSE_ERROR \
 161     "{ 'class': 'JSONParseError', 'data': { 'message': %s } }"
 162
 163 #define QERR_JSON_PARSING \
 164     "{ 'class': 'JSONParsing', 'data': {} }"
 165
 166 #define QERR_KVM_MISSING_CAP \
 167     "{ 'class': 'KVMMissingCap', 'data': { 'capability': %s, 'feature': %s } }"
 168
 169 #define QERR_MIGRATION_ACTIVE \
 170     "{ 'class': 'MigrationActive', 'data': {} }"
 171
 172 #define QERR_MIGRATION_NOT_SUPPORTED \
 173     "{ 'class': 'MigrationNotSupported', 'data': {'device': %s} }"
 174
 175 #define QERR_MIGRATION_EXPECTED \
 176     "{ 'class': 'MigrationExpected', 'data': {} }"
 177
 178 #define QERR_MISSING_PARAMETER \
 179     "{ 'class': 'MissingParameter', 'data': { 'name': %s } }"
 180
 181 #define QERR_NO_BUS_FOR_DEVICE \
 182     "{ 'class': 'NoBusForDevice', 'data': { 'device': %s, 'bus': %s } }"
 183
 184 #define QERR_NOT_SUPPORTED \
 185     "{ 'class': 'NotSupported', 'data': {} }"
 186
 187 #define QERR_OPEN_FILE_FAILED \
 188     "{ 'class': 'OpenFileFailed', 'data': { 'filename': %s } }"
 189
 190 #define QERR_PERMISSION_DENIED \
 191     "{ 'class': 'PermissionDenied', 'data': {} }"
 192
 193 #define QERR_PROPERTY_NOT_FOUND \
 194     "{ 'class': 'PropertyNotFound', 'data': { 'device': %s, 'property': %s } }"
 195
 196 #define QERR_PROPERTY_VALUE_BAD \
 197     "{ 'class': 'PropertyValueBad', 'data': { 'device': %s, 'property': %s, 'value': %s } }"
 198
 199 #define QERR_PROPERTY_VALUE_IN_USE \
 200     "{ 'class': 'PropertyValueInUse', 'data': { 'device': %s, 'property': %s, 'value': %s } }"
 201
 202 #define QERR_PROPERTY_VALUE_NOT_FOUND \
 203     "{ 'class': 'PropertyValueNotFound', 'data': { 'device': %s, 'property': %s, 'value': %s } }"
 204
 205 #define QERR_PROPERTY_VALUE_NOT_POWER_OF_2 \
 206     "{ 'class': 'PropertyValueNotPowerOf2', 'data': { " \
 207     "'device': %s, 'property': %s, 'value': %"PRId64" } }"
 208
 209 #define QERR_PROPERTY_VALUE_OUT_OF_RANGE \
 210     "{ 'class': 'PropertyValueOutOfRange', 'data': { 'device': %s, 'property': %s, 'value': %"PRId64", 'min': %"PRId64", 'max': %"PRId64" } }"
 211
 212 #define QERR_QGA_COMMAND_FAILED \
 213     "{ 'class': 'QgaCommandFailed', 'data': { 'message': %s } }"
 214
 215 #define QERR_QGA_LOGGING_FAILED \
 216     "{ 'class': 'QgaLoggingFailed', 'data': {} }"
 217
 218 #define QERR_QMP_BAD_INPUT_OBJECT \
 219     "{ 'class': 'QMPBadInputObject', 'data': { 'expected': %s } }"
 220
 221 #define QERR_QMP_BAD_INPUT_OBJECT_MEMBER \
 222     "{ 'class': 'QMPBadInputObjectMember', 'data': { 'member': %s, 'expected': %s } }"
 223
 224 #define QERR_QMP_EXTRA_MEMBER \
 225     "{ 'class': 'QMPExtraInputObjectMember', 'data': { 'member': %s } }"
 226
 227 #define QERR_RESET_REQUIRED \
 228     "{ 'class': 'ResetRequired', 'data': {} }"
 229
 230 #define QERR_SET_PASSWD_FAILED \
 231     "{ 'class': 'SetPasswdFailed', 'data': {} }"
 232
 233 #define QERR_TOO_MANY_FILES \
 234     "{ 'class': 'TooManyFiles', 'data': {} }"
 235
 236 #define QERR_UNDEFINED_ERROR \
 237     "{ 'class': 'UndefinedError', 'data': {} }"
 238
 239 #define QERR_UNKNOWN_BLOCK_FORMAT_FEATURE \
 240     "{ 'class': 'UnknownBlockFormatFeature', 'data': { 'device': %s, 'format': %s, 'feature': %s } }"
 241
 242 #define QERR_UNSUPPORTED \
 243     "{ 'class': 'Unsupported', 'data': {} }"
 244
 245 #define QERR_VIRTFS_FEATURE_BLOCKS_MIGRATION \
 246     "{ 'class': 'VirtFSFeatureBlocksMigration', 'data': { 'path': %s, 'tag': %s } }"
 247
 248 #define QERR_VNC_SERVER_FAILED \
 249     "{ 'class': 'VNCServerFailed', 'data': { 'target': %s } }"
 250
 251 #endif /* QERROR_H */