On 11/19/25 01:45, Rodrigo Siqueira wrote: > Expand the kernel-doc about amdgpu_ring and add some tiny improvements. > > Cc: Alex Deucher <[email protected]> > Cc: Christian König <[email protected]> > Cc: Timur Kristóf <[email protected]> > Signed-off-by: Rodrigo Siqueira <[email protected]> > Reviewed-by: Alex Deucher <[email protected]>
Reviewed-by: Christian König <[email protected]> > --- > drivers/gpu/drm/amd/amdgpu/amdgpu_ring.c | 11 ++++++++--- > drivers/gpu/drm/amd/amdgpu/amdgpu_ring.h | 2 ++ > 2 files changed, 10 insertions(+), 3 deletions(-) > > diff --git a/drivers/gpu/drm/amd/amdgpu/amdgpu_ring.c > b/drivers/gpu/drm/amd/amdgpu/amdgpu_ring.c > index cd8873c6931a..4336862c9d71 100644 > --- a/drivers/gpu/drm/amd/amdgpu/amdgpu_ring.c > +++ b/drivers/gpu/drm/amd/amdgpu/amdgpu_ring.c > @@ -76,8 +76,12 @@ unsigned int amdgpu_ring_max_ibs(enum amdgpu_ring_type > type) > * @ring: amdgpu_ring structure holding ring information > * @ndw: number of dwords to allocate in the ring buffer > * > - * Allocate @ndw dwords in the ring buffer (all asics). > - * Returns 0 on success, error on failure. > + * Allocate @ndw dwords in the ring buffer. The number of dwords should be > the > + * sum of all commands written to the ring. > + * > + * Returns: > + * 0 on success, otherwise -ENOMEM if it tries to allocate more than the > + * maximum dword allowed for one submission. > */ > int amdgpu_ring_alloc(struct amdgpu_ring *ring, unsigned int ndw) > { > @@ -123,7 +127,8 @@ static void amdgpu_ring_alloc_reemit(struct amdgpu_ring > *ring, unsigned int ndw) > ring->funcs->begin_use(ring); > } > > -/** amdgpu_ring_insert_nop - insert NOP packets > +/** > + * amdgpu_ring_insert_nop - insert NOP packets > * > * @ring: amdgpu_ring structure holding ring information > * @count: the number of NOP packets to insert > diff --git a/drivers/gpu/drm/amd/amdgpu/amdgpu_ring.h > b/drivers/gpu/drm/amd/amdgpu/amdgpu_ring.h > index 7a27c6c4bb44..a1fb0fadb6ea 100644 > --- a/drivers/gpu/drm/amd/amdgpu/amdgpu_ring.h > +++ b/drivers/gpu/drm/amd/amdgpu/amdgpu_ring.h > @@ -62,6 +62,8 @@ enum amdgpu_ring_priority_level { > #define AMDGPU_FENCE_FLAG_64BIT (1 << 0) > #define AMDGPU_FENCE_FLAG_INT (1 << 1) > #define AMDGPU_FENCE_FLAG_TC_WB_ONLY (1 << 2) > + > +/* Ensure the execution in case of preemption or reset */ > #define AMDGPU_FENCE_FLAG_EXEC (1 << 3) > > #define to_amdgpu_ring(s) container_of((s), struct amdgpu_ring, sched)
