From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 44787C61DA4 for ; Tue, 14 Feb 2023 12:17:48 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pRuFH-0004FO-Gs; Tue, 14 Feb 2023 07:17:15 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pRuFE-0004CK-BF for qemu-devel@nongnu.org; Tue, 14 Feb 2023 07:17:12 -0500 Received: from us-smtp-delivery-124.mimecast.com ([170.10.129.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pRuFB-0001Qc-DY for qemu-devel@nongnu.org; Tue, 14 Feb 2023 07:17:11 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1676377028; 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=BAXhBlOuZl/A0DyOvAqMgGtPdC5KBfU6GLnrH8qPmWE=; b=ble5HUU05t8PXOJGWLB1fr8ZZSgo/zQ/BbIrhDmeYNGWb3t4CAeAEwlM+Ma3OzLtaFmo/N cISgqF1y60WIHBXnftd1NAuGUZwQ9F3mi3aXqeo7bnbth6eD/RZh+In7zAwPKXh/amKzF8 DHGwel+3pxgD+yIrU5FHXLdaZduaE4o= Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-563-ezaOxhqjPJGNHG46afIEmQ-1; Tue, 14 Feb 2023 07:17:07 -0500 X-MC-Unique: ezaOxhqjPJGNHG46afIEmQ-1 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 68633101A55E; Tue, 14 Feb 2023 12:17:06 +0000 (UTC) Received: from blackfin.pond.sub.org (unknown [10.39.192.13]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 195244010E84; Tue, 14 Feb 2023 12:17:06 +0000 (UTC) Received: by blackfin.pond.sub.org (Postfix, from userid 1000) id 045E321E6A1F; Tue, 14 Feb 2023 13:17:05 +0100 (CET) From: Markus Armbruster To: Philippe =?utf-8?Q?Mathieu-Daud=C3=A9?= Cc: Daniel P. =?utf-8?Q?Berrang=C3=A9?= , Peter Krempa , eduardo@habkost.net, antonkuchin@yandex-team.ru, mst@redhat.com, "reviewer:Incompatible changes" , qemu-devel@nongnu.org, Vladimir Sementsov-Ogievskiy , den-plotnikov@yandex-team.ru, marcel.apfelbaum@gmail.com, pbonzini@redhat.com, eblake@redhat.com Subject: Re: [PATCH v4 14/16] qapi: deprecate "device" field of DEVICE_* events References: <20230213140103.1518173-1-vsementsov@yandex-team.ru> <20230213140103.1518173-15-vsementsov@yandex-team.ru> <87bklwoce9.fsf@pond.sub.org> <87ttzojwl7.fsf@pond.sub.org> <73444fb8-49a7-fc2f-091e-6f65e916fa58@linaro.org> Date: Tue, 14 Feb 2023 13:17:04 +0100 In-Reply-To: <73444fb8-49a7-fc2f-091e-6f65e916fa58@linaro.org> ("Philippe =?utf-8?Q?Mathieu-Daud=C3=A9=22's?= message of "Tue, 14 Feb 2023 12:53:01 +0100") Message-ID: <87o7pwigqn.fsf@pond.sub.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.1 on 10.11.54.1 Received-SPF: pass client-ip=170.10.129.124; envelope-from=armbru@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, 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.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Sender: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Philippe Mathieu-Daud=C3=A9 writes: > On 14/2/23 12:49, Markus Armbruster wrote: >> Daniel P. Berrang=C3=A9 writes: [...] >>> What's the documented way to construct a QOM path, given only an ID as >>> input ? >>=20 >> QOM paths a gap in our documentation, even though the composition tree >> structure has been stable since day one, and is de facto ABI. >>=20 >> Short answer: "/machine/peripheral/ID". >>=20 >> Long answer follows. >>=20 >> We have three "containers" under /machine that serve as parents for >> devices: >>=20 >> * /machine/peripheral/ >>=20 >> Parent of user-created devices with ID. Children are named "ID". >>=20 >> Put there by qdev_set_id(), called from qdev_device_add_from_qdict(). >>=20 >> On "user-created": Nothing stops board code to abuse qdev_set_id() for >> onboard devices, directly or indirectly, but it really, really >> shouldn't. >>=20 >> * /machine/peripheral-anon/ >>=20 >> Parent of user-created devices without ID. Children are named >> "device[N]", where N counts up from zero. >>=20 >> Put there by qdev_set_id(), called from qdev_device_add_from_qdict(). >>=20 >> Again, abuse by board code is possible, but would be wrong. >>=20 >> Beware: a particular device's N changes when the set of devices >> created before it grows or shrinks. Messing with the machine type can >> change it (different onboard devices). >>=20 >> * /machine/unattached/ >>=20 >> Surrogate parent of onboard devices created without a parent. >>=20 >> Put there by device_set_realized() (general case), >> qdev_connect_gpio_out_named() (input pins) , memory_region_do_init() >> (memory regions), qemu_create_machine() (the main sysbus). >>=20 >> I believe this container was created as a convenience, so we don't >> have to retrofit parents to existing code. Probably abused ever >> since. > > Are you suggesting this is a stable interface and we can not move > devices (like from /machine/unattached/ to /machine/peripheral/) > without going thru the deprecation process? Difficult question! The point of not changing interfaces incompatibly without a grace period / deprecation process is not breaking users of the interface. When an interface has always worked a certain way, its users may well depend on it, whether it's documented or not. The question to ask is always "will this break users?" For documented aspects, we generally assume it will. Doesn't mean we can simply assume "won't" for undocumented aspects. Does this make sense?