Re: [PATCH v2] Documentation/mm: Add information about kmap_local_folio()

[Matthew Wilcox]

On Sat, Jul 01, 2023 at 08:21:20AM -0700, Randy Dunlap wrote:
> > -* kmap_local_page().  This function is used to require short term mappings.
> > -  It can be invoked from any context (including interrupts) but the mappings
> > -  can only be used in the context which acquired them.
> > -
> > -  This function should always be used, whereas kmap_atomic() and kmap() have
> > +* kmap_local_page(), kmap_local_folio() - These functions are used to require
> 
>                                                                          acquire ?

"create" might be better?

> > +  short term mappings. They can be invoked from any context (including
> > +  interrupts) but the mappings can only be used in the context which acquired
> > +  them. The only differences between them consist in the first taking a pointer
> > +  to a struct page and the second taking a pointer to struct folio and the byte
> > +  offset within the folio which identifies the page.
> 
> -- 
> ~Randy