<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<style type="text/css" style="display:none;"> P {margin-top:0;margin-bottom:0;} </style>
</head>
<body dir="ltr">
<p style="font-family:Arial;font-size:10pt;color:#008000;margin:15pt;font-style:normal;font-weight:normal;text-decoration:none;" align="Left">
[Public]<br>
</p>
<br>
<div>
<div style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
Reviewed-by: Alex Deucher <alexander.deucher@amd.com><br>
</div>
<div id="appendonsend"></div>
<hr style="display:inline-block;width:98%" tabindex="-1">
<div id="divRplyFwdMsg" dir="ltr"><font face="Calibri, sans-serif" style="font-size:11pt" color="#000000"><b>From:</b> amd-gfx <amd-gfx-bounces@lists.freedesktop.org> on behalf of Mario Limonciello <mario.limonciello@amd.com><br>
<b>Sent:</b> Tuesday, October 17, 2023 3:37 PM<br>
<b>To:</b> amd-gfx@lists.freedesktop.org <amd-gfx@lists.freedesktop.org><br>
<b>Cc:</b> Stephen Rothwell <sfr@canb.auug.org.au>; Limonciello, Mario <Mario.Limonciello@amd.com><br>
<b>Subject:</b> [PATCH] drm/amd: Add missing kernel doc for prepare_suspend()</font>
<div> </div>
</div>
<div class="BodyFragment"><font size="2"><span style="font-size:11pt;">
<div class="PlainText">prepare_suspend() is intended to be used for any IP blocks<br>
that must allocate memory during the suspend sequence.<br>
<br>
Reported-by: Stephen Rothwell <sfr@canb.auug.org.au><br>
Closes: <a href="https://lore.kernel.org/all/20231017143555.6a6450fc@canb.auug.org.au/">
https://lore.kernel.org/all/20231017143555.6a6450fc@canb.auug.org.au/</a><br>
Fixes: cb11ca3233aa ("drm/amd: Add concept of running prepare_suspend() sequence for IP blocks")<br>
Signed-off-by: Mario Limonciello <mario.limonciello@amd.com><br>
---<br>
drivers/gpu/drm/amd/include/amd_shared.h | 2 ++<br>
1 file changed, 2 insertions(+)<br>
<br>
diff --git a/drivers/gpu/drm/amd/include/amd_shared.h b/drivers/gpu/drm/amd/include/amd_shared.h<br>
index 98e60bc868dd..579977f6ad52 100644<br>
--- a/drivers/gpu/drm/amd/include/amd_shared.h<br>
+++ b/drivers/gpu/drm/amd/include/amd_shared.h<br>
@@ -271,6 +271,8 @@ enum amd_dpm_forced_level;<br>
* @hw_init: sets up the hw state<br>
* @hw_fini: tears down the hw state<br>
* @late_fini: final cleanup<br>
+ * @prepare_suspend: handle IP specific changes to prepare for suspend<br>
+ * (such as allocating any required memory)<br>
* @suspend: handles IP specific hw/sw changes for suspend<br>
* @resume: handles IP specific hw/sw changes for resume<br>
* @is_idle: returns current IP block idle status<br>
-- <br>
2.34.1<br>
<br>
</div>
</span></font></div>
</div>
</body>
</html>