Recognize and ignore __rcu (in struct members), __private (in struct members), and __always_unused (in function parameters) to prevent kernel-doc warnings: Warning: include/linux/rethook.h:38 struct member 'void (__rcu *handler' not described in 'rethook' Warning: include/linux/hrtimer_types.h:47 Invalid param: enum hrtimer_restart (*__private function)(struct hrtimer *) Warning: security/ipe/hooks.c:81 function parameter '__always_unused' not described in 'ipe_mmap_file' Warning: security/ipe/hooks.c:109 function parameter '__always_unused' not described in 'ipe_file_mprotect' There are more of these (in compiler_types.h, compiler_attributes.h) that can be added as needed.
Showing the changes to tools/lib/python (1 of 1 file). Show all
Unified · Split
| @@ -86,6 +86,8 @@ struct_xforms = [ · 85 unmodified lines | ||
| 86 | 86 | (KernRe(r'\s*__counted_by_(le|be)\s*\([^;]*\)', re.S), ' '), |
| 87 | 87 | (KernRe(r'\s*__packed\s*', re.S), ' '), |
| 88 | 88 | (KernRe(r'\s*CRYPTO_MINALIGN_ATTR', re.S), ' '), |
| 89 | + (KernRe(r'\s*__private', re.S), ' '), | |
| 90 | + (KernRe(r'\s*__rcu', re.S), ' '), | |
| 89 | 91 | (KernRe(r'\s*____cacheline_aligned_in_smp', re.S), ' '), |
| 90 | 92 | (KernRe(r'\s*____cacheline_aligned', re.S), ' '), |
| 91 | 93 | (KernRe(r'\s*__cacheline_group_(begin|end)\([^\)]+\);'), ''), |
| @@ -183,6 +185,7 @@ function_xforms = [ · 91 unmodified lines | ||
| 183 | 185 | (KernRe(r"__weak +"), ""), |
| 184 | 186 | (KernRe(r"__sched +"), ""), |
| 185 | 187 | (KernRe(r"_noprof"), ""), |
| 188 | + (KernRe(r"__always_unused *"), ""), | |
| 186 | 189 | (KernRe(r"__printf\s*\(\s*\d*\s*,\s*\d*\s*\) +"), ""), |
| 187 | 190 | (KernRe(r"__(?:re)?alloc_size\s*\(\s*\d+\s*(?:,\s*\d+\s*)?\) +"), ""), |
| 188 | 191 | (KernRe(r"__diagnose_as\s*\(\s*\S+\s*(?:,\s*\d+\s*)*\) +"), ""), |