[PATCH v3 15/19] maple_tree: Document erase and allocations better

[Jason Gunthorpe]

On Fri, Aug 21, 2026 at 04:37:48PM -0400, Liam R. Howlett (Oracle) wrote:
> On 26/08/21 03:34PM, Rik van Riel wrote:
> > On Fri, 2026-08-21 at 15:26 -0400, Liam R. Howlett (Oracle) wrote:
> > > 
> > >  knowing one value within that range, or mtree_store() call with an
> > > entry of
> > > -NULL may be used to partially erase a range or many ranges at once.
> > > +NULL may be used to partially erase a range or many ranges at once. 
> > > Note that
> > > +mtree_erase() may use GFP_KERNEL | __GFP_NOFAIL for allocations and
> > > cannot
> > > +fail, but may need to sleep - do not use mtree_erase() from a
> > > blocking context.
> > > 
> > 
> > Do you mean "from a context that cannot block" ?
> 
> Ah, that's not clear.
> 
> "Do not use mtree_erase() from a context that cannot tolerate blocking"
> 
> Is that better?

I would say 'can sleep, so must not be called from an atomic context' ?

If that is what you mean..

Jason