mirrors/linux
1
0
Fork 1
mirror of https://github.com/torvalds/linux.git synced 2025-11-04 02:30:34 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

fs: anon_inodes: rephrase to appropriate kernel-doc

Browse source 
Commit e7e832ce6f ("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>
This commit is contained in:
Lukas Bulwahn 2021-01-15 13:03:42 +01:00 committed by Paul Moore
parent b537900f15
commit 365982aba1
1 changed files with 14 additions and 7 deletions
repo.diff.show_diff_stats Download patch file Download diff file Expand all files Collapse all files

21
fs/anon_inodes.c
View file

@ -202,13 +202,20 @@ int anon_inode_getfd(const char *name, const struct file_operations *fops,
EXPORT_SYMBOL_GPL(anon_inode_getfd); EXPORT_SYMBOL_GPL(anon_inode_getfd);
/** /**
* Like anon_inode_getfd(), but creates a new !S_PRIVATE anon inode rather than * anon_inode_getfd_secure - Like anon_inode_getfd(), but creates a new
* reuse the singleton anon inode, and calls the inode_init_security_anon() LSM * !S_PRIVATE anon inode rather than reuse the singleton anon inode, and calls
* hook. This allows the inode to have its own security context and for a LSM * the inode_init_security_anon() LSM hook. This allows the inode to have its
* to reject creation of the inode. An optional @context_inode argument is * own security context and for a LSM to reject creation of the inode.
* 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 * @name: [in] name of the "class" of the new file
* is not held. * @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, int anon_inode_getfd_secure(const char *name, const struct file_operations *fops,
void *priv, int flags, void *priv, int flags,