xref: /openbmc/qemu/qapi/qapi-util.c (revision b0b1313e)
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/compat-policy.h"
15 #include "qapi/error.h"
16 #include "qemu/ctype.h"
17 #include "qapi/qmp/qerror.h"
18 
19 CompatPolicy compat_policy;
20 
compat_policy_input_ok1(const char * adjective,CompatPolicyInput policy,ErrorClass error_class,const char * kind,const char * name,Error ** errp)21 static bool compat_policy_input_ok1(const char *adjective,
22                                     CompatPolicyInput policy,
23                                     ErrorClass error_class,
24                                     const char *kind, const char *name,
25                                     Error **errp)
26 {
27     switch (policy) {
28     case COMPAT_POLICY_INPUT_ACCEPT:
29         return true;
30     case COMPAT_POLICY_INPUT_REJECT:
31         error_set(errp, error_class, "%s %s %s disabled by policy",
32                   adjective, kind, name);
33         return false;
34     case COMPAT_POLICY_INPUT_CRASH:
35     default:
36         abort();
37     }
38 }
39 
compat_policy_input_ok(unsigned special_features,const CompatPolicy * policy,ErrorClass error_class,const char * kind,const char * name,Error ** errp)40 bool compat_policy_input_ok(unsigned special_features,
41                             const CompatPolicy *policy,
42                             ErrorClass error_class,
43                             const char *kind, const char *name,
44                             Error **errp)
45 {
46     if ((special_features & 1u << QAPI_DEPRECATED)
47         && !compat_policy_input_ok1("Deprecated",
48                                     policy->deprecated_input,
49                                     error_class, kind, name, errp)) {
50         return false;
51     }
52     if ((special_features & (1u << QAPI_UNSTABLE))
53         && !compat_policy_input_ok1("Unstable",
54                                     policy->unstable_input,
55                                     error_class, kind, name, errp)) {
56         return false;
57     }
58     return true;
59 }
60 
qapi_enum_lookup(const QEnumLookup * lookup,int val)61 const char *qapi_enum_lookup(const QEnumLookup *lookup, int val)
62 {
63     assert(val >= 0 && val < lookup->size);
64 
65     return lookup->array[val];
66 }
67 
qapi_enum_parse(const QEnumLookup * lookup,const char * buf,int def,Error ** errp)68 int qapi_enum_parse(const QEnumLookup *lookup, const char *buf,
69                     int def, Error **errp)
70 {
71     int i;
72 
73     if (!buf) {
74         return def;
75     }
76 
77     for (i = 0; i < lookup->size; i++) {
78         if (!strcmp(buf, lookup->array[i])) {
79             return i;
80         }
81     }
82 
83     error_setg(errp, "invalid parameter value: %s", buf);
84     return def;
85 }
86 
qapi_bool_parse(const char * name,const char * value,bool * obj,Error ** errp)87 bool qapi_bool_parse(const char *name, const char *value, bool *obj, Error **errp)
88 {
89     if (g_str_equal(value, "on") ||
90         g_str_equal(value, "yes") ||
91         g_str_equal(value, "true") ||
92         g_str_equal(value, "y")) {
93         *obj = true;
94         return true;
95     }
96     if (g_str_equal(value, "off") ||
97         g_str_equal(value, "no") ||
98         g_str_equal(value, "false") ||
99         g_str_equal(value, "n")) {
100         *obj = false;
101         return true;
102     }
103 
104     error_setg(errp, QERR_INVALID_PARAMETER_VALUE, name,
105                "'on' or 'off'");
106     return false;
107 }
108 
109 /*
110  * Parse a valid QAPI name from @str.
111  * A valid name consists of letters, digits, hyphen and underscore.
112  * It may be prefixed by __RFQDN_ (downstream extension), where RFQDN
113  * may contain only letters, digits, hyphen and period.
114  * The special exception for enumeration names is not implemented.
115  * See docs/devel/qapi-code-gen.rst for more on QAPI naming rules.
116  * Keep this consistent with scripts/qapi-gen.py!
117  * If @complete, the parse fails unless it consumes @str completely.
118  * Return its length on success, -1 on failure.
119  */
parse_qapi_name(const char * str,bool complete)120 int parse_qapi_name(const char *str, bool complete)
121 {
122     const char *p = str;
123 
124     if (*p == '_') {            /* Downstream __RFQDN_ */
125         p++;
126         if (*p != '_') {
127             return -1;
128         }
129         while (*++p) {
130             if (!qemu_isalnum(*p) && *p != '-' && *p != '.') {
131                 break;
132             }
133         }
134 
135         if (*p != '_') {
136             return -1;
137         }
138         p++;
139     }
140 
141     if (!qemu_isalpha(*p)) {
142         return -1;
143     }
144     while (*++p) {
145         if (!qemu_isalnum(*p) && *p != '-' && *p != '_') {
146             break;
147         }
148     }
149 
150     if (complete && *p) {
151         return -1;
152     }
153     return p - str;
154 }
155