Commit 7e6487ab authored by Sunil Khatri's avatar Sunil Khatri Committed by Alex Deucher
Browse files

drm/amdgpu: change the comment from handle to ip_block 



htmldoc generation depend upon the input arguments etc
to generate the document. After update of handle to
ip_block then update needs in comments too to fix the
warnings.

Reported-by: default avatarkernel test robot <lkp@intel.com>
Closes: https://lore.kernel.org/oe-kbuild-all/202410021904.YyGjlpk9-lkp@intel.com


Signed-off-by: default avatarSunil Khatri <sunil.khatri@amd.com>
Acked-by: default avatarChristian König <christian.koenig@amd.com>
Signed-off-by: default avatarAlex Deucher <alexander.deucher@amd.com>
parent 2d5f74a8

drivers/gpu/drm/amd/amdgpu/amdgpu_acp.c

+2 −2
Original line number Diff line number Diff line
@@ -219,7 +219,7 @@ static const struct dmi_system_id acp_quirk_table[] = { 
/**

 * acp_hw_init - start and test ACP block

 *

 * @handle: handle used to pass amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 */

static int acp_hw_init(struct amdgpu_ip_block *ip_block)
@@ -497,7 +497,7 @@ static int acp_hw_init(struct amdgpu_ip_block *ip_block) 
/**

 * acp_hw_fini - stop the hardware block

 *

 * @handle: handle used to pass amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 */

static int acp_hw_fini(struct amdgpu_ip_block *ip_block)

drivers/gpu/drm/amd/amdgpu/amdgpu_isp.c

+2 −2
Original line number Diff line number Diff line
@@ -46,7 +46,7 @@ static int isp_sw_fini(struct amdgpu_ip_block *ip_block) 
/**

 * isp_hw_init - start and test isp block

 *

 * @handle: handle for amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 */

static int isp_hw_init(struct amdgpu_ip_block *ip_block)
@@ -63,7 +63,7 @@ static int isp_hw_init(struct amdgpu_ip_block *ip_block) 
/**

 * isp_hw_fini - stop the hardware block

 *

 * @handle: handle for amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 */

static int isp_hw_fini(struct amdgpu_ip_block *ip_block)

drivers/gpu/drm/amd/amdgpu/jpeg_v1_0.c

+3 −3
Original line number Diff line number Diff line
@@ -458,7 +458,7 @@ static int jpeg_v1_0_process_interrupt(struct amdgpu_device *adev, 
/**

 * jpeg_v1_0_early_init - set function pointers

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * Set ring and irq function pointers

 */
@@ -478,7 +478,7 @@ int jpeg_v1_0_early_init(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v1_0_sw_init - sw init for JPEG block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 */

int jpeg_v1_0_sw_init(struct amdgpu_ip_block *ip_block)
@@ -509,7 +509,7 @@ int jpeg_v1_0_sw_init(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v1_0_sw_fini - sw fini for JPEG block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * JPEG free up sw allocation

 */

drivers/gpu/drm/amd/amdgpu/jpeg_v2_0.c

+7 −7
Original line number Diff line number Diff line
@@ -41,7 +41,7 @@ static int jpeg_v2_0_set_powergating_state(void *handle, 
/**

 * jpeg_v2_0_early_init - set function pointers

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * Set ring and irq function pointers

 */
@@ -61,7 +61,7 @@ static int jpeg_v2_0_early_init(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v2_0_sw_init - sw init for JPEG block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * Load firmware and sw initialization

 */
@@ -104,7 +104,7 @@ static int jpeg_v2_0_sw_init(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v2_0_sw_fini - sw fini for JPEG block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * JPEG suspend and free up sw allocation

 */
@@ -125,7 +125,7 @@ static int jpeg_v2_0_sw_fini(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v2_0_hw_init - start and test JPEG block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 */

static int jpeg_v2_0_hw_init(struct amdgpu_ip_block *ip_block)
@@ -142,7 +142,7 @@ static int jpeg_v2_0_hw_init(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v2_0_hw_fini - stop the hardware block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * Stop the JPEG block, mark ring as not ready any more

 */
@@ -162,7 +162,7 @@ static int jpeg_v2_0_hw_fini(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v2_0_suspend - suspend JPEG block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * HW fini and suspend JPEG block

 */
@@ -182,7 +182,7 @@ static int jpeg_v2_0_suspend(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v2_0_resume - resume JPEG block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * Resume firmware and hw init JPEG block

 */

drivers/gpu/drm/amd/amdgpu/jpeg_v2_5.c

+7 −7
Original line number Diff line number Diff line
@@ -50,7 +50,7 @@ static int amdgpu_ih_clientid_jpeg[] = { 
/**

 * jpeg_v2_5_early_init - set function pointers

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * Set ring and irq function pointers

 */
@@ -81,7 +81,7 @@ static int jpeg_v2_5_early_init(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v2_5_sw_init - sw init for JPEG block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * Load firmware and sw initialization

 */
@@ -153,7 +153,7 @@ static int jpeg_v2_5_sw_init(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v2_5_sw_fini - sw fini for JPEG block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * JPEG suspend and free up sw allocation

 */
@@ -174,7 +174,7 @@ static int jpeg_v2_5_sw_fini(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v2_5_hw_init - start and test JPEG block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 */

static int jpeg_v2_5_hw_init(struct amdgpu_ip_block *ip_block)
@@ -202,7 +202,7 @@ static int jpeg_v2_5_hw_init(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v2_5_hw_fini - stop the hardware block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * Stop the JPEG block, mark ring as not ready any more

 */
@@ -231,7 +231,7 @@ static int jpeg_v2_5_hw_fini(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v2_5_suspend - suspend JPEG block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * HW fini and suspend JPEG block

 */
@@ -251,7 +251,7 @@ static int jpeg_v2_5_suspend(struct amdgpu_ip_block *ip_block) 
/**

 * jpeg_v2_5_resume - resume JPEG block

 *

 * @handle: amdgpu_device pointer

 * @ip_block: Pointer to the amdgpu_ip_block for this hw instance.

 *

 * Resume firmware and hw init JPEG block

 */