Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

mm: eliminate "expecting prototype" kernel-doc warnings

Fix stray kernel-doc warnings in mm/ due to mis-typed or missing function
names.

Quietens these kernel-doc warnings:

mm/mmu_gather.c:264: warning: expecting prototype for tlb_gather_mmu(). Prototype was for __tlb_gather_mmu() instead
mm/oom_kill.c:180: warning: expecting prototype for Check whether unreclaimable slab amount is greater than(). Prototype was for should_dump_unreclaim_slab() instead
mm/shuffle.c:155: warning: expecting prototype for shuffle_free_memory(). Prototype was for __shuffle_free_memory() instead

Link: https://lkml.kernel.org/r/20210411210642.11362-1-rdunlap@infradead.org
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Matthew Wilcox (Oracle) <willy@infradead.org>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

authored by

Randy Dunlap and committed by
Linus Torvalds
845be1cd 06c2aac4

+22 -13
+19 -10
mm/mmu_gather.c
··· 249 249 tlb_flush_mmu_free(tlb); 250 250 } 251 251 252 - /** 253 - * tlb_gather_mmu - initialize an mmu_gather structure for page-table tear-down 254 - * @tlb: the mmu_gather structure to initialize 255 - * @mm: the mm_struct of the target address space 256 - * @fullmm: @mm is without users and we're going to destroy the full address 257 - * space (exit/execve) 258 - * 259 - * Called to initialize an (on-stack) mmu_gather structure for page-table 260 - * tear-down from @mm. 261 - */ 262 252 static void __tlb_gather_mmu(struct mmu_gather *tlb, struct mm_struct *mm, 263 253 bool fullmm) 264 254 { ··· 273 283 inc_tlb_flush_pending(tlb->mm); 274 284 } 275 285 286 + /** 287 + * tlb_gather_mmu - initialize an mmu_gather structure for page-table tear-down 288 + * @tlb: the mmu_gather structure to initialize 289 + * @mm: the mm_struct of the target address space 290 + * 291 + * Called to initialize an (on-stack) mmu_gather structure for page-table 292 + * tear-down from @mm. 293 + */ 276 294 void tlb_gather_mmu(struct mmu_gather *tlb, struct mm_struct *mm) 277 295 { 278 296 __tlb_gather_mmu(tlb, mm, false); 279 297 } 280 298 299 + /** 300 + * tlb_gather_mmu_fullmm - initialize an mmu_gather structure for page-table tear-down 301 + * @tlb: the mmu_gather structure to initialize 302 + * @mm: the mm_struct of the target address space 303 + * 304 + * In this case, @mm is without users and we're going to destroy the 305 + * full address space (exit/execve). 306 + * 307 + * Called to initialize an (on-stack) mmu_gather structure for page-table 308 + * tear-down from @mm. 309 + */ 281 310 void tlb_gather_mmu_fullmm(struct mmu_gather *tlb, struct mm_struct *mm) 282 311 { 283 312 __tlb_gather_mmu(tlb, mm, true);
+1 -1
mm/oom_kill.c
··· 170 170 return false; 171 171 } 172 172 173 - /** 173 + /* 174 174 * Check whether unreclaimable slab amount is greater than 175 175 * all user memory(LRU pages). 176 176 * dump_unreclaimable_slab() could help in the case that
+2 -2
mm/shuffle.c
··· 147 147 spin_unlock_irqrestore(&z->lock, flags); 148 148 } 149 149 150 - /** 151 - * shuffle_free_memory - reduce the predictability of the page allocator 150 + /* 151 + * __shuffle_free_memory - reduce the predictability of the page allocator 152 152 * @pgdat: node page data 153 153 */ 154 154 void __meminit __shuffle_free_memory(pg_data_t *pgdat)