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

[Randy Dunlap]

On 7/1/23 16:54, Matthew Wilcox wrote:
> 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?

Yes, that's good.

>>> +  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

-- 
~Randy