From nobody Thu Nov 6 12:14:40 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) client-ip=208.118.235.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Authentication-Results: mx.zohomail.com; spf=pass (zoho.com: domain of gnu.org designates 208.118.235.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 [208.118.235.17]) by mx.zohomail.com with SMTPS id 1541500900165104.61801526609099; Tue, 6 Nov 2018 02:41:40 -0800 (PST) Received: from localhost ([::1]:40139 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gJynj-00020l-2D for importer@patchew.org; Tue, 06 Nov 2018 05:41:39 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:39266) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gJykL-0005Vt-PW for qemu-devel@nongnu.org; Tue, 06 Nov 2018 05:38:11 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gJyWO-0005Dw-C5 for qemu-devel@nongnu.org; Tue, 06 Nov 2018 05:23:48 -0500 Received: from mx1.redhat.com ([209.132.183.28]:33248) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gJyWO-000526-2c; Tue, 06 Nov 2018 05:23:44 -0500 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.23]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id C4CDB85A04; Tue, 6 Nov 2018 10:23:37 +0000 (UTC) Received: from sirius.home.kraxel.org (ovpn-116-158.ams2.redhat.com [10.36.116.158]) by smtp.corp.redhat.com (Postfix) with ESMTP id C809E19751; Tue, 6 Nov 2018 10:23:36 +0000 (UTC) Received: by sirius.home.kraxel.org (Postfix, from userid 1000) id AD5828FAC; Tue, 6 Nov 2018 11:23:35 +0100 (CET) From: Gerd Hoffmann To: qemu-devel@nongnu.org Date: Tue, 6 Nov 2018 11:23:31 +0100 Message-Id: <20181106102335.20027-3-kraxel@redhat.com> In-Reply-To: <20181106102335.20027-1-kraxel@redhat.com> References: <20181106102335.20027-1-kraxel@redhat.com> X-Scanned-By: MIMEDefang 2.84 on 10.5.11.23 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.26]); Tue, 06 Nov 2018 10:23:37 +0000 (UTC) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.132.183.28 Subject: [Qemu-devel] [PATCH v2 2/6] add QemuSupportState X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Eduardo Habkost , "Michael S. Tsirkin" , Alexander Graf , Markus Armbruster , =?UTF-8?q?Herv=C3=A9=20Poussineau?= , qemu-ppc@nongnu.org, Gerd Hoffmann , Paolo Bonzini , Richard Henderson , =?UTF-8?q?Andreas=20F=C3=A4rber?= , David Gibson Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Indicates support state for something (device, backend, subsystem, ...) in qemu. Add QemuSupportState field to ObjectClass. Add some support code. TODO: wire up to qom-list-types Signed-off-by: Gerd Hoffmann --- include/qemu/support-state.h | 17 +++++++++++++++++ include/qom/object.h | 3 +++ util/support-state.c | 26 ++++++++++++++++++++++++++ qapi/common.json | 32 ++++++++++++++++++++++++++++++++ util/Makefile.objs | 1 + 5 files changed, 79 insertions(+) create mode 100644 include/qemu/support-state.h create mode 100644 util/support-state.c diff --git a/include/qemu/support-state.h b/include/qemu/support-state.h new file mode 100644 index 0000000000..6567d8702b --- /dev/null +++ b/include/qemu/support-state.h @@ -0,0 +1,17 @@ +#ifndef QEMU_SUPPORT_STATE_H +#define QEMU_SUPPORT_STATE_H + +#include "qapi/qapi-types-common.h" + +typedef struct QemuSupportState { + SupportState state; + const char *help; +} QemuSupportState; + +void qemu_warn_support_state(const char *type, const char *name, + ObjectClass *oc); + +bool qemu_is_deprecated(ObjectClass *oc); +bool qemu_is_obsolete(ObjectClass *oc); + +#endif /* QEMU_SUPPORT_STATE_H */ diff --git a/include/qom/object.h b/include/qom/object.h index 499e1fd8b7..2b5f27bf85 100644 --- a/include/qom/object.h +++ b/include/qom/object.h @@ -15,6 +15,7 @@ #define QEMU_OBJECT_H =20 #include "qapi/qapi-builtin-types.h" +#include "qemu/support-state.h" #include "qemu/queue.h" =20 struct TypeImpl; @@ -399,6 +400,8 @@ struct ObjectClass ObjectUnparent *unparent; =20 GHashTable *properties; + + QemuSupportState supported; }; =20 /** diff --git a/util/support-state.c b/util/support-state.c new file mode 100644 index 0000000000..3170dbd15d --- /dev/null +++ b/util/support-state.c @@ -0,0 +1,26 @@ +#include "qemu/osdep.h" +#include "qemu/error-report.h" +#include "qemu/support-state.h" +#include "qom/object.h" + +void qemu_warn_support_state(const char *type, const char *name, + ObjectClass *oc) +{ + const char *help =3D oc->supported.help; + + warn_report("%s %s is %s%s%s%s", type, name, + SupportState_str(oc->supported.state), + help ? " (" : "", + help ? help : "", + help ? ")" : ""); +} + +bool qemu_is_deprecated(ObjectClass *oc) +{ + return oc->supported.state =3D=3D SUPPORT_STATE_DEPRECATED; +} + +bool qemu_is_obsolete(ObjectClass *oc) +{ + return oc->supported.state =3D=3D SUPPORT_STATE_OBSOLETE; +} diff --git a/qapi/common.json b/qapi/common.json index 021174f04e..00374127b8 100644 --- a/qapi/common.json +++ b/qapi/common.json @@ -151,3 +151,35 @@ 'ppc64', 'riscv32', 'riscv64', 's390x', 'sh4', 'sh4eb', 'sparc', 'sparc64', 'tricore', 'unicore32', 'x86_64', 'xtensa', 'xtensaeb' ] } + +## +# @SupportState: +# +# Indicate Support level of qemu devices, backends, subsystems, ... +# +# @unspecified: not specified (zero-initialized). +# +# @experimental: in development, can be unstable or incomplete. +# +# @supported: works stable and is fully supported. +# (supported + maintained in MAINTAINERS). +# +# @unsupported: should work, support is weak or not present. +# (odd-fixes + orphan in MAINTAINERS). +# +# @obsolete: is obsolete, still present for compatibility reasons, +# will likely be removed at some point in the future. +# Not deprecated (yet). +# (obsolete in MAINTAINERS). +# +# @deprecated: is deprecated, according to qemu deprecation policy. +# +# Since: 3.2 +## +{ 'enum': 'SupportState', + 'data': [ 'unspecified', + 'experimental', + 'supported', + 'unsupported', + 'obsolete', + 'deprecated' ] } diff --git a/util/Makefile.objs b/util/Makefile.objs index 0820923c18..6e5f8faf82 100644 --- a/util/Makefile.objs +++ b/util/Makefile.objs @@ -50,5 +50,6 @@ util-obj-y +=3D range.o util-obj-y +=3D stats64.o util-obj-y +=3D systemd.o util-obj-y +=3D iova-tree.o +util-obj-y +=3D support-state.o util-obj-$(CONFIG_LINUX) +=3D vfio-helpers.o util-obj-$(CONFIG_OPENGL) +=3D drm.o --=20 2.9.3