Hi Alex, I had a few editing notes. On 3/3/25 6:01 PM, Alex Deucher wrote: > Describes what debugfs files are available and what > they are used for. > > Signed-off-by: Alex Deucher <alexander.deucher@xxxxxxx> > --- > Documentation/gpu/amdgpu/debugfs.rst | 201 +++++++++++++++++++++++++++ > Documentation/gpu/amdgpu/index.rst | 1 + > 2 files changed, 202 insertions(+) > create mode 100644 Documentation/gpu/amdgpu/debugfs.rst > > diff --git a/Documentation/gpu/amdgpu/debugfs.rst b/Documentation/gpu/amdgpu/debugfs.rst > new file mode 100644 > index 0000000000000..9d82c770c1e78 > --- /dev/null > +++ b/Documentation/gpu/amdgpu/debugfs.rst > @@ -0,0 +1,201 @@ > +============== > +AMDGPU DebugFS > +============== > + > +The amdgpu driver provides a number of debugfs files to aid in debugging > +issues in the driver. Suggest adding "These are found under dri/<card-id>/.", or something similar. > +amdgpu_gem_info > +--------------- > + > +Lists all of the PIDs using the GPU and the GPU buffers that are they have s/are // > +allocated. This lists the buffer size, pool (VRAM, GTT, etc.), and buffer > +attributes (CPU access required, CPU cache attributes, etc.). > + > +amdgpu_vm_info > +-------------- > + > +Lists all of the PIDs using the GPU and the GPU buffers that are they have s/are // > +allocated as well as the status of those buffers relative to that process' > +GPU virtual address space (e.g., evicted, idle, invalidated, etc.). > + > +amdgpu_sa_info > +-------------- > + > +Prints out all of the suballocations by the suballocation manager in the > +kernel driver. Prints the GPU address, size, and fence info associated > +with each suballocation. They suballocations are used internally within s/They/The/ > +the kernel driver for various things.
