Merge remote-tracking branch 'remotes/rth/tags/pull-tcg-20210921' into staging
[qemu.git] / qapi / qapi-util.c
1 /*
2 * QAPI util functions
3 *
4 * Authors:
5 * Hu Tao <hutao@cn.fujitsu.com>
6 * Peter Lieven <pl@kamp.de>
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
13 #include "qemu/osdep.h"
14 #include "qapi/error.h"
15 #include "qemu/ctype.h"
16 #include "qapi/qmp/qerror.h"
17
18 const char *qapi_enum_lookup(const QEnumLookup *lookup, int val)
19 {
20 assert(val >= 0 && val < lookup->size);
21
22 return lookup->array[val];
23 }
24
25 int qapi_enum_parse(const QEnumLookup *lookup, const char *buf,
26 int def, Error **errp)
27 {
28 int i;
29
30 if (!buf) {
31 return def;
32 }
33
34 for (i = 0; i < lookup->size; i++) {
35 if (!strcmp(buf, lookup->array[i])) {
36 return i;
37 }
38 }
39
40 error_setg(errp, "invalid parameter value: %s", buf);
41 return def;
42 }
43
44 bool qapi_bool_parse(const char *name, const char *value, bool *obj, Error **errp)
45 {
46 if (g_str_equal(value, "on") ||
47 g_str_equal(value, "yes") ||
48 g_str_equal(value, "true") ||
49 g_str_equal(value, "y")) {
50 *obj = true;
51 return true;
52 }
53 if (g_str_equal(value, "off") ||
54 g_str_equal(value, "no") ||
55 g_str_equal(value, "false") ||
56 g_str_equal(value, "n")) {
57 *obj = false;
58 return true;
59 }
60
61 error_setg(errp, QERR_INVALID_PARAMETER_VALUE, name,
62 "'on' or 'off'");
63 return false;
64 }
65
66 /*
67 * Parse a valid QAPI name from @str.
68 * A valid name consists of letters, digits, hyphen and underscore.
69 * It may be prefixed by __RFQDN_ (downstream extension), where RFQDN
70 * may contain only letters, digits, hyphen and period.
71 * The special exception for enumeration names is not implemented.
72 * See docs/devel/qapi-code-gen.txt for more on QAPI naming rules.
73 * Keep this consistent with scripts/qapi.py!
74 * If @complete, the parse fails unless it consumes @str completely.
75 * Return its length on success, -1 on failure.
76 */
77 int parse_qapi_name(const char *str, bool complete)
78 {
79 const char *p = str;
80
81 if (*p == '_') { /* Downstream __RFQDN_ */
82 p++;
83 if (*p != '_') {
84 return -1;
85 }
86 while (*++p) {
87 if (!qemu_isalnum(*p) && *p != '-' && *p != '.') {
88 break;
89 }
90 }
91
92 if (*p != '_') {
93 return -1;
94 }
95 p++;
96 }
97
98 if (!qemu_isalpha(*p)) {
99 return -1;
100 }
101 while (*++p) {
102 if (!qemu_isalnum(*p) && *p != '-' && *p != '_') {
103 break;
104 }
105 }
106
107 if (complete && *p) {
108 return -1;
109 }
110 return p - str;
111 }