linux.git/include/uapi/linux/kfd_ioctl.h, branch v7.2-rc1

drm/amdkfd: bump KFD ioctl minor version to 1.23

2026-05-11T19:55:57+00:00

Bump `KFD_IOCTL_MINOR_VERSION` from 22 to 23 and document version 1.23
in `kfd_ioctl.h` so userspace can detect profiler ioctl support.

Signed-off-by: Perry Yuan 
Suggested-by: Alex Deucher 
Reviewed-by: Alex Deucher 
Signed-off-by: Alex Deucher

drm/amdkfd: Add PTL control IOCTL Option and unify refcount logic

2026-05-11T19:55:56+00:00

Introduce a new IOCTL option to allow userspace explicit control over
the Peak Tops Limiter (PTL) state for profiling

Link: https://github.com/ROCm/rocm-systems/tree/develop/projects/rocprofiler-sdk
Signed-off-by: Perry Yuan 
Reviewed-by: Yifan Zhang 
Acked-by: Alex Deucher 
Signed-off-by: Alex Deucher

amd/amdkfd: Add kfd_ioctl_profiler to contain profiler kernel driver changes

2026-05-11T19:55:55+00:00

kfd_ioctl_profiler takes a similar approach to that of
kfd_ioctl_dbg_trap (which contains debugger related IOCTL
services) where kfd_ioctl_profiler will contain all profiler
related IOCTL services. The IOCTL is designed to be expanded
as needed to support additional profiler functionality.

The current functionality of the IOCTL is to allow for profilers
which need PMC counters from GPU devices to both signal to other
profilers that may be on the system that the device has active PMC
profiling taking place on it (multiple PMC profilers on the same
device can result in corrupted counter data) and to setup the device
to allow for the collection of SQ PMC data on all queues on the device.

For PMC data for the SQ block (such as SQ_WAVES) to be available
to a profiler, mmPERFCOUNT_ENABLE must be set on the queues. When
profiling a single process, the profiler can inject PM4 packets into
each queue to turn on PERFCOUNT_ENABLE. When profiling system wide,
the profiler does not have this option and must have a way to turn
on profiling for queues in which it cannot inject packets into directly.

Accomplishing this requires a few steps:

1. Checking if the user has the necessary permissions to profile system
   wide on the device. This check uses the same check that linux perf
   uses to determine if a user has the necessary permissions to profile
   at this scope (primarily if the process has CAP_SYS_PERFMON or is root).

2. Locking the device for profiling. This is done by setting a lock bit
   on the device struct and storing the process that locked the device.

3. Iterating all queues on the device and issuing an MQD Update to enable
   perfcounting on the queues.

4. Actions to cleanup if the process exits or releases the lock.

The IOCTL also contains a link to the existing PC Sampling IOCTL as well.
This is per a suggestion that we should potentially remove the PC Sampling
IOCTL to have it be a part of the profiler IOCTL. This is a future change.
In addition, we do expect to expand the profiler IOCTL to include
additional profiler functionality in the future (which necessitates the
use of a version number).

v2: sqaush in proper IOCTL number

Proposed userpace support:
https://github.com/ROCm/rocm-systems/commit/40abc95a6463a61bb318a67efd6d9cc3e5ee8839

Signed-off-by: Benjamin Welton 
Signed-off-by: Perry Yuan 
Acked-by: Kent Russell 
Reviewed-by: Yifan Zhang 
Acked-by: Alex Deucher 
Signed-off-by: Alex Deucher

drm/amdkfd: add extended capabilities to device snapshot

2026-01-27T23:13:28+00:00

Add additional capabilities reporting.

Signed-off-by: Jonathan Kim 
Reviewed-by: James Zhu 
Signed-off-by: Alex Deucher

drm/amdkfd: Add metadata ring buffer for compute

2026-01-05T21:59:56+00:00

Add support for separate ring-buffer for metadata packets when using
compute queues. Userspace application allocate the metadata ring-buffer
and the queue ring-buffer with a single allocation. The metadata
ring-buffer starts after the queue ring-buffer.

Signed-off-by: David Yat Sin 
Reviewed-by: Philip Yang 
Signed-off-by: Alex Deucher

drm/amdkfd: allow debug subscription to lds violations on gfx 1250

2025-12-16T18:23:17+00:00

GFX 1250 allows the debugger to subcribe to LDS out-of-range read/write
memory violations.
Bump IOCTL minor version and flag KFD capabilities for enablement
hint.

Signed-off-by: Jonathan Kim 
Reviewed-by: Felix Kuehling 
Signed-off-by: Alex Deucher

amdkfd: Bump ABI to indicate presence of Trap handler support for expert scheduling

2025-12-08T19:23:21+00:00

commit 0f0c8a6983db ("drm/amdkfd: Trap handler support for expert
scheduling mode") introduced support for a trap handler when expert
scheduling mode. However userspace needs to know whether or not a trap
handler support is present.

Bump the KFD IOCTL API so that userspace can key off this to decide.

Suggested-by: Stella Laurenzo 
Fixes: 423888879412 ("drm/amdkfd: Trap handler support for expert scheduling mode")
Reviewed-by: Kent Russell 
Signed-off-by: Mario Limonciello 
Signed-off-by: Alex Deucher

amdkfd: introduce new ioctl AMDKFD_IOC_CREATE_PROCESS

2025-12-08T19:19:34+00:00

This commit implemetns a new ioctl AMDKFD_IOC_CREATE_PROCESS
that creates a new secondary kfd_progress on the FD.

To keep backward compatibility, userspace programs need to invoke
this ioctl explicitly on a FD to create a secondary
kfd_process which replacing its primary kfd_process.

This commit bumps ioctl minor version.

Signed-off-by: Zhu Lingshan 
Reviewed-by: Felix Kuehling 
Signed-off-by: Alex Deucher

drm/amdkfd: Fix two comments in kfd_ioctl.h

2025-10-07T18:09:19+00:00

Queue read and write pointers are "to KFD", not "from KFD".

Suggested-by: Robert Liu 
Signed-off-by: Felix Kuehling 
Reviewed-by: Alex Deucher 
Reviewed-by: Robert Liu 
Signed-off-by: Alex Deucher

drm/amdkfd: add smi events for process start and end

2025-04-11T21:01:25+00:00

rocm-smi will be able to show the events for KFD process
start/end, it is the implementation of this feature.

Signed-off-by: Eric Huang 
Reviewed-by: Kent Russell 
Signed-off-by: Alex Deucher