Message ID | 20240327044649.9199-1-rdunlap@infradead.org (mailing list archive) |
---|---|
State | New |
Headers | show |
Series | mm/slab: fix kcalloc() kernel-doc warnings | expand |
On Tue, Mar 26, 2024 at 9:46 PM Randy Dunlap <rdunlap@infradead.org> wrote: > > Fix the parameter names for kcalloc() in slab.h to prevent kernel-doc > warnings: > > include/linux/slab.h:730: warning: Function parameter or struct member '_n' not described in 'kcalloc' > include/linux/slab.h:730: warning: Function parameter or struct member '_size' not described in 'kcalloc' > include/linux/slab.h:730: warning: Function parameter or struct member '_flags' not described in 'kcalloc' > include/linux/slab.h:730: warning: Excess function parameter 'n' description in 'kcalloc' > include/linux/slab.h:730: warning: Excess function parameter 'size' description in 'kcalloc' > include/linux/slab.h:730: warning: Excess function parameter 'flags' description in 'kcalloc' > > Fixes: bc7b83f5e4bf ("mm/slab: enable slab allocation tagging for kmalloc and friends") > Signed-off-by: Randy Dunlap <rdunlap@infradead.org> > Reported-by: Stephen Rothwell <sfr@canb.auug.org.au> > Link: https://lore.kernel.org/linux-next/20240325123603.1bdd6588@canb.auug.org.au/ > Cc: Suren Baghdasaryan <surenb@google.com> > Cc: Kent Overstreet <kent.overstreet@linux.dev> > Cc: Vlastimil Babka <vbabka@suse.cz> > Cc: Andrew Morton <akpm@linux-foundation.org> > Cc: linux-mm@kvack.org Doh! I noticed these warnings but completely forgot to fix them in my fixup patchset :( Thanks for the fix! Tested-by: Suren Baghdasaryan <surenb@google.com> > --- > include/linux/slab.h | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff -- a/include/linux/slab.h b/include/linux/slab.h > --- a/include/linux/slab.h > +++ b/include/linux/slab.h > @@ -727,7 +727,7 @@ static inline __realloc_size(2, 3) void > * @size: element size. > * @flags: the type of memory to allocate (see kmalloc). > */ > -#define kcalloc(_n, _size, _flags) kmalloc_array(_n, _size, (_flags) | __GFP_ZERO) > +#define kcalloc(n, size, flags) kmalloc_array(n, size, (flags) | __GFP_ZERO) > > void *kmalloc_node_track_caller_noprof(size_t size, gfp_t flags, int node, > unsigned long caller) __alloc_size(1);
diff -- a/include/linux/slab.h b/include/linux/slab.h --- a/include/linux/slab.h +++ b/include/linux/slab.h @@ -727,7 +727,7 @@ static inline __realloc_size(2, 3) void * @size: element size. * @flags: the type of memory to allocate (see kmalloc). */ -#define kcalloc(_n, _size, _flags) kmalloc_array(_n, _size, (_flags) | __GFP_ZERO) +#define kcalloc(n, size, flags) kmalloc_array(n, size, (flags) | __GFP_ZERO) void *kmalloc_node_track_caller_noprof(size_t size, gfp_t flags, int node, unsigned long caller) __alloc_size(1);
Fix the parameter names for kcalloc() in slab.h to prevent kernel-doc warnings: include/linux/slab.h:730: warning: Function parameter or struct member '_n' not described in 'kcalloc' include/linux/slab.h:730: warning: Function parameter or struct member '_size' not described in 'kcalloc' include/linux/slab.h:730: warning: Function parameter or struct member '_flags' not described in 'kcalloc' include/linux/slab.h:730: warning: Excess function parameter 'n' description in 'kcalloc' include/linux/slab.h:730: warning: Excess function parameter 'size' description in 'kcalloc' include/linux/slab.h:730: warning: Excess function parameter 'flags' description in 'kcalloc' Fixes: bc7b83f5e4bf ("mm/slab: enable slab allocation tagging for kmalloc and friends") Signed-off-by: Randy Dunlap <rdunlap@infradead.org> Reported-by: Stephen Rothwell <sfr@canb.auug.org.au> Link: https://lore.kernel.org/linux-next/20240325123603.1bdd6588@canb.auug.org.au/ Cc: Suren Baghdasaryan <surenb@google.com> Cc: Kent Overstreet <kent.overstreet@linux.dev> Cc: Vlastimil Babka <vbabka@suse.cz> Cc: Andrew Morton <akpm@linux-foundation.org> Cc: linux-mm@kvack.org --- include/linux/slab.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)