]>
Commit | Line | Data |
---|---|---|
a020f980 PB |
1 | /* |
2 | * String printing Visitor | |
3 | * | |
08f9541d | 4 | * Copyright Red Hat, Inc. 2012-2016 |
a020f980 PB |
5 | * |
6 | * Author: Paolo Bonzini <[email protected]> | |
7 | * | |
8 | * This work is licensed under the terms of the GNU LGPL, version 2.1 or later. | |
9 | * See the COPYING.LIB file in the top-level directory. | |
10 | * | |
11 | */ | |
12 | ||
cbf21151 | 13 | #include "qemu/osdep.h" |
31e40415 | 14 | #include "qemu/cutils.h" |
7b1b5d19 PB |
15 | #include "qapi/string-output-visitor.h" |
16 | #include "qapi/visitor-impl.h" | |
e41b509d | 17 | #include <math.h> |
69e25563 HT |
18 | #include "qemu/range.h" |
19 | ||
20 | enum ListMode { | |
21 | LM_NONE, /* not traversing a list of repeated options */ | |
d9f62dde | 22 | LM_STARTED, /* next_list() ready to be called */ |
69e25563 HT |
23 | |
24 | LM_IN_PROGRESS, /* next_list() has been called. | |
25 | * | |
26 | * Generating the next list link will consume the most | |
27 | * recently parsed QemuOpt instance of the repeated | |
28 | * option. | |
29 | * | |
30 | * Parsing a value into the list link will examine the | |
31 | * next QemuOpt instance of the repeated option, and | |
32 | * possibly enter LM_SIGNED_INTERVAL or | |
33 | * LM_UNSIGNED_INTERVAL. | |
34 | */ | |
35 | ||
36 | LM_SIGNED_INTERVAL, /* next_list() has been called. | |
37 | * | |
38 | * Generating the next list link will consume the most | |
39 | * recently stored element from the signed interval, | |
40 | * parsed from the most recent QemuOpt instance of the | |
41 | * repeated option. This may consume QemuOpt itself | |
42 | * and return to LM_IN_PROGRESS. | |
43 | * | |
44 | * Parsing a value into the list link will store the | |
45 | * next element of the signed interval. | |
46 | */ | |
47 | ||
48 | LM_UNSIGNED_INTERVAL,/* Same as above, only for an unsigned interval. */ | |
49 | ||
d9f62dde | 50 | LM_END, /* next_list() called, about to see last element. */ |
69e25563 HT |
51 | }; |
52 | ||
53 | typedef enum ListMode ListMode; | |
a020f980 PB |
54 | |
55 | struct StringOutputVisitor | |
56 | { | |
57 | Visitor visitor; | |
0b7593e0 | 58 | bool human; |
69e25563 | 59 | GString *string; |
3b098d56 | 60 | char **result; |
69e25563 HT |
61 | ListMode list_mode; |
62 | union { | |
63 | int64_t s; | |
64 | uint64_t u; | |
65 | } range_start, range_end; | |
66 | GList *ranges; | |
1158bb2a | 67 | void *list; /* Only needed for sanity checking the caller */ |
a020f980 PB |
68 | }; |
69 | ||
d7bea75d EB |
70 | static StringOutputVisitor *to_sov(Visitor *v) |
71 | { | |
72 | return container_of(v, StringOutputVisitor, visitor); | |
73 | } | |
74 | ||
a020f980 PB |
75 | static void string_output_set(StringOutputVisitor *sov, char *string) |
76 | { | |
69e25563 HT |
77 | if (sov->string) { |
78 | g_string_free(sov->string, true); | |
79 | } | |
80 | sov->string = g_string_new(string); | |
81 | g_free(string); | |
82 | } | |
83 | ||
84 | static void string_output_append(StringOutputVisitor *sov, int64_t a) | |
85 | { | |
86 | Range *r = g_malloc0(sizeof(*r)); | |
a0efbf16 MA |
87 | |
88 | range_set_bounds(r, a, a); | |
7c47959d | 89 | sov->ranges = range_list_insert(sov->ranges, r); |
69e25563 HT |
90 | } |
91 | ||
92 | static void string_output_append_range(StringOutputVisitor *sov, | |
93 | int64_t s, int64_t e) | |
94 | { | |
95 | Range *r = g_malloc0(sizeof(*r)); | |
a0efbf16 MA |
96 | |
97 | range_set_bounds(r, s, e); | |
7c47959d | 98 | sov->ranges = range_list_insert(sov->ranges, r); |
69e25563 HT |
99 | } |
100 | ||
101 | static void format_string(StringOutputVisitor *sov, Range *r, bool next, | |
102 | bool human) | |
103 | { | |
a0efbf16 | 104 | if (range_lob(r) != range_upb(r)) { |
69e25563 | 105 | if (human) { |
684531ad | 106 | g_string_append_printf(sov->string, "0x%" PRIx64 "-0x%" PRIx64, |
a0efbf16 | 107 | range_lob(r), range_upb(r)); |
69e25563 HT |
108 | |
109 | } else { | |
110 | g_string_append_printf(sov->string, "%" PRId64 "-%" PRId64, | |
a0efbf16 | 111 | range_lob(r), range_upb(r)); |
69e25563 HT |
112 | } |
113 | } else { | |
114 | if (human) { | |
a0efbf16 | 115 | g_string_append_printf(sov->string, "0x%" PRIx64, range_lob(r)); |
69e25563 | 116 | } else { |
a0efbf16 | 117 | g_string_append_printf(sov->string, "%" PRId64, range_lob(r)); |
69e25563 HT |
118 | } |
119 | } | |
120 | if (next) { | |
121 | g_string_append(sov->string, ","); | |
122 | } | |
a020f980 PB |
123 | } |
124 | ||
012d4c96 | 125 | static bool print_type_int64(Visitor *v, const char *name, int64_t *obj, |
4c40314a | 126 | Error **errp) |
a020f980 | 127 | { |
d7bea75d | 128 | StringOutputVisitor *sov = to_sov(v); |
69e25563 HT |
129 | GList *l; |
130 | ||
131 | switch (sov->list_mode) { | |
132 | case LM_NONE: | |
133 | string_output_append(sov, *obj); | |
134 | break; | |
135 | ||
136 | case LM_STARTED: | |
137 | sov->range_start.s = *obj; | |
138 | sov->range_end.s = *obj; | |
139 | sov->list_mode = LM_IN_PROGRESS; | |
012d4c96 | 140 | return true; |
69e25563 HT |
141 | |
142 | case LM_IN_PROGRESS: | |
143 | if (sov->range_end.s + 1 == *obj) { | |
144 | sov->range_end.s++; | |
145 | } else { | |
146 | if (sov->range_start.s == sov->range_end.s) { | |
147 | string_output_append(sov, sov->range_end.s); | |
148 | } else { | |
149 | assert(sov->range_start.s < sov->range_end.s); | |
150 | string_output_append_range(sov, sov->range_start.s, | |
151 | sov->range_end.s); | |
152 | } | |
153 | ||
154 | sov->range_start.s = *obj; | |
155 | sov->range_end.s = *obj; | |
156 | } | |
012d4c96 | 157 | return true; |
69e25563 HT |
158 | |
159 | case LM_END: | |
160 | if (sov->range_end.s + 1 == *obj) { | |
161 | sov->range_end.s++; | |
162 | assert(sov->range_start.s < sov->range_end.s); | |
163 | string_output_append_range(sov, sov->range_start.s, | |
164 | sov->range_end.s); | |
165 | } else { | |
166 | if (sov->range_start.s == sov->range_end.s) { | |
167 | string_output_append(sov, sov->range_end.s); | |
168 | } else { | |
169 | assert(sov->range_start.s < sov->range_end.s); | |
170 | ||
171 | string_output_append_range(sov, sov->range_start.s, | |
172 | sov->range_end.s); | |
173 | } | |
174 | string_output_append(sov, *obj); | |
175 | } | |
176 | break; | |
177 | ||
178 | default: | |
179 | abort(); | |
180 | } | |
181 | ||
182 | l = sov->ranges; | |
183 | while (l) { | |
184 | Range *r = l->data; | |
185 | format_string(sov, r, l->next != NULL, false); | |
186 | l = l->next; | |
187 | } | |
0b7593e0 PB |
188 | |
189 | if (sov->human) { | |
69e25563 HT |
190 | l = sov->ranges; |
191 | g_string_append(sov->string, " ("); | |
192 | while (l) { | |
193 | Range *r = l->data; | |
56fdfb61 | 194 | format_string(sov, r, l->next != NULL, true); |
69e25563 HT |
195 | l = l->next; |
196 | } | |
197 | g_string_append(sov->string, ")"); | |
0b7593e0 | 198 | } |
012d4c96 MA |
199 | |
200 | return true; | |
0b7593e0 PB |
201 | } |
202 | ||
012d4c96 | 203 | static bool print_type_uint64(Visitor *v, const char *name, uint64_t *obj, |
f755dea7 EB |
204 | Error **errp) |
205 | { | |
206 | /* FIXME: print_type_int64 mishandles values over INT64_MAX */ | |
207 | int64_t i = *obj; | |
012d4c96 | 208 | return print_type_int64(v, name, &i, errp); |
f755dea7 EB |
209 | } |
210 | ||
012d4c96 | 211 | static bool print_type_size(Visitor *v, const char *name, uint64_t *obj, |
0b2a0d6b | 212 | Error **errp) |
0b7593e0 | 213 | { |
d7bea75d | 214 | StringOutputVisitor *sov = to_sov(v); |
22951aaa PX |
215 | uint64_t val; |
216 | char *out, *psize; | |
0b7593e0 PB |
217 | |
218 | if (!sov->human) { | |
e41b509d | 219 | out = g_strdup_printf("%"PRIu64, *obj); |
0b7593e0 | 220 | string_output_set(sov, out); |
012d4c96 | 221 | return true; |
0b7593e0 PB |
222 | } |
223 | ||
224 | val = *obj; | |
22951aaa PX |
225 | psize = size_to_str(val); |
226 | out = g_strdup_printf("%"PRIu64" (%s)", val, psize); | |
0b7593e0 | 227 | string_output_set(sov, out); |
22951aaa PX |
228 | |
229 | g_free(psize); | |
012d4c96 | 230 | return true; |
a020f980 PB |
231 | } |
232 | ||
012d4c96 | 233 | static bool print_type_bool(Visitor *v, const char *name, bool *obj, |
a020f980 PB |
234 | Error **errp) |
235 | { | |
d7bea75d | 236 | StringOutputVisitor *sov = to_sov(v); |
a020f980 | 237 | string_output_set(sov, g_strdup(*obj ? "true" : "false")); |
012d4c96 | 238 | return true; |
a020f980 PB |
239 | } |
240 | ||
012d4c96 | 241 | static bool print_type_str(Visitor *v, const char *name, char **obj, |
a020f980 PB |
242 | Error **errp) |
243 | { | |
d7bea75d | 244 | StringOutputVisitor *sov = to_sov(v); |
0b7593e0 PB |
245 | char *out; |
246 | ||
247 | if (sov->human) { | |
248 | out = *obj ? g_strdup_printf("\"%s\"", *obj) : g_strdup("<null>"); | |
249 | } else { | |
250 | out = g_strdup(*obj ? *obj : ""); | |
251 | } | |
252 | string_output_set(sov, out); | |
012d4c96 | 253 | return true; |
a020f980 PB |
254 | } |
255 | ||
012d4c96 | 256 | static bool print_type_number(Visitor *v, const char *name, double *obj, |
a020f980 PB |
257 | Error **errp) |
258 | { | |
d7bea75d | 259 | StringOutputVisitor *sov = to_sov(v); |
54addb01 | 260 | string_output_set(sov, g_strdup_printf("%.17g", *obj)); |
012d4c96 | 261 | return true; |
a020f980 PB |
262 | } |
263 | ||
012d4c96 | 264 | static bool print_type_null(Visitor *v, const char *name, QNull **obj, |
d2f95f4d | 265 | Error **errp) |
a7333712 GK |
266 | { |
267 | StringOutputVisitor *sov = to_sov(v); | |
268 | char *out; | |
269 | ||
270 | if (sov->human) { | |
271 | out = g_strdup("<null>"); | |
272 | } else { | |
273 | out = g_strdup(""); | |
274 | } | |
275 | string_output_set(sov, out); | |
012d4c96 | 276 | return true; |
a7333712 GK |
277 | } |
278 | ||
012d4c96 | 279 | static bool |
d9f62dde EB |
280 | start_list(Visitor *v, const char *name, GenericList **list, size_t size, |
281 | Error **errp) | |
69e25563 | 282 | { |
d7bea75d | 283 | StringOutputVisitor *sov = to_sov(v); |
69e25563 HT |
284 | |
285 | /* we can't traverse a list in a list */ | |
286 | assert(sov->list_mode == LM_NONE); | |
d9f62dde EB |
287 | /* We don't support visits without a list */ |
288 | assert(list); | |
1158bb2a | 289 | sov->list = list; |
d9f62dde EB |
290 | /* List handling is only needed if there are at least two elements */ |
291 | if (*list && (*list)->next) { | |
292 | sov->list_mode = LM_STARTED; | |
293 | } | |
012d4c96 | 294 | return true; |
69e25563 HT |
295 | } |
296 | ||
d9f62dde | 297 | static GenericList *next_list(Visitor *v, GenericList *tail, size_t size) |
69e25563 | 298 | { |
d7bea75d | 299 | StringOutputVisitor *sov = to_sov(v); |
d9f62dde | 300 | GenericList *ret = tail->next; |
69e25563 | 301 | |
d9f62dde EB |
302 | if (ret && !ret->next) { |
303 | sov->list_mode = LM_END; | |
69e25563 | 304 | } |
69e25563 HT |
305 | return ret; |
306 | } | |
307 | ||
1158bb2a | 308 | static void end_list(Visitor *v, void **obj) |
69e25563 | 309 | { |
d7bea75d | 310 | StringOutputVisitor *sov = to_sov(v); |
69e25563 | 311 | |
1158bb2a | 312 | assert(sov->list == obj); |
69e25563 HT |
313 | assert(sov->list_mode == LM_STARTED || |
314 | sov->list_mode == LM_END || | |
315 | sov->list_mode == LM_NONE || | |
316 | sov->list_mode == LM_IN_PROGRESS); | |
317 | sov->list_mode = LM_NONE; | |
69e25563 HT |
318 | } |
319 | ||
3b098d56 | 320 | static void string_output_complete(Visitor *v, void *opaque) |
a020f980 | 321 | { |
3b098d56 | 322 | StringOutputVisitor *sov = to_sov(v); |
a020f980 | 323 | |
3b098d56 EB |
324 | assert(opaque == sov->result); |
325 | *sov->result = g_string_free(sov->string, false); | |
326 | sov->string = NULL; | |
a020f980 PB |
327 | } |
328 | ||
0d156683 MT |
329 | static void free_range(void *range, void *dummy) |
330 | { | |
331 | g_free(range); | |
332 | } | |
333 | ||
2c0ef9f4 EB |
334 | static void string_output_free(Visitor *v) |
335 | { | |
336 | StringOutputVisitor *sov = to_sov(v); | |
337 | ||
69e25563 HT |
338 | if (sov->string) { |
339 | g_string_free(sov->string, true); | |
340 | } | |
341 | ||
0d156683 MT |
342 | g_list_foreach(sov->ranges, free_range, NULL); |
343 | g_list_free(sov->ranges); | |
a020f980 PB |
344 | g_free(sov); |
345 | } | |
346 | ||
3b098d56 | 347 | Visitor *string_output_visitor_new(bool human, char **result) |
a020f980 PB |
348 | { |
349 | StringOutputVisitor *v; | |
350 | ||
351 | v = g_malloc0(sizeof(*v)); | |
352 | ||
69e25563 | 353 | v->string = g_string_new(NULL); |
0b7593e0 | 354 | v->human = human; |
3b098d56 EB |
355 | v->result = result; |
356 | *result = NULL; | |
357 | ||
983f52d4 | 358 | v->visitor.type = VISITOR_OUTPUT; |
4c40314a | 359 | v->visitor.type_int64 = print_type_int64; |
f755dea7 | 360 | v->visitor.type_uint64 = print_type_uint64; |
0b7593e0 | 361 | v->visitor.type_size = print_type_size; |
a020f980 PB |
362 | v->visitor.type_bool = print_type_bool; |
363 | v->visitor.type_str = print_type_str; | |
364 | v->visitor.type_number = print_type_number; | |
a7333712 | 365 | v->visitor.type_null = print_type_null; |
69e25563 HT |
366 | v->visitor.start_list = start_list; |
367 | v->visitor.next_list = next_list; | |
368 | v->visitor.end_list = end_list; | |
3b098d56 | 369 | v->visitor.complete = string_output_complete; |
2c0ef9f4 | 370 | v->visitor.free = string_output_free; |
a020f980 | 371 | |
3b098d56 | 372 | return &v->visitor; |
a020f980 | 373 | } |