From nobody Sun Nov 16 14:27:01 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of _spf.google.com designates 209.85.128.65 as permitted sender) client-ip=209.85.128.65; envelope-from=philippe.mathieu.daude@gmail.com; helo=mail-wm1-f65.google.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of _spf.google.com designates 209.85.128.65 as permitted sender) smtp.mailfrom=philippe.mathieu.daude@gmail.com ARC-Seal: i=1; a=rsa-sha256; t=1600602261; cv=none; d=zohomail.com; s=zohoarc; b=C8Wx2v0G0xIm3aECYXukt/htzaizRnBiTEzlw6oVwdzWvw63zI05S/8AYLc/CwsEYlJBQLPBesfW52p12amlb3yGcsXz+BDQ1SoA6MVM/Dbr0lvfYwg6vD4EC7vyIVkOCjxSjN5/1lOT2IWjHs/P0r4fuWCUGZacTqo7lXNX/5M= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1600602261; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Sender:Subject:To; bh=vFhP//g2kZUXZ+MAEt2Ablmdm9itVCJ1RZ3mPAAaqKM=; b=RT9in20D48mJ5tpK6mxCpj7qA5mLZH9a45FgB/GfsHkRytDml2sJICdEu8wJQXv8NOsIabbwKj1tLGIXTu919JUyWZKUytnyonVApWPtSomK3FwnLPwooJ38w8B0gpUivT8rqr2fx+0m8b5sjvlHpQh/K3pvQzYEZ9UF6mXvOjs= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of _spf.google.com designates 209.85.128.65 as permitted sender) smtp.mailfrom=philippe.mathieu.daude@gmail.com Received: from mail-wm1-f65.google.com (mail-wm1-f65.google.com [209.85.128.65]) by mx.zohomail.com with SMTPS id 1600602261896407.2546195143917; Sun, 20 Sep 2020 04:44:21 -0700 (PDT) Received: by mail-wm1-f65.google.com with SMTP id a9so9807180wmm.2 for ; Sun, 20 Sep 2020 04:44:21 -0700 (PDT) Return-Path: Return-Path: Received: from localhost.localdomain (65.red-83-57-170.dynamicip.rima-tde.net. [83.57.170.65]) by smtp.gmail.com with ESMTPSA id e18sm16415708wra.36.2020.09.20.04.44.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 20 Sep 2020 04:44:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=vFhP//g2kZUXZ+MAEt2Ablmdm9itVCJ1RZ3mPAAaqKM=; b=W7bIt4F4z6IiBy9m/LcKPgpOqz7FrN9GBpJuve00BFY9kXUb/mLfbBgoPvG81e+e1I PnmN8xdfVYhfolnL/Au7or3VYohzuyU+qgU61oKMiOuiLvML1lLLR1YrG8RyVOxhKkUD At2U1VxKyw0DDkZ3K8+6cgJOlgUg4G4X4ttSbnF28kWiWKEx5DCrAF0R6pwz7R/ksdxO R49LnJb7/kTrQSjtAggbyHcuKbCIapvd4GrEf6Jg/ZC7K9SP2Q6n0s35YN62z1rYuoYc YS7B1susGSIfY5Cjvl4LUE8YHWRaLM1Az0/VQh5o+hB66bh9DtXZa5BUW2dgmMDXj/bb 3X+w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:content-transfer-encoding; bh=vFhP//g2kZUXZ+MAEt2Ablmdm9itVCJ1RZ3mPAAaqKM=; b=CyRdFrPkV2BsA148bmXDhpthPjd0a8wKqiafcCJz/7egVDTBzfstzApxsi/hDSZN0f GHfcfqDU/Sv8IUsrAz42iGMXk7KREqcfm/siuzf6lx2TytY4H70pfWSOpWdI7iwYTQbm CvGc9TVY6VhUlL06omuWM39Q60f8yq05ZtoHhd6UpZMLd9NVr2oAuw8vBBAJEX/XJoYg DUgYz594YUs1aFSWbE1gZjRBVsHFp7jdTivVfr1nU7eyj/rem05tHyMFKzKb/v3ikq4/ 7K8ibvMfLQWvzqhYMD9ac3WJ5ccQ1Y//kpod1cdgQTU6OfeC/YgvOhH48ixrGpDGSBCO EY+w== X-Gm-Message-State: AOAM531UYBoKiFbzN8spUGOekvVmqjLS6S0rUtAHzOtxLeLdUO+DXb/j qFtJkn3h7Z3udmYHF7aWjUo= X-Google-Smtp-Source: ABdhPJyz0j5G6/Jn6raiSm4b4XBR2XD5rdMCO5YiUU0gweX8qLMIBsSFUJ0cLbs1Gh97QejA8lUIOw== X-Received: by 2002:a1c:9c4b:: with SMTP id f72mr24727724wme.188.1600602260050; Sun, 20 Sep 2020 04:44:20 -0700 (PDT) Sender: =?UTF-8?Q?Philippe_Mathieu=2DDaud=C3=A9?= From: =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= To: Markus Armbruster , qemu-devel@nongnu.org Cc: Laurent Vivier , Paolo Bonzini , Anthony Perard , Stefano Stabellini , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Eduardo Habkost , Paul Durrant , Marcel Apfelbaum , "Michael S. Tsirkin" , xen-devel@lists.xenproject.org, =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Subject: [PATCH 1/2] qdev: Document qbus_realize() and qbus_unrealize() Date: Sun, 20 Sep 2020 13:44:15 +0200 Message-Id: <20200920114416.353277-2-f4bug@amsat.org> X-Mailer: git-send-email 2.26.2 In-Reply-To: <20200920114416.353277-1-f4bug@amsat.org> References: <20200920114416.353277-1-f4bug@amsat.org> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @gmail.com) Add some documentation for the qbus_realize() and qbus_unrealize() functions introduced in commit 9940b2cfbc0. Signed-off-by: Philippe Mathieu-Daud=C3=A9 --- include/hw/qdev-core.h | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/include/hw/qdev-core.h b/include/hw/qdev-core.h index e025ba9653f..02ac1c50b7f 100644 --- a/include/hw/qdev-core.h +++ b/include/hw/qdev-core.h @@ -675,7 +675,19 @@ typedef int (qdev_walkerfn)(DeviceState *dev, void *op= aque); void qbus_create_inplace(void *bus, size_t size, const char *typename, DeviceState *parent, const char *name); BusState *qbus_create(const char *typename, DeviceState *parent, const cha= r *name); +/** + * qbus_realize: Realize a bus + * @bus: bus to realize + * @errp: pointer to error object + * + * On success, return true. + * On failure, store an error through @errp and return false. + */ bool qbus_realize(BusState *bus, Error **errp); +/** + * qbus_realize: Unrealize a bus + * @bus: bus to unrealize + */ void qbus_unrealize(BusState *bus); =20 /* Returns > 0 if either devfn or busfn skip walk somewhere in cursion, --=20 2.26.2