]>
git.proxmox.com Git - mirror_qemu.git/blob - qapi/string-output-visitor.c
2 * String printing Visitor
4 * Copyright Red Hat, Inc. 2012-2016
6 * Author: Paolo Bonzini <pbonzini@redhat.com>
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.
13 #include "qemu/osdep.h"
14 #include "qemu-common.h"
15 #include "qapi/string-output-visitor.h"
16 #include "qapi/visitor-impl.h"
17 #include "qemu/host-utils.h"
19 #include "qemu/range.h"
22 LM_NONE
, /* not traversing a list of repeated options */
23 LM_STARTED
, /* next_list() ready to be called */
25 LM_IN_PROGRESS
, /* next_list() has been called.
27 * Generating the next list link will consume the most
28 * recently parsed QemuOpt instance of the repeated
31 * Parsing a value into the list link will examine the
32 * next QemuOpt instance of the repeated option, and
33 * possibly enter LM_SIGNED_INTERVAL or
34 * LM_UNSIGNED_INTERVAL.
37 LM_SIGNED_INTERVAL
, /* next_list() has been called.
39 * Generating the next list link will consume the most
40 * recently stored element from the signed interval,
41 * parsed from the most recent QemuOpt instance of the
42 * repeated option. This may consume QemuOpt itself
43 * and return to LM_IN_PROGRESS.
45 * Parsing a value into the list link will store the
46 * next element of the signed interval.
49 LM_UNSIGNED_INTERVAL
,/* Same as above, only for an unsigned interval. */
51 LM_END
, /* next_list() called, about to see last element. */
54 typedef enum ListMode ListMode
;
56 struct StringOutputVisitor
65 } range_start
, range_end
;
67 void *list
; /* Only needed for sanity checking the caller */
70 static StringOutputVisitor
*to_sov(Visitor
*v
)
72 return container_of(v
, StringOutputVisitor
, visitor
);
75 static void string_output_set(StringOutputVisitor
*sov
, char *string
)
78 g_string_free(sov
->string
, true);
80 sov
->string
= g_string_new(string
);
84 static void string_output_append(StringOutputVisitor
*sov
, int64_t a
)
86 Range
*r
= g_malloc0(sizeof(*r
));
88 range_set_bounds(r
, a
, a
);
89 sov
->ranges
= range_list_insert(sov
->ranges
, r
);
92 static void string_output_append_range(StringOutputVisitor
*sov
,
95 Range
*r
= g_malloc0(sizeof(*r
));
97 range_set_bounds(r
, s
, e
);
98 sov
->ranges
= range_list_insert(sov
->ranges
, r
);
101 static void format_string(StringOutputVisitor
*sov
, Range
*r
, bool next
,
104 if (range_lob(r
) != range_upb(r
)) {
106 g_string_append_printf(sov
->string
, "0x%" PRIx64
"-0x%" PRIx64
,
107 range_lob(r
), range_upb(r
));
110 g_string_append_printf(sov
->string
, "%" PRId64
"-%" PRId64
,
111 range_lob(r
), range_upb(r
));
115 g_string_append_printf(sov
->string
, "0x%" PRIx64
, range_lob(r
));
117 g_string_append_printf(sov
->string
, "%" PRId64
, range_lob(r
));
121 g_string_append(sov
->string
, ",");
125 static void print_type_int64(Visitor
*v
, const char *name
, int64_t *obj
,
128 StringOutputVisitor
*sov
= to_sov(v
);
131 switch (sov
->list_mode
) {
133 string_output_append(sov
, *obj
);
137 sov
->range_start
.s
= *obj
;
138 sov
->range_end
.s
= *obj
;
139 sov
->list_mode
= LM_IN_PROGRESS
;
143 if (sov
->range_end
.s
+ 1 == *obj
) {
146 if (sov
->range_start
.s
== sov
->range_end
.s
) {
147 string_output_append(sov
, sov
->range_end
.s
);
149 assert(sov
->range_start
.s
< sov
->range_end
.s
);
150 string_output_append_range(sov
, sov
->range_start
.s
,
154 sov
->range_start
.s
= *obj
;
155 sov
->range_end
.s
= *obj
;
160 if (sov
->range_end
.s
+ 1 == *obj
) {
162 assert(sov
->range_start
.s
< sov
->range_end
.s
);
163 string_output_append_range(sov
, sov
->range_start
.s
,
166 if (sov
->range_start
.s
== sov
->range_end
.s
) {
167 string_output_append(sov
, sov
->range_end
.s
);
169 assert(sov
->range_start
.s
< sov
->range_end
.s
);
171 string_output_append_range(sov
, sov
->range_start
.s
,
174 string_output_append(sov
, *obj
);
185 format_string(sov
, r
, l
->next
!= NULL
, false);
191 g_string_append(sov
->string
, " (");
194 format_string(sov
, r
, l
->next
!= NULL
, true);
197 g_string_append(sov
->string
, ")");
201 static void print_type_uint64(Visitor
*v
, const char *name
, uint64_t *obj
,
204 /* FIXME: print_type_int64 mishandles values over INT64_MAX */
206 print_type_int64(v
, name
, &i
, errp
);
209 static void print_type_size(Visitor
*v
, const char *name
, uint64_t *obj
,
212 StringOutputVisitor
*sov
= to_sov(v
);
213 static const char suffixes
[] = { 'B', 'K', 'M', 'G', 'T', 'P', 'E' };
219 out
= g_strdup_printf("%"PRIu64
, *obj
);
220 string_output_set(sov
, out
);
226 /* The exponent (returned in i) minus one gives us
227 * floor(log2(val * 1024 / 1000). The correction makes us
228 * switch to the higher power when the integer part is >= 1000.
230 frexp(val
/ (1000.0 / 1024.0), &i
);
232 assert(i
< ARRAY_SIZE(suffixes
));
233 div
= 1ULL << (i
* 10);
235 out
= g_strdup_printf("%"PRIu64
" (%0.3g %c%s)", val
,
236 (double)val
/div
, suffixes
[i
], i
? "iB" : "");
237 string_output_set(sov
, out
);
240 static void print_type_bool(Visitor
*v
, const char *name
, bool *obj
,
243 StringOutputVisitor
*sov
= to_sov(v
);
244 string_output_set(sov
, g_strdup(*obj
? "true" : "false"));
247 static void print_type_str(Visitor
*v
, const char *name
, char **obj
,
250 StringOutputVisitor
*sov
= to_sov(v
);
254 out
= *obj
? g_strdup_printf("\"%s\"", *obj
) : g_strdup("<null>");
256 out
= g_strdup(*obj
? *obj
: "");
258 string_output_set(sov
, out
);
261 static void print_type_number(Visitor
*v
, const char *name
, double *obj
,
264 StringOutputVisitor
*sov
= to_sov(v
);
265 string_output_set(sov
, g_strdup_printf("%f", *obj
));
269 start_list(Visitor
*v
, const char *name
, GenericList
**list
, size_t size
,
272 StringOutputVisitor
*sov
= to_sov(v
);
274 /* we can't traverse a list in a list */
275 assert(sov
->list_mode
== LM_NONE
);
276 /* We don't support visits without a list */
279 /* List handling is only needed if there are at least two elements */
280 if (*list
&& (*list
)->next
) {
281 sov
->list_mode
= LM_STARTED
;
285 static GenericList
*next_list(Visitor
*v
, GenericList
*tail
, size_t size
)
287 StringOutputVisitor
*sov
= to_sov(v
);
288 GenericList
*ret
= tail
->next
;
290 if (ret
&& !ret
->next
) {
291 sov
->list_mode
= LM_END
;
296 static void end_list(Visitor
*v
, void **obj
)
298 StringOutputVisitor
*sov
= to_sov(v
);
300 assert(sov
->list
== obj
);
301 assert(sov
->list_mode
== LM_STARTED
||
302 sov
->list_mode
== LM_END
||
303 sov
->list_mode
== LM_NONE
||
304 sov
->list_mode
== LM_IN_PROGRESS
);
305 sov
->list_mode
= LM_NONE
;
308 char *string_output_get_string(StringOutputVisitor
*sov
)
310 char *string
= g_string_free(sov
->string
, false);
315 Visitor
*string_output_get_visitor(StringOutputVisitor
*sov
)
317 return &sov
->visitor
;
320 static void free_range(void *range
, void *dummy
)
325 static void string_output_free(Visitor
*v
)
327 StringOutputVisitor
*sov
= to_sov(v
);
329 string_output_visitor_cleanup(sov
);
332 void string_output_visitor_cleanup(StringOutputVisitor
*sov
)
335 g_string_free(sov
->string
, true);
338 g_list_foreach(sov
->ranges
, free_range
, NULL
);
339 g_list_free(sov
->ranges
);
343 StringOutputVisitor
*string_output_visitor_new(bool human
)
345 StringOutputVisitor
*v
;
347 v
= g_malloc0(sizeof(*v
));
349 v
->string
= g_string_new(NULL
);
351 v
->visitor
.type
= VISITOR_OUTPUT
;
352 v
->visitor
.type_int64
= print_type_int64
;
353 v
->visitor
.type_uint64
= print_type_uint64
;
354 v
->visitor
.type_size
= print_type_size
;
355 v
->visitor
.type_bool
= print_type_bool
;
356 v
->visitor
.type_str
= print_type_str
;
357 v
->visitor
.type_number
= print_type_number
;
358 v
->visitor
.start_list
= start_list
;
359 v
->visitor
.next_list
= next_list
;
360 v
->visitor
.end_list
= end_list
;
361 v
->visitor
.free
= string_output_free
;