Re: [PATCH] PR_*ET_THP_DISABLE.2const: document addition of PR_THP_DISABLE_EXCEPT_ADVISED

[David Hildenbrand <david@redhat.com>]

On 01.09.25 18:18, Usama Arif wrote:
> 
> 
> On 01/09/2025 17:09, Usama Arif wrote:
>> PR_THP_DISABLE_EXCEPT_ADVISED extended PR_SET_THP_DISABLE to only provide
>> THPs when advised. IOW, it allows individual processes to opt-out of THP =
>> "always" into THP = "madvise", without affecting other workloads on the
>> system. The series has been merged in [1].
>>
>> This patch documents the changes introduced due to the addition of
>> PR_THP_DISABLE_EXCEPT_ADVISED flag:
>> - PR_GET_THP_DISABLE returns a value whose bits indicate how THP-disable
>>    is configured for the calling thread (with or without
>>    PR_THP_DISABLE_EXCEPT_ADVISED).
>> - PR_SET_THP_DISABLE now uses arg3 to specify whether to disable THP
>>    completely for the process, or disable except madvise
>>    (PR_THP_DISABLE_EXCEPT_ADVISED).
>>
>> [1] https://lore.kernel.org/all/20250815135549.130506-1-usamaarif642@gmail.com/
>>
>> Signed-off-by: Usama Arif <usamaarif642@gmail.com>
>> ---
>>   man/man2/madvise.2                      |  4 +-
>>   man/man2const/PR_GET_THP_DISABLE.2const | 18 ++++++---
>>   man/man2const/PR_SET_THP_DISABLE.2const | 52 +++++++++++++++++++++----
>>   3 files changed, 61 insertions(+), 13 deletions(-)
>>
> 
> I am not sure what the right time is to send the mandoc changes.
> The patches have been merged into mm-new for more than 2 weeks.
> We can still review it and I can resend if needed after the kernel release if that
> is a more appropriate time?

Probably good to revive once it's in Linus' tree.

-- 
Cheers

David / dhildenb