From nobody Sun Feb 8 22:35:00 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1628784902007391.8898048277814; Thu, 12 Aug 2021 09:15:02 -0700 (PDT) Received: from localhost ([::1]:48816 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mEDMC-0002L8-V8 for importer@patchew.org; Thu, 12 Aug 2021 12:15:00 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:40744) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mEDJ7-0005C3-JN for qemu-devel@nongnu.org; Thu, 12 Aug 2021 12:11:49 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]:40575) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mEDJ4-0001O4-Ji for qemu-devel@nongnu.org; Thu, 12 Aug 2021 12:11:49 -0400 Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-80-Nry8fZfKOmys49UjqZiiLw-1; Thu, 12 Aug 2021 12:11:44 -0400 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id C363D800493 for ; Thu, 12 Aug 2021 16:11:43 +0000 (UTC) Received: from merkur.fritz.box (unknown [10.39.194.67]) by smtp.corp.redhat.com (Postfix) with ESMTP id D23EE5FC22; Thu, 12 Aug 2021 16:11:42 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1628784706; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=LWymCUA+oKy+rAWEfR+PC7qlzYe7fMXznqGfg/fQHZw=; b=fbnVXZUFklHooSemaLmYnqoT8pFkMsEwi5PrX5pZaM62eL6gin+Oq5ccnSKHLr0WJiBdPY B5vJ3ADLYG0FOatVbt36roNSUiIR0xXh0amHeX+eUxZu9a1reCFRv5LNBoHAbMUTGUMYfr AmHvGti1Wk+8DZDi3XKIzTi0HxTViJg= X-MC-Unique: Nry8fZfKOmys49UjqZiiLw-1 From: Kevin Wolf To: qemu-devel@nongnu.org Subject: [PATCH v3 4/6] qapi: Apply aliases in qobject-input-visitor Date: Thu, 12 Aug 2021 18:11:29 +0200 Message-Id: <20210812161131.92017-5-kwolf@redhat.com> In-Reply-To: <20210812161131.92017-1-kwolf@redhat.com> References: <20210812161131.92017-1-kwolf@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=kwolf@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=170.10.133.124; envelope-from=kwolf@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -34 X-Spam_score: -3.5 X-Spam_bar: --- X-Spam_report: (-3.5 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.701, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: kwolf@redhat.com, jsnow@redhat.com, armbru@redhat.com Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1628784904327100001 Content-Type: text/plain; charset="utf-8" When looking for an object in a struct in the external representation, check not only the currently visited struct, but also whether an alias in the current StackObject matches and try to fetch the value from the alias then. Providing two values for the same object through different aliases is an error. Signed-off-by: Kevin Wolf --- qapi/qobject-input-visitor.c | 227 +++++++++++++++++++++++++++++++++-- 1 file changed, 218 insertions(+), 9 deletions(-) diff --git a/qapi/qobject-input-visitor.c b/qapi/qobject-input-visitor.c index 16a75442ff..6193df28a5 100644 --- a/qapi/qobject-input-visitor.c +++ b/qapi/qobject-input-visitor.c @@ -97,6 +97,8 @@ struct QObjectInputVisitor { QObject *root; bool keyval; /* Assume @root made with keyval_parse() */ =20 + QDict *empty_qdict; /* Used for implicit objects */ + /* Stack of objects being visited (all entries will be either * QDict or QList). */ QSLIST_HEAD(, StackObject) stack; @@ -169,9 +171,190 @@ static const char *full_name(QObjectInputVisitor *qiv= , const char *name) return full_name_so(qiv, name, false, tos); } =20 +static bool find_object_member(QObjectInputVisitor *qiv, + StackObject **so, const char **name, + bool *is_alias_prefix, Error **errp); + +/* + * Check whether the member @name in @so, or an alias for it, is + * present in the input and can be used to obtain the value. + */ +static bool input_present(QObjectInputVisitor *qiv, StackObject *so, + const char *name) +{ + /* + * Check whether the alias member is present in the input + * (possibly recursively because aliases are transitive). + * The QAPI generator makes sure that alises cannot form loops, so + * the recursion guaranteed to terminate. + */ + if (!find_object_member(qiv, &so, &name, NULL, NULL)) { + return false; + } + + /* + * Every source can be used only once. If a value in the input + * would end up being used twice through aliases, we'll fail the + * second access. + */ + if (!g_hash_table_contains(so->h, name)) { + return false; + } + + return true; +} + +/* + * Check whether the member @name in the object visited by @so can be + * specified in the input by using the alias described by @a (which + * must be an alias contained in so->aliases). + * + * If @name is only a prefix of the alias source, but doesn't match + * immediately, false is returned and *is_alias_prefix is set to true + * if it is non-NULL. In all other cases, *is_alias_prefix is left + * unchanged. + */ +static bool alias_source_matches(QObjectInputVisitor *qiv, + StackObject *so, InputVisitorAlias *a, + const char *name, bool *is_alias_prefix) +{ + if (a->src[0] =3D=3D NULL) { + assert(a->name =3D=3D NULL); + return true; + } + + if (!strcmp(a->src[0], name)) { + if (a->name && a->src[1] =3D=3D NULL) { + /* + * We're matching an exact member, the source for this alias is + * immediately in @so. + */ + return true; + } else if (is_alias_prefix) { + /* + * We're only looking at a prefix of the source path for the a= lias. + * If the input contains no object of the requested name, we w= ill + * implicitly create an empty one so that the alias can still = be + * used. + * + * We want to create the implicit object only if the alias is + * actually used, but we can't tell here for wildcard aliases = (only + * a later visitor call will determine this). This means that + * wildcard aliases must never have optional keys in their sou= rce + * path. The QAPI generator checks this condition. + */ + if (!a->name || input_present(qiv, a->alias_so, a->name)) { + *is_alias_prefix =3D true; + } + } + } + + return false; +} + +/* + * Find the place in the input where the value for the object member + * @name in @so is specified, considering applicable aliases. + * + * If a value could be found, true is returned and @so and @name are + * updated to identify the key name and StackObject where the value + * can be found in the input. (This is either unchanged or the + * alias_so/name of an alias.) The value of @is_alias_prefix on + * return is undefined in this case. + * + * If no value could be found in the input, false is returned and @so + * and @name are set to NULL. This is not an error and @errp remains + * unchanged. If @is_alias_prefix is non-NULL, it is set to true if + * the given name is a prefix of the source path of an alias for which + * a value may be present in the input. It is set to false otherwise. + * + * If an error occurs (e.g. two values are specified for the member + * through different names), false is returned and @errp is set. The + * value of @is_alias_prefix on return is undefined in this case. + */ +static bool find_object_member(QObjectInputVisitor *qiv, + StackObject **so, const char **name, + bool *is_alias_prefix, Error **errp) +{ + QDict *qdict =3D qobject_to(QDict, (*so)->obj); + const char *found_name =3D NULL; + StackObject *found_so =3D NULL; + bool found_is_wildcard =3D false; + InputVisitorAlias *a; + + if (is_alias_prefix) { + *is_alias_prefix =3D false; + } + + /* Directly present in the container */ + if (qdict_haskey(qdict, *name)) { + found_name =3D *name; + found_so =3D *so; + } + + /* + * Find aliases whose source path matches @name in this StackObject. W= e can + * then get the value with the key a->name from a->alias_so. + */ + QSLIST_FOREACH(a, &(*so)->aliases, next) { + if (a->name =3D=3D NULL && found_name && !found_is_wildcard) { + /* + * Skip wildcard aliases if we already have a match. This is + * not a conflict that should result in an error. + * + * However, multiple wildcard aliases matching is an error + * and will be caught below. + */ + continue; + } + + if (!alias_source_matches(qiv, *so, a, *name, is_alias_prefix)) { + continue; + } + + /* + * For single-member aliases, an alias name is specified in the + * alias definition. For wildcard aliases, the alias has the same + * name as the member in the source object, i.e. *name. + */ + if (!input_present(qiv, a->alias_so, a->name ?: *name)) { + continue; + } + + /* + * A non-wildcard alias simply overrides a wildcard alias, but + * two matching non-wildcard aliases or two matching wildcard + * aliases conflict with each other. + */ + if (found_name && (!found_is_wildcard || a->name =3D=3D NULL)) { + error_setg(errp, "Value for parameter %s was already given " + "through an alias", + full_name_so(qiv, *name, false, *so)); + return false; + } else { + found_name =3D a->name ?: *name; + found_so =3D a->alias_so; + found_is_wildcard =3D !a->name; + } + } + + /* + * Chained aliases: *found_so/found_name might be the source of + * another alias. + */ + if (found_name && (found_so !=3D *so || found_name !=3D *name)) { + find_object_member(qiv, &found_so, &found_name, NULL, errp); + } + + *so =3D found_so; + *name =3D found_name; + + return found_name !=3D NULL; +} + static QObject *qobject_input_try_get_object(QObjectInputVisitor *qiv, const char *name, - bool consume) + bool consume, Error **errp) { StackObject *tos; QObject *qobj; @@ -189,10 +372,31 @@ static QObject *qobject_input_try_get_object(QObjectI= nputVisitor *qiv, assert(qobj); =20 if (qobject_type(qobj) =3D=3D QTYPE_QDICT) { - assert(name); - ret =3D qdict_get(qobject_to(QDict, qobj), name); - if (tos->h && consume && ret) { - bool removed =3D g_hash_table_remove(tos->h, name); + StackObject *so =3D tos; + const char *key =3D name; + bool is_alias_prefix; + + assert(key); + if (!find_object_member(qiv, &so, &key, &is_alias_prefix, errp)) { + if (is_alias_prefix) { + /* + * The member is not present in the input, but + * something inside of it might still be given through + * an alias. Pretend there was an empty object in the + * input. + */ + if (!qiv->empty_qdict) { + qiv->empty_qdict =3D qdict_new(); + } + return QOBJECT(qiv->empty_qdict); + } else { + return NULL; + } + } + ret =3D qdict_get(qobject_to(QDict, so->obj), key); + assert(ret !=3D NULL); + if (so->h && consume) { + bool removed =3D g_hash_table_remove(so->h, key); assert(removed); } } else { @@ -218,9 +422,10 @@ static QObject *qobject_input_get_object(QObjectInputV= isitor *qiv, const char *name, bool consume, Error **errp) { - QObject *obj =3D qobject_input_try_get_object(qiv, name, consume); + ERRP_GUARD(); + QObject *obj =3D qobject_input_try_get_object(qiv, name, consume, errp= ); =20 - if (!obj) { + if (!obj && !*errp) { error_setg(errp, QERR_MISSING_PARAMETER, full_name(qiv, name)); } return obj; @@ -803,13 +1008,16 @@ static bool qobject_input_type_size_keyval(Visitor *= v, const char *name, static void qobject_input_optional(Visitor *v, const char *name, bool *pre= sent) { QObjectInputVisitor *qiv =3D to_qiv(v); - QObject *qobj =3D qobject_input_try_get_object(qiv, name, false); + Error *local_err =3D NULL; + QObject *qobj =3D qobject_input_try_get_object(qiv, name, false, &loca= l_err); =20 - if (!qobj) { + /* If there was an error, let the caller try and run into the error */ + if (!qobj && !local_err) { *present =3D false; return; } =20 + error_free(local_err); *present =3D true; } =20 @@ -842,6 +1050,7 @@ static void qobject_input_free(Visitor *v) qobject_input_stack_object_free(tos); } =20 + qobject_unref(qiv->empty_qdict); qobject_unref(qiv->root); if (qiv->errname) { g_string_free(qiv->errname, TRUE); --=20 2.31.1