Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:8 as permitted sender) client-ip=2620:137:e000::3:8;
From:   Donald Robson <donald.robson@imgtec.com>
To:     <dri-devel@lists.freedesktop.org>
CC:     <frank.binns@imgtec.com>, <matt.coster@imgtec.com>,
        <boris.brezillon@collabora.com>, <faith.ekstrand@collabora.com>,
        <airlied@gmail.com>, <daniel@ffwll.ch>,
        <maarten.lankhorst@linux.intel.com>, <mripard@kernel.org>,
        <tzimmermann@suse.de>, <afd@ti.com>, <hns@goldelico.com>,
        <matthew.brost@intel.com>, <christian.koenig@amd.com>,
        <luben.tuikov@amd.com>, <dakr@redhat.com>,
        <linux-kernel@vger.kernel.org>, <robh+dt@kernel.org>,
        <krzysztof.kozlowski+dt@linaro.org>, <conor+dt@kernel.org>,
        <devicetree@vger.kernel.org>, <corbet@lwn.net>,
        <linux-doc@vger.kernel.org>, Sarah Walker <sarah.walker@imgtec.com>
Subject: [PATCH v9 02/20] drm/gpuvm: Helper to get range of unmap from a remap op.
Date:   Wed, 22 Nov 2023 16:34:23 +0000
Message-Id: <8a0a5b5eeec459d3c60fcdaa5a638ad14a18a59e.1700668843.git.donald.robson@imgtec.com>
In-Reply-To: <cover.1700668843.git.donald.robson@imgtec.com>
References: <cover.1700668843.git.donald.robson@imgtec.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?e5V8uyeOZiwFb0qbBbP1aDic4sMwUorM+ODxj9HsBBtArxxFbznBFd7eiLAE?=
 =?us-ascii?Q?8m+ktdhK3GK1J4nP611OuHd9TClAxyuBTHgCzTOQW6nPjL6KfgTaFtMEkg3Z?=
 =?us-ascii?Q?BYbDag7/sUk9Y6t9oHxQHF3tllH34xNFMUbch15HqtNVbwYgVbNdrQTmrGoy?=
 =?us-ascii?Q?UHhjKDN9X+1y/k4Q0Krne8EcDKdu9/uzFfRJ8x6p8n+Ip4nHfrQxC+MZkMoW?=
 =?us-ascii?Q?DhtGUVhTcww+Xhy3XvVKcfvhMUFgtrNjD6xCSIgoyF/0iGoNDO3nYmRdpXy/?=
 =?us-ascii?Q?1Fb2uIKi5EFzGqeLHQrXlCCMJqhvbYjLAKAuJinTLd2Mbb9odz1wfjN7Rwyy?=
 =?us-ascii?Q?JP5Nul5pXQc2A7jOkZzBSg+SH1upq8Xf510it2TfDG5/69tnC742+RnKy/Mr?=
 =?us-ascii?Q?I5NB6Chvq6MT587eaRL497IfE33G3a7gzKUtCuEuk+rLVjodfeQcPjb9wrwZ?=
 =?us-ascii?Q?6zgIpOo28hk9l1b9yzoSl5F0WGNDVnFS1StmGVVsEnzp8WwDflhBzC8qcieX?=
 =?us-ascii?Q?bWO1XA/sXkCwOnmpdUYjNDG6qdzRZ5hawxMP3IWLm97XZq6uTHQV/qTSDGDu?=
 =?us-ascii?Q?dRGENwC9pdE3cDHcgQT/JDhA/ucsJqoUt8UEOctBv/lvqze/pAKMS8k3/3x3?=
 =?us-ascii?Q?T7IguqFbJL2EywWGq0af0xcnhEzF2vaUGRSf+eOTmJr8IuxhYlV2OivVQeIw?=
 =?us-ascii?Q?sTbXFOLz89NDoX8TuwMgN9r27SyvsCieX8SjUmICCSa6Ud1GWJD4BBByIA4q?=
 =?us-ascii?Q?MZ5bZ/V7PNuJcXmAtTizREtYtOAjy9b5ozMHay5KqjIGa0tPLAWf6H6KGjYE?=
 =?us-ascii?Q?CzEjAWNB88Z6D2agdBt0bUkl6ZBt+FO5iF3Y8kP2Hphz7c3MnmC5CYRTZErl?=
 =?us-ascii?Q?m9gkB9IO0TfqjRumf7z/pevyB0o72Db3jyYil6EsOJvpfxcBmkBzu7I0OkSi?=
 =?us-ascii?Q?IA2XVvOdgWYQohBIY/4aECraEQZwWssmZm+J2MMh23KnJzaRAjhzBEJ2DnXe?=
 =?us-ascii?Q?s3x7aM32T83n+FB+n5FaYf4mYy866FhsSsgqzr36S32t3yQupDF935BhmpLg?=
 =?us-ascii?Q?hJ16bVHL3eLz6DiEPFYDEAcmLe5QFy/doT33aALJ0KarsFXhxxrA4QdBzD2d?=
 =?us-ascii?Q?C9MP8CXvJQXsFAsBCEOqErB1xsKJQlvzoG0l1zN0g1K7hijv2diUhFV+667I?=
 =?us-ascii?Q?fygvgtVTadxhTi7kbgdfLTidp1GtqNn4lOneq0CewK7ADS07RoNDQfKmZc4y?=
 =?us-ascii?Q?36fyFacM+Khowe0AksmDuqGtON1PQaPPFaR1KpI1v5GEMYNnnIn6TGN6MNjC?=
 =?us-ascii?Q?U7+aeUAclv+nn0zM39LdLTpmnfatwgTCyCACLH44JFRnWCLTP7LJKm+07gOm?=
 =?us-ascii?Q?xwbkdoByrWdE6HpMAJB/CXXsHQ1RhJpMuggyuLCbhVuoqX6kcGAQ7M0cA4jK?=
 =?us-ascii?Q?Wd3ZeT5+iUPFLPD6gmal+DakscsZyI4R6Wf2F/VK1oWLqvBgxhF5E76xnMMu?=
 =?us-ascii?Q?AY9o7mgYkvJ7Oq39vmjiYWql30TvU/ZTN8nLpbkRBogfM9SS1XktdB62dMCb?=
 =?us-ascii?Q?Uuhnr5u3ZuYUEKkJXoCEU/uweSUzbEPDZlt3xD6ge0qmh04WJD1w5QdE/iej?=
 =?us-ascii?Q?7g=3D=3D?=
X-MS-Exchange-CrossTenant-Network-Message-Id: e053100b-cd6d-4112-9ab9-08dbeb78fb56
X-MS-Exchange-CrossTenant-AuthSource: CWLP265MB5770.GBRP265.PROD.OUTLOOK.COM
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Nov 2023 16:35:04.9473
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 0d5fd8bb-e8c2-4e0a-8dd5-2c264f7140fe
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: +biMBSpXDl5tndv2ajJdcAR2serR5d8GDK3PUhcEKXUD2em5+ldpdL6C5AE2rZvu0ooHhJmYrYwts6rV41Uok4cMbceB0AGPc5g6Xf5Jflc=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CWLP265MB5329
X-OriginatorOrg: imgtec.com
X-EXCLAIMER-MD-CONFIG: 15a78312-3e47-46eb-9010-2e54d84a9631
X-Proofpoint-ORIG-GUID: q4jC9LirBfnW3Erusc8LNU0SlP46kHm2
X-Proofpoint-GUID: q4jC9LirBfnW3Erusc8LNU0SlP46kHm2
X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIM_SIGNED,DKIM_VALID,
	DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,
	SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=unavailable
	autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on fry.vger.email
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org
X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (fry.vger.email [0.0.0.0]); Wed, 22 Nov 2023 08:36:04 -0800 (PST)

Determining the start and range of the unmap stage of a remap op is a
common piece of code currently implemented by multiple drivers. Add a
helper for this.

Changes since v7:
- Renamed helper to drm_gpuva_op_remap_to_unmap_range()
- Improved documentation

Changes since v6:
- Remove use of __always_inline

Signed-off-by: Donald Robson <donald.robson@imgtec.com>
Signed-off-by: Sarah Walker <sarah.walker@imgtec.com>
Reviewed-by: Danilo Krummrich <dakr@redhat.com>
---
 include/drm/drm_gpuvm.h | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/include/drm/drm_gpuvm.h b/include/drm/drm_gpuvm.h
index 8ca10461d8ac..f94fec9a8517 100644
--- a/include/drm/drm_gpuvm.h
+++ b/include/drm/drm_gpuvm.h
@@ -1213,4 +1213,32 @@ void drm_gpuva_remap(struct drm_gpuva *prev,
 
 void drm_gpuva_unmap(struct drm_gpuva_op_unmap *op);
 
+/**
+ * drm_gpuva_op_remap_to_unmap_range() - Helper to get the start and range of
+ * the unmap stage of a remap op.
+ * @op: Remap op.
+ * @start_addr: Output pointer for the start of the required unmap.
+ * @range: Output pointer for the length of the required unmap.
+ *
+ * The given start address and range will be set such that they represent the
+ * range of the address space that was previously covered by the mapping being
+ * re-mapped, but is now empty.
+ */
+static inline void
+drm_gpuva_op_remap_to_unmap_range(const struct drm_gpuva_op_remap *op,
+				  u64 *start_addr, u64 *range)
+{
+	const u64 va_start = op->prev ?
+			     op->prev->va.addr + op->prev->va.range :
+			     op->unmap->va->va.addr;
+	const u64 va_end = op->next ?
+			   op->next->va.addr :
+			   op->unmap->va->va.addr + op->unmap->va->va.range;
+
+	if (start_addr)
+		*start_addr = va_start;
+	if (range)
+		*range = va_end - va_start;
+}
+
 #endif /* __DRM_GPUVM_H__ */
-- 
2.25.1