Skip to content

Commit 2b351ea

Browse files
sanjay-embeddedVlastimil Babka (SUSE)
authored andcommitted
mm/slub: drop duplicate kernel-doc for ksize()
The implementation of ksize() was updated with kernel-doc by commit fab0694 ("mm/slab: move [__]ksize and slab_ksize() to mm/slub.c") However, the public header still contains a kernel-doc comment attached to the ksize() prototype. Having documentation both in the header and next to the implementation causes Sphinx to treat the function as being documented twice, resulting in the warning: WARNING: Duplicate C declaration, also defined at core-api/mm-api:521 Declaration is '.. c:function:: size_t ksize(const void *objp)' Kernel-doc guidelines recommend keeping the documentation with the function implementation. Therefore remove the redundant kernel-doc block from include/linux/slab.h so that the implementation in slub.c remains the canonical source for documentation. No functional change. Fixes: fab0694 ("mm/slab: move [__]ksize and slab_ksize() to mm/slub.c") Signed-off-by: Sanjay Chitroda <sanjayembeddedse@gmail.com> Link: https://patch.msgid.link/20260226054712.3610744-1-sanjayembedded@gmail.com Signed-off-by: Vlastimil Babka (SUSE) <vbabka@kernel.org>
1 parent f3ec502 commit 2b351ea

File tree

1 file changed

+0
-12
lines changed

1 file changed

+0
-12
lines changed

include/linux/slab.h

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -517,18 +517,6 @@ void kfree_sensitive(const void *objp);
517517
DEFINE_FREE(kfree, void *, if (!IS_ERR_OR_NULL(_T)) kfree(_T))
518518
DEFINE_FREE(kfree_sensitive, void *, if (_T) kfree_sensitive(_T))
519519

520-
/**
521-
* ksize - Report actual allocation size of associated object
522-
*
523-
* @objp: Pointer returned from a prior kmalloc()-family allocation.
524-
*
525-
* This should not be used for writing beyond the originally requested
526-
* allocation size. Either use krealloc() or round up the allocation size
527-
* with kmalloc_size_roundup() prior to allocation. If this is used to
528-
* access beyond the originally requested allocation size, UBSAN_BOUNDS
529-
* and/or FORTIFY_SOURCE may trip, since they only know about the
530-
* originally allocated size via the __alloc_size attribute.
531-
*/
532520
size_t ksize(const void *objp);
533521

534522
#ifdef CONFIG_PRINTK

0 commit comments

Comments
 (0)