[PATCHv3 1/6] lmb: allocation flags macro documentation

[Heinrich Schuchardt]

Am 16. April 2026 10:30:32 MESZ schrieb Ilias Apalodimas <ilias.apalodimas at linaro.org>:
>On Mon, 13 Apr 2026 at 23:36, <rs at ti.com> wrote:
>>
>> From: Randolph Sapp <rs at ti.com>
>>
>> Update the allocation flags inline documentation to follow the kernel
>> object like macro documentation.
>>
>> Signed-off-by: Randolph Sapp <rs at ti.com>
>
>Reviewed-by: Ilias Apalodimas <ilias.apalodimas at linaro.org>
>
>> ---
>>  include/lmb.h | 30 +++++++++++++++++++++++++-----
>>  1 file changed, 25 insertions(+), 5 deletions(-)
>>
>> diff --git a/include/lmb.h b/include/lmb.h
>> index 5d5f037ccb9..427d701bc30 100644
>> --- a/include/lmb.h
>> +++ b/include/lmb.h
>> @@ -19,16 +19,36 @@
>>  #define LMB_ALIST_INITIAL_SIZE 4
>>
>>  /**
>> - * DOC: Memory region attribute flags.
>> + * define LMB_NONE - no special request
>>   *
>> - * %LMB_NONE: No special request
>> - * %LMB_NOMAP: Don't add to MMU configuration
>> - * %LMB_NOOVERWRITE: The memory region cannot be overwritten/re-reserved
>> - * %LMB_NONOTIFY: Do not notify other modules of changes to this memory region
>> + * LMB Memory region attribute flag to indicate that there is no special
>> + * requests for this region. Normally used as a placeholder value.
>>   */
>>  #define LMB_NONE 0
>> +
>> +/**
>> + * define LMB_NOMAP - do not add to MMU configuration
>> + *
>> + * LMB Memory region attribute flag to indicate that the region will not be
>> + * mapped by LMB. Normally used for reserved regions.
>> + */
>>  #define LMB_NOMAP BIT(1)
>> +
>> +/**
>> + * define LMB_NOOVERWRITE - do not overwrite/re-reserved

%s/reserved/reserve/

Best regards

Heinrich

>> + *
>> + * LMB Memory region attribute flag to indicate that the region will not be
>> + * overwritten or re-reserved. Normally used for reserved regions.
>> + */
>>  #define LMB_NOOVERWRITE BIT(2)
>> +
>> +/**
>> + * define LMB_NONOTIFY - do not notify other modules of changes
>> + *
>> + * LMB Memory region attribute flag to indicate that the region will not notify
>> + * downstream allocators (currently just the EFI allocator) of changes to this
>> + * region through lmb_map_update_notify().
>> + */
>>  #define LMB_NONOTIFY BIT(3)
>>
>>  /**
>> --
>> 2.53.0
>>