qapi/qapi-dealloc-visitor.c

   1 /*
   2  * Dealloc Visitor
   3  *
   4  * Copyright (C) 2012-2016 Red Hat, Inc.
   5  * Copyright IBM, Corp. 2011
   6  *
   7  * Authors:
   8  *  Michael Roth   <mdroth@linux.vnet.ibm.com>
   9  *
  10  * This work is licensed under the terms of the GNU LGPL, version 2.1 or later.
  11  * See the COPYING.LIB file in the top-level directory.
  12  *
  13  */
  14
  15 #include "qemu/osdep.h"
  16 #include "qapi/dealloc-visitor.h"
  17 #include "qemu/queue.h"
  18 #include "qemu-common.h"
  19 #include "qapi/qmp/types.h"
  20 #include "qapi/visitor-impl.h"
  21
  22 typedef struct StackEntry
  23 {
  24     void *value;
  25     bool is_list_head;
  26     QTAILQ_ENTRY(StackEntry) node;
  27 } StackEntry;
  28
  29 struct QapiDeallocVisitor
  30 {
  31     Visitor visitor;
  32     QTAILQ_HEAD(, StackEntry) stack;
  33 };
  34
  35 static QapiDeallocVisitor *to_qov(Visitor *v)
  36 {
  37     return container_of(v, QapiDeallocVisitor, visitor);
  38 }
  39
  40 static void qapi_dealloc_push(QapiDeallocVisitor *qov, void *value)
  41 {
  42     StackEntry *e = g_malloc0(sizeof(*e));
  43
  44     e->value = value;
  45
  46     /* see if we're just pushing a list head tracker */
  47     if (value == NULL) {
  48         e->is_list_head = true;
  49     }
  50     QTAILQ_INSERT_HEAD(&qov->stack, e, node);
  51 }
  52
  53 static void *qapi_dealloc_pop(QapiDeallocVisitor *qov)
  54 {
  55     StackEntry *e = QTAILQ_FIRST(&qov->stack);
  56     QObject *value;
  57     QTAILQ_REMOVE(&qov->stack, e, node);
  58     value = e->value;
  59     g_free(e);
  60     return value;
  61 }
  62
  63 static void qapi_dealloc_start_struct(Visitor *v, const char *name, void **obj,
  64                                       size_t unused, Error **errp)
  65 {
  66     QapiDeallocVisitor *qov = to_qov(v);
  67     qapi_dealloc_push(qov, obj);
  68 }
  69
  70 static void qapi_dealloc_end_struct(Visitor *v, Error **errp)
  71 {
  72     QapiDeallocVisitor *qov = to_qov(v);
  73     void **obj = qapi_dealloc_pop(qov);
  74     if (obj) {
  75         g_free(*obj);
  76     }
  77 }
  78
  79 static void qapi_dealloc_start_implicit_struct(Visitor *v,
  80                                                void **obj,
  81                                                size_t size,
  82                                                Error **errp)
  83 {
  84     QapiDeallocVisitor *qov = to_qov(v);
  85     qapi_dealloc_push(qov, obj);
  86 }
  87
  88 static void qapi_dealloc_end_implicit_struct(Visitor *v)
  89 {
  90     QapiDeallocVisitor *qov = to_qov(v);
  91     void **obj = qapi_dealloc_pop(qov);
  92     if (obj) {
  93         g_free(*obj);
  94     }
  95 }
  96
  97 static void qapi_dealloc_start_list(Visitor *v, const char *name, Error **errp)
  98 {
  99     QapiDeallocVisitor *qov = to_qov(v);
 100     qapi_dealloc_push(qov, NULL);
 101 }
 102
 103 static GenericList *qapi_dealloc_next_list(Visitor *v, GenericList **listp,
 104                                            size_t size)
 105 {
 106     GenericList *list = *listp;
 107     QapiDeallocVisitor *qov = to_qov(v);
 108     StackEntry *e = QTAILQ_FIRST(&qov->stack);
 109
 110     if (e && e->is_list_head) {
 111         e->is_list_head = false;
 112         return list;
 113     }
 114
 115     if (list) {
 116         list = list->next;
 117         g_free(*listp);
 118         return list;
 119     }
 120
 121     return NULL;
 122 }
 123
 124 static void qapi_dealloc_end_list(Visitor *v)
 125 {
 126     QapiDeallocVisitor *qov = to_qov(v);
 127     void *obj = qapi_dealloc_pop(qov);
 128     assert(obj == NULL); /* should've been list head tracker with no payload */
 129 }
 130
 131 static void qapi_dealloc_type_str(Visitor *v, const char *name, char **obj,
 132                                   Error **errp)
 133 {
 134     if (obj) {
 135         g_free(*obj);
 136     }
 137 }
 138
 139 static void qapi_dealloc_type_int64(Visitor *v, const char *name, int64_t *obj,
 140                                     Error **errp)
 141 {
 142 }
 143
 144 static void qapi_dealloc_type_uint64(Visitor *v, const char *name,
 145                                      uint64_t *obj, Error **errp)
 146 {
 147 }
 148
 149 static void qapi_dealloc_type_bool(Visitor *v, const char *name, bool *obj,
 150                                    Error **errp)
 151 {
 152 }
 153
 154 static void qapi_dealloc_type_number(Visitor *v, const char *name, double *obj,
 155                                      Error **errp)
 156 {
 157 }
 158
 159 static void qapi_dealloc_type_anything(Visitor *v, const char *name,
 160                                        QObject **obj, Error **errp)
 161 {
 162     if (obj) {
 163         qobject_decref(*obj);
 164     }
 165 }
 166
 167 static void qapi_dealloc_type_enum(Visitor *v, const char *name, int *obj,
 168                                    const char * const strings[], Error **errp)
 169 {
 170 }
 171
 172 /* If there's no data present, the dealloc visitor has nothing to free.
 173  * Thus, indicate to visitor code that the subsequent union fields can
 174  * be skipped. This is not an error condition, since the cleanup of the
 175  * rest of an object can continue unhindered, so leave errp unset in
 176  * these cases.
 177  *
 178  * NOTE: In cases where we're attempting to deallocate an object that
 179  * may have missing fields, the field indicating the union type may
 180  * be missing. In such a case, it's possible we don't have enough
 181  * information to differentiate data_present == false from a case where
 182  * data *is* present but happens to be a scalar with a value of 0.
 183  * This is okay, since in the case of the dealloc visitor there's no
 184  * work that needs to done in either situation.
 185  *
 186  * The current inability in QAPI code to more thoroughly verify a union
 187  * type in such cases will likely need to be addressed if we wish to
 188  * implement this interface for other types of visitors in the future,
 189  * however.
 190  */
 191 static bool qapi_dealloc_start_union(Visitor *v, bool data_present,
 192                                      Error **errp)
 193 {
 194     return data_present;
 195 }
 196
 197 Visitor *qapi_dealloc_get_visitor(QapiDeallocVisitor *v)
 198 {
 199     return &v->visitor;
 200 }
 201
 202 void qapi_dealloc_visitor_cleanup(QapiDeallocVisitor *v)
 203 {
 204     g_free(v);
 205 }
 206
 207 QapiDeallocVisitor *qapi_dealloc_visitor_new(void)
 208 {
 209     QapiDeallocVisitor *v;
 210
 211     v = g_malloc0(sizeof(*v));
 212
 213     v->visitor.start_struct = qapi_dealloc_start_struct;
 214     v->visitor.end_struct = qapi_dealloc_end_struct;
 215     v->visitor.start_implicit_struct = qapi_dealloc_start_implicit_struct;
 216     v->visitor.end_implicit_struct = qapi_dealloc_end_implicit_struct;
 217     v->visitor.start_list = qapi_dealloc_start_list;
 218     v->visitor.next_list = qapi_dealloc_next_list;
 219     v->visitor.end_list = qapi_dealloc_end_list;
 220     v->visitor.type_enum = qapi_dealloc_type_enum;
 221     v->visitor.type_int64 = qapi_dealloc_type_int64;
 222     v->visitor.type_uint64 = qapi_dealloc_type_uint64;
 223     v->visitor.type_bool = qapi_dealloc_type_bool;
 224     v->visitor.type_str = qapi_dealloc_type_str;
 225     v->visitor.type_number = qapi_dealloc_type_number;
 226     v->visitor.type_any = qapi_dealloc_type_anything;
 227     v->visitor.start_union = qapi_dealloc_start_union;
 228
 229     QTAILQ_INIT(&v->stack);
 230
 231     return v;
 232 }