linux.git/drivers/gpu/drm/amd/amdgpu/amdgpu_reset.h, branch v7.2-rc1

drm/amdgpu: amdgpu{_reset}.h: fix all kernel-doc warnings

2026-05-05T13:56:28+00:00

Fix all kernel-doc warnings in amdgpu.h and amdgpu_reset.h:
- Use the struct keyword for kernel-doc struct comments.
- Use the correct enum names in enum amd_reset_method.

This eliminates these warnings:

Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:477 cannot understand
 function prototype: 'struct amdgpu_wb'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Enum value
 'AMD_RESET_METHOD_LEGACY' not described in enum 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Enum value
 'AMD_RESET_METHOD_MODE0' not described in enum 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Enum value
 'AMD_RESET_METHOD_MODE1' not described in enum 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Enum value
 'AMD_RESET_METHOD_MODE2' not described in enum 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Enum value
 'AMD_RESET_METHOD_LINK' not described in enum 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Enum value
 'AMD_RESET_METHOD_BACO' not described in enum 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Enum value
 'AMD_RESET_METHOD_PCI' not described in enum 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Enum value
 'AMD_RESET_METHOD_ON_INIT' not described in enum 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Excess enum value
 '@AMD_RESET_LEGACY' description in 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Excess enum value
 '@AMD_RESET_MODE0' description in 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Excess enum value
 '@AMD_RESET_MODE1' description in 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Excess enum value
 '@AMD_RESET_MODE2' description in 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Excess enum value
 '@AMD_RESET_LINK' description in 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Excess enum value
 '@AMD_RESET_BACO' description in 'amd_reset_method'
Warning: drivers/gpu/drm/amd/amdgpu/amdgpu.h:576 Excess enum value
 '@AMD_RESET_PCI' description in 'amd_reset_method'

Also move the enum to amdgpu_reset.h and eventually only forward declare
it in amdgpu.h. (Christian)

Acked-by: Christian König 
Signed-off-by: Randy Dunlap 
Signed-off-by: Alex Deucher

drm/amdgpu: add user queue reset source

2025-09-05T21:38:38+00:00

Track resets from user queues.

Reviewed-by: Christian König 
Reviewed-by: Sunil Khatri 
Signed-off-by: Alex Deucher

drm/amdgpu: Prevent hardware access in dpc state

2025-08-06T18:22:03+00:00

Don't allow hardware access while in dpc state.

Signed-off-by: Lijo Lazar 
Reviewed-by: Ce Sun 
Signed-off-by: Alex Deucher

drm/amdgpu: Add wrapper function for dpc state

2025-08-04T18:42:21+00:00

Use wrapper functions to set/indicate dpc status.

Signed-off-by: Lijo Lazar 
Reviewed-by: Ce Sun 
Signed-off-by: Alex Deucher

drm/amdgpu: Add init level for post reset reinit

2024-11-20T15:03:05+00:00

When device needs to be reset before initialization, it's not required
for all IPs to be initialized before a reset. In such cases, it needs to
identify whether the IP/feature is initialized for the first time or
whether it's reinitialized after a reset.

Add RESET_RECOVERY init level to identify post reset reinitialization
phase. This only provides a device level identification, IP/features may
choose to track their state independently also.

Signed-off-by: Lijo Lazar 
Acked-by: Tao Zhou 
Signed-off-by: Alex Deucher

drm/amdgpu: Add reset on init handler for XGMI

2024-09-26T21:06:19+00:00

In some cases, device needs to be reset before first use. Add handlers
for doing device reset during driver init sequence.

Signed-off-by: Lijo Lazar 
Reviewed-by: Feifei Xu 
Acked-by: Rajneesh Bhardwaj 
Tested-by: Rajneesh Bhardwaj 
Signed-off-by: Alex Deucher

drm/amdgpu: abort KIQ waits when there is a pending reset

2024-08-16T18:27:50+00:00

Stop waiting for the KIQ to return back when there is a reset pending.
It's quite likely that the KIQ will never response.

Signed-off-by: Koenig Christian 
Suggested-by: Lazar Lijo 
Tested-by: Victor Skvortsov 
Signed-off-by: Victor Skvortsov 
Reviewed-by: Hawking Zhang 
Signed-off-by: Alex Deucher

drm/amdgpu: add reset sources in gpu reset context

2024-06-05T15:25:13+00:00

reset source or reset cause is very useful info
for reset context, it will be used by events API.

Suggested-by: Lijo Lazar 
Signed-off-by: Eric Huang 
Reviewed-by: Lijo Lazar 
Signed-off-by: Alex Deucher

drm/amdgpu: Add reset_context flag for host FLR

2024-05-02T19:40:50+00:00

There are other reset sources that pass NULL as the job pointer, such as
amdgpu_amdkfd_reset_work. Therefore, using the job pointer to check if
the FLR comes from the host does not work.

Add a flag in reset_context to explicitly mark host triggered reset, and
set this flag when we receive host reset notification.

Signed-off-by: Yunxiang Li 
Reviewed-by: Emily Deng 
Reviewed-by: Zhigang Luo 
Signed-off-by: Alex Deucher

drm/amdgpu: Skip the coredump collection on reset during driver reload

2024-04-19T03:46:45+00:00

In passthrough environment, the driver triggers the mode-1 reset on
reload. The reset causes the core dump collection which is delayed task
and prevents driver from unloading until it is completed. Since we do
not need to collect data on "reset on reload" case, we can skip core
dump collection.

v2: Use the same flag to avoid calling amdgpu_reset_reg_dumps as well.

Signed-off-by: Ahmad Rehman 
Reviewed-by: Lijo Lazar 
Signed-off-by: Alex Deucher