UPSTREAM: 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 <lukas.bulwahn@gmail.com> Signed-off-by: Paul Moore <paul@paul-moore.com> (cherry picked from commit 365982aba1f264dba26f0908700d62bfa046918c) Bug: 160737021 Bug: 169683130 Signed-off-by: Lokesh Gidra <lokeshgidra@google.com> Change-Id: I7b8882d9da9ac37bc285dfb753bbe9ddf1f9fd04
This commit is contained in:
parent
0fc375dc14
commit
0d34ce8aa7
@ -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,
|
||||
|
Loading…
Reference in New Issue
Block a user