From nobody Tue Feb 10 20:48:59 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass header.i=@intel.com; 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=pass(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1770706977; cv=none; d=zohomail.com; s=zohoarc; b=EpJ/ofKQtuQQZwpI+INrA/amXViWnNDLWoh7n3XB/eTXBXqeye7L8pSgn/eE4ieWbRius3Loh9aS7UNuYXWi31eoexMQcuAyfyot85js+fowC17Y7a4+oN5YWTRrYvUIqn2+WannKNl7+5rCjL6oiMrPLeTl0/4E2EOI8eyL7A0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1770706977; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=Sf79CiAG6SfHqkNGj75oFk3mJTt1TqAQVqnu+Y8ZqiE=; b=l35CkSR7xoz2NDQxSuCj9u1Wa6cvtlaVM5VDktig798NfEdyxrFVg0K2K+2LPt7te4tkJxmIM7HDF/QZ3Cg0LYObr4Y5ea9ZG287pRQgMzgE9r6azQaXl2zxCU5i9COw3zqLiYRwJlOgoyhmrUhjfD0lFdNe0II5VSCnhTlYK+g= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass header.i=@intel.com; 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=pass header.from= (p=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1770706977954327.97740069407587; Mon, 9 Feb 2026 23:02:57 -0800 (PST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1vphlT-0004zF-0W; Tue, 10 Feb 2026 02:02:27 -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 1vphlR-0004yb-On for qemu-devel@nongnu.org; Tue, 10 Feb 2026 02:02:25 -0500 Received: from mgamail.intel.com ([198.175.65.16]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1vphlP-0004p7-2x for qemu-devel@nongnu.org; Tue, 10 Feb 2026 02:02:24 -0500 Received: from orviesa006.jf.intel.com ([10.64.159.146]) by orvoesa108.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 09 Feb 2026 23:02:14 -0800 Received: from vkasired-desk2.fm.intel.com ([10.105.128.132]) by orviesa006-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 09 Feb 2026 23:02:14 -0800 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1770706943; x=1802242943; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=vLJ04mRE3eaGEiRhVGrnFwJ/UmQVbHxQHcqyM8xjArE=; b=KfteSpD8xW4YpB3Yaf1PnlYMF34fcgwTKk07abnSUMvJHoFPyMccnrf0 t2D/k3GVQLJRe4bhCzOYaF6E3JsrUum7ubR/Kup0HKYfx9ox5Luhxj37B vJ0xl4Z9XBOHM0YvWWd6AMQ1znP/tAzU/8rvrSUJsuO+dVOfOoYDf1RIz hhxGk+d9lZ2zY3e3eDvht2P1jI0PbYI9mtSKOPHrcWZXzjKPzMIivvlVp pMNhlWsDcK5K4Wtx0OKWn+SlW8iolJ862PyvXc/hLFw4iI9f1wL8iJeH6 RWQ3L7uHsa8mV+PS9ggdZyBav/FI9xmOpx11ddIFLFstqB9ryWExexJQA A==; X-CSE-ConnectionGUID: vQYmOREFRwGGluTsiiG0LQ== X-CSE-MsgGUID: XGpVyCSxR/O9COznWSa8rQ== X-IronPort-AV: E=McAfee;i="6800,10657,11696"; a="72012175" X-IronPort-AV: E=Sophos;i="6.21,283,1763452800"; d="scan'208";a="72012175" X-CSE-ConnectionGUID: 2XenC3MfQ5+bD6UCTJsb2g== X-CSE-MsgGUID: Wto7QiFkT5C26FQDMpf+FQ== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.21,283,1763452800"; d="scan'208";a="210920550" From: Vivek Kasireddy To: qemu-devel@nongnu.org Cc: Vivek Kasireddy , Alex Williamson , =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= Subject: [PATCH v6 07/11] vfio: Document vfio_device_get_region_info() Date: Mon, 9 Feb 2026 22:59:47 -0800 Message-ID: <20260210070155.1176081-8-vivek.kasireddy@intel.com> X-Mailer: git-send-email 2.50.1 In-Reply-To: <20260210070155.1176081-1-vivek.kasireddy@intel.com> References: <20260210070155.1176081-1-vivek.kasireddy@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" 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=198.175.65.16; envelope-from=vivek.kasireddy@intel.com; helo=mgamail.intel.com X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 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_MED=-2.3, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=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: qemu development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @intel.com) X-ZM-MESSAGEID: 1770706979950158500 Add documentation for vfio_device_get_region_info() and clarify the expectations around its usage. Cc: Alex Williamson Cc: C=C3=A9dric Le Goater Reviewed-by: C=C3=A9dric Le Goater Signed-off-by: Vivek Kasireddy --- include/hw/vfio/vfio-device.h | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/include/hw/vfio/vfio-device.h b/include/hw/vfio/vfio-device.h index 35a5ec6d92..828a31c006 100644 --- a/include/hw/vfio/vfio-device.h +++ b/include/hw/vfio/vfio-device.h @@ -275,6 +275,19 @@ bool vfio_device_get_host_iommu_quirk_bypass_ro(VFIODe= vice *vbasedev, int vfio_device_get_feature(VFIODevice *vbasedev, struct vfio_device_feature *feature); =20 +/** + * Return the region info for a given region index. The region info includ= es + * details such as size, offset, and capabilities. Note that the returned + * info pointer is either a cached copy or newly allocated by + * vfio_device_get_region_info(), so the caller is not expected to allocate + * or free it. + * + * @vbasedev: #VFIODevice to use + * @index: region index + * @info: pointer to store the region info + * + * Returns 0 on success or a negative value on error. + */ int vfio_device_get_region_info(VFIODevice *vbasedev, int index, struct vfio_region_info **info); int vfio_device_get_region_info_type(VFIODevice *vbasedev, uint32_t type, --=20 2.50.1