[PATCH v6 02/20] drm/gpuva_mgr: Helper to get range of unmap from a remap op.

[Donald Robson]

On Thu, 2023-09-07 at 15:14 +0300, Jani Nikula wrote:
> On Wed, 06 Sep 2023, Sarah Walker <sarah.walker at imgtec.com> wrote:
> > From: Donald Robson <donald.robson at imgtec.com>
> > 
> > Signed-off-by: Donald Robson <donald.robson at imgtec.com>
> > ---
> >  include/drm/drm_gpuva_mgr.h | 27 +++++++++++++++++++++++++++
> >  1 file changed, 27 insertions(+)
> > 
> > diff --git a/include/drm/drm_gpuva_mgr.h b/include/drm/drm_gpuva_mgr.h
> > index ed8d50200cc3..be7b3a6d7e67 100644
> > --- a/include/drm/drm_gpuva_mgr.h
> > +++ b/include/drm/drm_gpuva_mgr.h
> > @@ -703,4 +703,31 @@ void drm_gpuva_remap(struct drm_gpuva *prev,
> >  
> >  void drm_gpuva_unmap(struct drm_gpuva_op_unmap *op);
> >  
> > +/**
> > + * drm_gpuva_op_remap_get_unmap_range() - Helper to get the start and range of
> > + * the unmap stage of a remap op.
> > + * @op: Remap op.
> > + * @start_addr: Output pointer for the start of the required unmap.
> > + * @range: Output pointer for the length of the required unmap.
> > + *
> > + * These parameters can then be used by the caller to unmap memory pages that
> > + * are no longer required.
> > + */
> > +static __always_inline void
> 
> IMO __always_inline *always* requires a justification in the commit
> message.
> 
> BR,
> Jani.

Hi Jani,
I went with __always_inline because I can't see this being used more than once per driver.
I can add that to the commit message, but is that suitable justification? I could move
it to the source file or make it a macro if you prefer.
Thanks,
Donald
> 
> 
> > +drm_gpuva_op_remap_get_unmap_range(const struct drm_gpuva_op_remap *op,
> > +				   u64 *start_addr, u64 *range)
> > +{
> > +	const u64 va_start = op->prev ?
> > +			     op->prev->va.addr + op->prev->va.range :
> > +			     op->unmap->va->va.addr;
> > +	const u64 va_end = op->next ?
> > +			   op->next->va.addr :
> > +			   op->unmap->va->va.addr + op->unmap->va->va.range;
> > +
> > +	if (start_addr)
> > +		*start_addr = va_start;
> > +	if (range)
> > +		*range = va_end - va_start;
> > +}
> > +
> >  #endif /* __DRM_GPUVA_MGR_H__ */