LSM: fix documentation for the path_chmod hook
authorDenis Efremov <efremov@ispras.ru>
Tue, 26 Feb 2019 20:49:07 +0000 (23:49 +0300)
committerJames Morris <james.morris@microsoft.com>
Tue, 26 Mar 2019 23:43:23 +0000 (16:43 -0700)
The path_chmod hook was changed in the commit
"switch security_path_chmod() to struct path *" (cdcf116d44e7).
The argument @mnt was removed from the hook, @dentry was changed
to @path. This patch updates the documentation accordingly.

Signed-off-by: Denis Efremov <efremov@ispras.ru>
Acked-by: Kees Cook <keescook@chromium.org>
Acked-by: Casey Schaufler <casey@schaufler-ca.com>
Signed-off-by: James Morris <james.morris@microsoft.com>
include/linux/lsm_hooks.h

index 69b1209..1a4e4dd 100644 (file)
  *     @new_dentry contains the dentry structure of the new link.
  *     Return 0 if permission is granted.
  * @path_chmod:
- *     Check for permission to change DAC's permission of a file or directory.
- *     @dentry contains the dentry structure.
- *     @mnt contains the vfsmnt structure.
- *     @mode contains DAC's mode.
+ *     Check for permission to change a mode of the file @path. The new
+ *     mode is specified in @mode.
+ *     @path contains the path structure of the file to change the mode.
+ *     @mode contains the new DAC's permission, which is a bitmask of
+ *     constants from <include/uapi/linux/stat.h>
  *     Return 0 if permission is granted.
  * @path_chown:
  *     Check for permission to change owner/group of a file or directory.