fs: anon_inodes: rephrase to appropriate kernel-doc
Subsystems (5)
PATCH 1/1 fs: anon_inodes: rephrase to appropriate kernel-doc
Commit e7e832ce6fa7 ("fs: add LSM-supporting anon-inode interface") adds more kerneldoc description, but also a few new warnings on anon_inode_getfd_secure() due to missing parameter descriptions.
Rephrase to appropriate kernel-doc for anon_inode_getfd_secure().
Signed-off-by Lukas Bulwahn <[email protected]>
--- fs/anon_inodes.c | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-)
fs/anon_inodes.c +14 -7
@@ -202,13 +202,20 @@ int anon_inode_getfd(const char *name, const struct file_operations *fops,EXPORT_SYMBOL_GPL (anon_inode_getfd);/** -* Like anon_inode_getfd(), but creates a new !S_PRIVATE anon inode rather than -* reuse the singleton anon inode, and calls the inode_init_security_anon() LSM -* hook. This allows the inode to have its own security context and for a LSM -* to reject creation of the inode. An optional @context_inode argument is -* also added to provide the logical relationship with the new inode. The LSM -* may use @context_inode in inode_init_security_anon(), but a reference to it -* is not held. +* anon_inode_getfd_secure - Like anon_inode_getfd(), but creates a new +* !S_PRIVATE anon inode rather than reuse the singleton anon inode, and calls +* the inode_init_security_anon() LSM hook. This allows the inode to have its +* own security context and for a LSM to reject creation of the inode. +* +* @name: [in] name of the "class" of the new file +* @fops: [in] file operations for the new file +* @priv: [in] private data for the new file (will be file's private_data) +* @flags: [in] flags +* @context_inode: +* [in] the logical relationship with the new inode (optional) +* +* The LSM may use @context_inode in inode_init_security_anon(), but a +* reference to it is not held. */ int anon_inode_getfd_secure(const char *name, const struct file_operations *fops, void *priv, int flags,
Signature · 1 line
2.17.1
Quoted 11 lines · Lukas Bulwahn
Commit
e7e832ce6fa7("fs: add LSM-supporting anon-inode interface") adds more kerneldoc description, but also a few new warnings onanon_inode_getfd_secure()due to missing parameter descriptions.Rephrase to appropriate kernel-doc for
anon_inode_getfd_secure().Signed-off-by Lukas Bulwahn <[email protected]>--- fs/anon_inodes.c | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-)
Merged into selinux/next with the other related LSM/SELinux anon-inode patches, thank you!
Signature · 2 lines
paul moore www.paul-moore.com