2 * Core Definitions for QAPI Visitor Classes
4 * Copyright (C) 2012-2016 Red Hat, Inc.
5 * Copyright IBM, Corp. 2011
8 * Anthony Liguori <aliguori@us.ibm.com>
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.
15 #include "qemu/osdep.h"
16 #include "qapi/error.h"
17 #include "qemu-common.h"
18 #include "qapi/qmp/qobject.h"
19 #include "qapi/qmp/qerror.h"
20 #include "qapi/visitor.h"
21 #include "qapi/visitor-impl.h"
23 void visit_start_struct(Visitor
*v
, const char *name
, void **obj
,
24 size_t size
, Error
**errp
)
30 assert(v
->type
!= VISITOR_OUTPUT
|| *obj
);
32 v
->start_struct(v
, name
, obj
, size
, &err
);
33 if (obj
&& v
->type
== VISITOR_INPUT
) {
34 assert(!err
!= !*obj
);
36 error_propagate(errp
, err
);
39 void visit_check_struct(Visitor
*v
, Error
**errp
)
41 if (v
->check_struct
) {
42 v
->check_struct(v
, errp
);
46 void visit_end_struct(Visitor
*v
)
51 void visit_start_list(Visitor
*v
, const char *name
, Error
**errp
)
53 v
->start_list(v
, name
, errp
);
56 GenericList
*visit_next_list(Visitor
*v
, GenericList
**list
, size_t size
)
58 assert(list
&& size
>= sizeof(GenericList
));
59 return v
->next_list(v
, list
, size
);
62 void visit_end_list(Visitor
*v
)
67 void visit_start_alternate(Visitor
*v
, const char *name
,
68 GenericAlternate
**obj
, size_t size
,
69 bool promote_int
, Error
**errp
)
73 assert(obj
&& size
>= sizeof(GenericAlternate
));
74 assert(v
->type
!= VISITOR_OUTPUT
|| *obj
);
75 if (v
->start_alternate
) {
76 v
->start_alternate(v
, name
, obj
, size
, promote_int
, &err
);
78 if (v
->type
== VISITOR_INPUT
) {
79 assert(v
->start_alternate
&& !err
!= !*obj
);
81 error_propagate(errp
, err
);
84 void visit_end_alternate(Visitor
*v
)
86 if (v
->end_alternate
) {
91 bool visit_optional(Visitor
*v
, const char *name
, bool *present
)
94 v
->optional(v
, name
, present
);
99 void visit_type_int(Visitor
*v
, const char *name
, int64_t *obj
, Error
**errp
)
102 v
->type_int64(v
, name
, obj
, errp
);
105 static void visit_type_uintN(Visitor
*v
, uint64_t *obj
, const char *name
,
106 uint64_t max
, const char *type
, Error
**errp
)
109 uint64_t value
= *obj
;
111 v
->type_uint64(v
, name
, &value
, &err
);
113 error_propagate(errp
, err
);
114 } else if (value
> max
) {
115 error_setg(errp
, QERR_INVALID_PARAMETER_VALUE
,
116 name
? name
: "null", type
);
122 void visit_type_uint8(Visitor
*v
, const char *name
, uint8_t *obj
,
125 uint64_t value
= *obj
;
126 visit_type_uintN(v
, &value
, name
, UINT8_MAX
, "uint8_t", errp
);
130 void visit_type_uint16(Visitor
*v
, const char *name
, uint16_t *obj
,
133 uint64_t value
= *obj
;
134 visit_type_uintN(v
, &value
, name
, UINT16_MAX
, "uint16_t", errp
);
138 void visit_type_uint32(Visitor
*v
, const char *name
, uint32_t *obj
,
141 uint64_t value
= *obj
;
142 visit_type_uintN(v
, &value
, name
, UINT32_MAX
, "uint32_t", errp
);
146 void visit_type_uint64(Visitor
*v
, const char *name
, uint64_t *obj
,
150 v
->type_uint64(v
, name
, obj
, errp
);
153 static void visit_type_intN(Visitor
*v
, int64_t *obj
, const char *name
,
154 int64_t min
, int64_t max
, const char *type
,
158 int64_t value
= *obj
;
160 v
->type_int64(v
, name
, &value
, &err
);
162 error_propagate(errp
, err
);
163 } else if (value
< min
|| value
> max
) {
164 error_setg(errp
, QERR_INVALID_PARAMETER_VALUE
,
165 name
? name
: "null", type
);
171 void visit_type_int8(Visitor
*v
, const char *name
, int8_t *obj
, Error
**errp
)
173 int64_t value
= *obj
;
174 visit_type_intN(v
, &value
, name
, INT8_MIN
, INT8_MAX
, "int8_t", errp
);
178 void visit_type_int16(Visitor
*v
, const char *name
, int16_t *obj
,
181 int64_t value
= *obj
;
182 visit_type_intN(v
, &value
, name
, INT16_MIN
, INT16_MAX
, "int16_t", errp
);
186 void visit_type_int32(Visitor
*v
, const char *name
, int32_t *obj
,
189 int64_t value
= *obj
;
190 visit_type_intN(v
, &value
, name
, INT32_MIN
, INT32_MAX
, "int32_t", errp
);
194 void visit_type_int64(Visitor
*v
, const char *name
, int64_t *obj
,
198 v
->type_int64(v
, name
, obj
, errp
);
201 void visit_type_size(Visitor
*v
, const char *name
, uint64_t *obj
,
206 v
->type_size(v
, name
, obj
, errp
);
208 v
->type_uint64(v
, name
, obj
, errp
);
212 void visit_type_bool(Visitor
*v
, const char *name
, bool *obj
, Error
**errp
)
215 v
->type_bool(v
, name
, obj
, errp
);
218 void visit_type_str(Visitor
*v
, const char *name
, char **obj
, Error
**errp
)
223 /* TODO: Fix callers to not pass NULL when they mean "", so that we
225 assert(v->type != VISITOR_OUTPUT || *obj);
227 v
->type_str(v
, name
, obj
, &err
);
228 if (v
->type
== VISITOR_INPUT
) {
229 assert(!err
!= !*obj
);
231 error_propagate(errp
, err
);
234 void visit_type_number(Visitor
*v
, const char *name
, double *obj
,
238 v
->type_number(v
, name
, obj
, errp
);
241 void visit_type_any(Visitor
*v
, const char *name
, QObject
**obj
, Error
**errp
)
246 assert(v
->type
!= VISITOR_OUTPUT
|| *obj
);
247 v
->type_any(v
, name
, obj
, &err
);
248 if (v
->type
== VISITOR_INPUT
) {
249 assert(!err
!= !*obj
);
251 error_propagate(errp
, err
);
254 void visit_type_null(Visitor
*v
, const char *name
, Error
**errp
)
256 v
->type_null(v
, name
, errp
);
259 static void output_type_enum(Visitor
*v
, const char *name
, int *obj
,
260 const char *const strings
[], Error
**errp
)
266 while (strings
[i
++] != NULL
);
267 if (value
< 0 || value
>= i
- 1) {
268 error_setg(errp
, QERR_INVALID_PARAMETER
, name
? name
: "null");
272 enum_str
= (char *)strings
[value
];
273 visit_type_str(v
, name
, &enum_str
, errp
);
276 static void input_type_enum(Visitor
*v
, const char *name
, int *obj
,
277 const char *const strings
[], Error
**errp
)
279 Error
*local_err
= NULL
;
283 visit_type_str(v
, name
, &enum_str
, &local_err
);
285 error_propagate(errp
, local_err
);
289 while (strings
[value
] != NULL
) {
290 if (strcmp(strings
[value
], enum_str
) == 0) {
296 if (strings
[value
] == NULL
) {
297 error_setg(errp
, QERR_INVALID_PARAMETER
, enum_str
);
306 void visit_type_enum(Visitor
*v
, const char *name
, int *obj
,
307 const char *const strings
[], Error
**errp
)
309 assert(obj
&& strings
);
310 if (v
->type
== VISITOR_INPUT
) {
311 input_type_enum(v
, name
, obj
, strings
, errp
);
312 } else if (v
->type
== VISITOR_OUTPUT
) {
313 output_type_enum(v
, name
, obj
, strings
, errp
);