vfs: define a generic function to read a file from the kernel

For a while it was looked down upon to directly read files from Linux.
These days there exists a few mechanisms in the kernel that do just
this though to load a file into a local buffer.  There are minor but
important checks differences on each.  This patch set is the first
attempt at resolving some of these differences.

This patch introduces a common function for reading files from the kernel
with the corresponding security post-read hook and function.

Changelog v4+:
- export security_kernel_post_read_file() - Fengguang Wu
v3:
- additional bounds checking - Luis
v2:
- To simplify patch review, re-ordered patches

Signed-off-by: Mimi Zohar <zohar@linux.vnet.ibm.com>
Reviewed-by: Luis R. Rodriguez <mcgrof@suse.com>
Acked-by: Kees Cook <keescook@chromium.org>
Cc: Al Viro <viro@zeniv.linux.org.uk>

1 files changed, 9 insertions, 0 deletions

diff --git a/include/linux/lsm_hooks.h b/include/linux/lsm_hooks.h
index 71969de4058c..f82631cc7248 100644
--- a/include/linux/lsm_hooks.h
+++ b/include/linux/lsm_hooks.h
@@ -561,6 +561,13 @@
  *      the kernel module to load. If the module is being loaded from a blob,
  *      this argument will be NULL.
  *      Return 0 if permission is granted.
+ * @kernel_post_read_file:
+ *      Read a file specified by userspace.
+ *      @file contains the file structure pointing to the file being read
+ *      by the kernel.
+ *      @buf pointer to buffer containing the file contents.
+ *      @size length of the file contents.
+ *      Return 0 if permission is granted.
  * @task_fix_setuid:
  *      Update the module's state after setting one or more of the user
  *      identity attributes of the current process.  The @flags parameter
@@ -1457,6 +1464,7 @@ union security_list_options {
         int (*kernel_fw_from_file)(struct file *file, char *buf, size_t size);
         int (*kernel_module_request)(char *kmod_name);
         int (*kernel_module_from_file)(struct file *file);
+        int (*kernel_post_read_file)(struct file *file, char *buf, loff_t size);
         int (*task_fix_setuid)(struct cred *new, const struct cred *old,
                                 int flags);
         int (*task_setpgid)(struct task_struct *p, pid_t pgid);
@@ -1716,6 +1724,7 @@ struct security_hook_heads {
         struct list_head kernel_act_as;
         struct list_head kernel_create_files_as;
         struct list_head kernel_fw_from_file;
+        struct list_head kernel_post_read_file;
         struct list_head kernel_module_request;
         struct list_head kernel_module_from_file;
         struct list_head task_fix_setuid;