blob: 7067b4ddf675882644dc0e213bb97b1585c08536 [file]
/*
* QAPI util functions
*
* Authors:
* Hu Tao <hutao@cn.fujitsu.com>
* Peter Lieven <pl@kamp.de>
*
* This work is licensed under the terms of the GNU LGPL, version 2.1 or later.
* See the COPYING.LIB file in the top-level directory.
*
*/
#include "qemu/osdep.h"
#include "qapi/compat-policy.h"
#include "qapi/error.h"
#include "qemu/ctype.h"
#include "qemu/error-report.h"
#include "qapi/qmp/qerror.h"
#include "qapi/error.h"
CompatPolicy compat_policy;
static bool compat_policy_input_ok1(CompatPolicyInput policy,
const char *adjective,
ErrorClass error_class,
const char *kind, const char *name,
Error **errp)
{
switch (policy) {
case COMPAT_POLICY_INPUT_ACCEPT:
return true;
case COMPAT_POLICY_INPUT_WARN:
warn_report("%s %s %s accepted by policy",
adjective, kind, name);
return true;
case COMPAT_POLICY_INPUT_REJECT:
error_set(errp, error_class, "%s %s %s disabled by policy",
adjective, kind, name);
return false;
case COMPAT_POLICY_INPUT_CRASH:
error_report("%s %s %s disabled by policy, aborting",
adjective, kind, name);
/* fallthrough */
default:
abort();
}
}
bool compat_policy_input_ok(const CompatPolicy *policy,
uint64_t features,
ErrorClass error_class,
const char *kind, const char *name,
Error **errp)
{
if ((features & 1u << QAPI_DEPRECATED)
&& !compat_policy_input_ok1(policy->deprecated_input,
"Deprecated",
error_class, kind, name, errp)) {
return false;
}
if ((features & (1u << QAPI_UNSTABLE))
&& !compat_policy_input_ok1(policy->unstable_input,
"Unstable",
error_class, kind, name, errp)) {
return false;
}
return true;
}
bool compat_policy_security_ok(const CompatPolicy *policy,
bool is_secure,
const char *typename,
Error **errp)
{
ERRP_GUARD();
if (is_secure) {
return true;
}
if (!compat_policy_input_ok1(policy->insecure_input,
"Insecure",
ERROR_CLASS_GENERIC_ERROR,
"QOM type", typename, errp)) {
error_append_hint(errp, "This type does does not provide a "
"security boundary to protect against "
"untrusted data or actions\n");
return false;
}
return true;
}
const char *qapi_enum_lookup(const QEnumLookup *lookup, int val)
{
assert(val >= 0 && val < lookup->size);
return lookup->array[val];
}
int qapi_enum_parse(const QEnumLookup *lookup, const char *buf,
int def, Error **errp)
{
int i;
if (!buf) {
return def;
}
for (i = 0; i < lookup->size; i++) {
if (!strcmp(buf, lookup->array[i])) {
return i;
}
}
error_setg(errp, "invalid parameter value: %s", buf);
return def;
}
bool qapi_bool_parse(const char *name, const char *value, bool *obj, Error **errp)
{
if (g_str_equal(value, "on") ||
g_str_equal(value, "yes") ||
g_str_equal(value, "true") ||
g_str_equal(value, "y")) {
*obj = true;
return true;
}
if (g_str_equal(value, "off") ||
g_str_equal(value, "no") ||
g_str_equal(value, "false") ||
g_str_equal(value, "n")) {
*obj = false;
return true;
}
error_setg(errp, QERR_INVALID_PARAMETER_VALUE, name,
"'on' or 'off'");
return false;
}
/*
* Parse a valid QAPI name from @str.
* A valid name consists of letters, digits, hyphen and underscore.
* It may be prefixed by __RFQDN_ (downstream extension), where RFQDN
* may contain only letters, digits, hyphen and period.
* The special exception for enumeration names is not implemented.
* See docs/devel/qapi-code-gen.rst for more on QAPI naming rules.
* Keep this consistent with scripts/qapi-gen.py!
* If @complete, the parse fails unless it consumes @str completely.
* Return its length on success, -1 on failure.
*/
int parse_qapi_name(const char *str, bool complete)
{
const char *p = str;
if (*p == '_') { /* Downstream __RFQDN_ */
p++;
if (*p != '_') {
return -1;
}
while (*++p) {
if (!qemu_isalnum(*p) && *p != '-' && *p != '.') {
break;
}
}
if (*p != '_') {
return -1;
}
p++;
}
if (!qemu_isalpha(*p)) {
return -1;
}
while (*++p) {
if (!qemu_isalnum(*p) && *p != '-' && *p != '_') {
break;
}
}
if (complete && *p) {
return -1;
}
return p - str;
}