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

Configure Feed

Select the types of activity you want to include in your feed.

apparmor: fix some kernel-doc issues in header files

Fix kernel-doc warnings in apparmor header files as reported by
scripts/kernel-doc:

cred.h:128: warning: expecting prototype for end_label_crit_section(). Prototype was for end_current_label_crit_section() instead
file.h:108: warning: expecting prototype for aa_map_file_perms(). Prototype was for aa_map_file_to_perms() instead

lib.h:159: warning: Function parameter or struct member 'hname' not described in 'basename'
lib.h:159: warning: Excess function parameter 'name' description in 'basename'

match.h:21: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* The format used for transition tables is based on the GNU flex table

perms.h:109: warning: Function parameter or struct member 'accum' not described in 'aa_perms_accum_raw'
perms.h:109: warning: Function parameter or struct member 'addend' not described in 'aa_perms_accum_raw'
perms.h:136: warning: Function parameter or struct member 'accum' not described in 'aa_perms_accum'
perms.h:136: warning: Function parameter or struct member 'addend' not described in 'aa_perms_accum'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Ryan Lee <ryan.lee@canonical.com>
Cc: John Johansen <john.johansen@canonical.com>
Cc: John Johansen <john@apparmor.net>
Cc: apparmor@lists.ubuntu.com
Cc: linux-security-module@vger.kernel.org
Cc: Paul Moore <paul@paul-moore.com>
Cc: James Morris <jmorris@namei.org>
Cc: "Serge E. Hallyn" <serge@hallyn.com>
Signed-off-by: John Johansen <john.johansen@canonical.com>

authored by

Randy Dunlap and committed by
John Johansen a949b46e 44fbeeb3

+8 -8
+1 -1
security/apparmor/include/cred.h
··· 117 117 #define __end_current_label_crit_section(X) end_current_label_crit_section(X) 118 118 119 119 /** 120 - * end_label_crit_section - put a reference found with begin_current_label.. 120 + * end_current_label_crit_section - put a reference found with begin_current_label.. 121 121 * @label: label reference to put 122 122 * 123 123 * Should only be used with a reference obtained with
+1 -1
security/apparmor/include/file.h
··· 104 104 105 105 106 106 /** 107 - * aa_map_file_perms - map file flags to AppArmor permissions 107 + * aa_map_file_to_perms - map file flags to AppArmor permissions 108 108 * @file: open file to map flags to AppArmor permissions 109 109 * 110 110 * Returns: apparmor permission set for the file
+1 -1
security/apparmor/include/lib.h
··· 170 170 171 171 /** 172 172 * basename - find the last component of an hname 173 - * @name: hname to find the base profile name component of (NOT NULL) 173 + * @hname: hname to find the base profile name component of (NOT NULL) 174 174 * 175 175 * Returns: the tail (base profile name) name component of an hname 176 176 */
+1 -1
security/apparmor/include/match.h
··· 17 17 #define DFA_START 1 18 18 19 19 20 - /** 20 + /* 21 21 * The format used for transition tables is based on the GNU flex table 22 22 * file format (--tables-file option; see Table File Format in the flex 23 23 * info pages and the flex sources for documentation). The magic number
+4 -4
security/apparmor/include/perms.h
··· 101 101 102 102 /** 103 103 * aa_perms_accum_raw - accumulate perms with out masking off overlapping perms 104 - * @accum - perms struct to accumulate into 105 - * @addend - perms struct to add to @accum 104 + * @accum: perms struct to accumulate into 105 + * @addend: perms struct to add to @accum 106 106 */ 107 107 static inline void aa_perms_accum_raw(struct aa_perms *accum, 108 108 struct aa_perms *addend) ··· 128 128 129 129 /** 130 130 * aa_perms_accum - accumulate perms, masking off overlapping perms 131 - * @accum - perms struct to accumulate into 132 - * @addend - perms struct to add to @accum 131 + * @accum: perms struct to accumulate into 132 + * @addend: perms struct to add to @accum 133 133 */ 134 134 static inline void aa_perms_accum(struct aa_perms *accum, 135 135 struct aa_perms *addend)