root/fs/proc/root.c

/* [<][>][^][v][top][bottom][index][help] */

DEFINITIONS

This source file includes following definitions.
  1. proc_parse_param
  2. proc_apply_options
  3. proc_fill_super
  4. proc_reconfigure
  5. proc_get_tree
  6. proc_fs_context_free
  7. proc_init_fs_context
  8. proc_kill_sb
  9. proc_root_init
  10. proc_root_getattr
  11. proc_root_lookup
  12. proc_root_readdir
  13. pid_ns_prepare_proc
  14. pid_ns_release_proc

   1 // SPDX-License-Identifier: GPL-2.0
   2 /*
   3  *  linux/fs/proc/root.c
   4  *
   5  *  Copyright (C) 1991, 1992 Linus Torvalds
   6  *
   7  *  proc root directory handling functions
   8  */
   9 
  10 #include <linux/uaccess.h>
  11 
  12 #include <linux/errno.h>
  13 #include <linux/time.h>
  14 #include <linux/proc_fs.h>
  15 #include <linux/stat.h>
  16 #include <linux/init.h>
  17 #include <linux/sched.h>
  18 #include <linux/sched/stat.h>
  19 #include <linux/module.h>
  20 #include <linux/bitops.h>
  21 #include <linux/user_namespace.h>
  22 #include <linux/fs_context.h>
  23 #include <linux/mount.h>
  24 #include <linux/pid_namespace.h>
  25 #include <linux/fs_parser.h>
  26 #include <linux/cred.h>
  27 #include <linux/magic.h>
  28 #include <linux/slab.h>
  29 
  30 #include "internal.h"
  31 
  32 struct proc_fs_context {
  33         struct pid_namespace    *pid_ns;
  34         unsigned int            mask;
  35         int                     hidepid;
  36         int                     gid;
  37 };
  38 
  39 enum proc_param {
  40         Opt_gid,
  41         Opt_hidepid,
  42 };
  43 
  44 static const struct fs_parameter_spec proc_param_specs[] = {
  45         fsparam_u32("gid",      Opt_gid),
  46         fsparam_u32("hidepid",  Opt_hidepid),
  47         {}
  48 };
  49 
  50 static const struct fs_parameter_description proc_fs_parameters = {
  51         .name           = "proc",
  52         .specs          = proc_param_specs,
  53 };
  54 
  55 static int proc_parse_param(struct fs_context *fc, struct fs_parameter *param)
  56 {
  57         struct proc_fs_context *ctx = fc->fs_private;
  58         struct fs_parse_result result;
  59         int opt;
  60 
  61         opt = fs_parse(fc, &proc_fs_parameters, param, &result);
  62         if (opt < 0)
  63                 return opt;
  64 
  65         switch (opt) {
  66         case Opt_gid:
  67                 ctx->gid = result.uint_32;
  68                 break;
  69 
  70         case Opt_hidepid:
  71                 ctx->hidepid = result.uint_32;
  72                 if (ctx->hidepid < HIDEPID_OFF ||
  73                     ctx->hidepid > HIDEPID_INVISIBLE)
  74                         return invalf(fc, "proc: hidepid value must be between 0 and 2.\n");
  75                 break;
  76 
  77         default:
  78                 return -EINVAL;
  79         }
  80 
  81         ctx->mask |= 1 << opt;
  82         return 0;
  83 }
  84 
  85 static void proc_apply_options(struct super_block *s,
  86                                struct fs_context *fc,
  87                                struct pid_namespace *pid_ns,
  88                                struct user_namespace *user_ns)
  89 {
  90         struct proc_fs_context *ctx = fc->fs_private;
  91 
  92         if (ctx->mask & (1 << Opt_gid))
  93                 pid_ns->pid_gid = make_kgid(user_ns, ctx->gid);
  94         if (ctx->mask & (1 << Opt_hidepid))
  95                 pid_ns->hide_pid = ctx->hidepid;
  96 }
  97 
  98 static int proc_fill_super(struct super_block *s, struct fs_context *fc)
  99 {
 100         struct pid_namespace *pid_ns = get_pid_ns(s->s_fs_info);
 101         struct inode *root_inode;
 102         int ret;
 103 
 104         proc_apply_options(s, fc, pid_ns, current_user_ns());
 105 
 106         /* User space would break if executables or devices appear on proc */
 107         s->s_iflags |= SB_I_USERNS_VISIBLE | SB_I_NOEXEC | SB_I_NODEV;
 108         s->s_flags |= SB_NODIRATIME | SB_NOSUID | SB_NOEXEC;
 109         s->s_blocksize = 1024;
 110         s->s_blocksize_bits = 10;
 111         s->s_magic = PROC_SUPER_MAGIC;
 112         s->s_op = &proc_sops;
 113         s->s_time_gran = 1;
 114 
 115         /*
 116          * procfs isn't actually a stacking filesystem; however, there is
 117          * too much magic going on inside it to permit stacking things on
 118          * top of it
 119          */
 120         s->s_stack_depth = FILESYSTEM_MAX_STACK_DEPTH;
 121         
 122         /* procfs dentries and inodes don't require IO to create */
 123         s->s_shrink.seeks = 0;
 124 
 125         pde_get(&proc_root);
 126         root_inode = proc_get_inode(s, &proc_root);
 127         if (!root_inode) {
 128                 pr_err("proc_fill_super: get root inode failed\n");
 129                 return -ENOMEM;
 130         }
 131 
 132         s->s_root = d_make_root(root_inode);
 133         if (!s->s_root) {
 134                 pr_err("proc_fill_super: allocate dentry failed\n");
 135                 return -ENOMEM;
 136         }
 137 
 138         ret = proc_setup_self(s);
 139         if (ret) {
 140                 return ret;
 141         }
 142         return proc_setup_thread_self(s);
 143 }
 144 
 145 static int proc_reconfigure(struct fs_context *fc)
 146 {
 147         struct super_block *sb = fc->root->d_sb;
 148         struct pid_namespace *pid = sb->s_fs_info;
 149 
 150         sync_filesystem(sb);
 151 
 152         proc_apply_options(sb, fc, pid, current_user_ns());
 153         return 0;
 154 }
 155 
 156 static int proc_get_tree(struct fs_context *fc)
 157 {
 158         struct proc_fs_context *ctx = fc->fs_private;
 159 
 160         return get_tree_keyed(fc, proc_fill_super, ctx->pid_ns);
 161 }
 162 
 163 static void proc_fs_context_free(struct fs_context *fc)
 164 {
 165         struct proc_fs_context *ctx = fc->fs_private;
 166 
 167         put_pid_ns(ctx->pid_ns);
 168         kfree(ctx);
 169 }
 170 
 171 static const struct fs_context_operations proc_fs_context_ops = {
 172         .free           = proc_fs_context_free,
 173         .parse_param    = proc_parse_param,
 174         .get_tree       = proc_get_tree,
 175         .reconfigure    = proc_reconfigure,
 176 };
 177 
 178 static int proc_init_fs_context(struct fs_context *fc)
 179 {
 180         struct proc_fs_context *ctx;
 181 
 182         ctx = kzalloc(sizeof(struct proc_fs_context), GFP_KERNEL);
 183         if (!ctx)
 184                 return -ENOMEM;
 185 
 186         ctx->pid_ns = get_pid_ns(task_active_pid_ns(current));
 187         put_user_ns(fc->user_ns);
 188         fc->user_ns = get_user_ns(ctx->pid_ns->user_ns);
 189         fc->fs_private = ctx;
 190         fc->ops = &proc_fs_context_ops;
 191         return 0;
 192 }
 193 
 194 static void proc_kill_sb(struct super_block *sb)
 195 {
 196         struct pid_namespace *ns;
 197 
 198         ns = (struct pid_namespace *)sb->s_fs_info;
 199         if (ns->proc_self)
 200                 dput(ns->proc_self);
 201         if (ns->proc_thread_self)
 202                 dput(ns->proc_thread_self);
 203         kill_anon_super(sb);
 204         put_pid_ns(ns);
 205 }
 206 
 207 static struct file_system_type proc_fs_type = {
 208         .name                   = "proc",
 209         .init_fs_context        = proc_init_fs_context,
 210         .parameters             = &proc_fs_parameters,
 211         .kill_sb                = proc_kill_sb,
 212         .fs_flags               = FS_USERNS_MOUNT | FS_DISALLOW_NOTIFY_PERM,
 213 };
 214 
 215 void __init proc_root_init(void)
 216 {
 217         proc_init_kmemcache();
 218         set_proc_pid_nlink();
 219         proc_self_init();
 220         proc_thread_self_init();
 221         proc_symlink("mounts", NULL, "self/mounts");
 222 
 223         proc_net_init();
 224         proc_mkdir("fs", NULL);
 225         proc_mkdir("driver", NULL);
 226         proc_create_mount_point("fs/nfsd"); /* somewhere for the nfsd filesystem to be mounted */
 227 #if defined(CONFIG_SUN_OPENPROMFS) || defined(CONFIG_SUN_OPENPROMFS_MODULE)
 228         /* just give it a mountpoint */
 229         proc_create_mount_point("openprom");
 230 #endif
 231         proc_tty_init();
 232         proc_mkdir("bus", NULL);
 233         proc_sys_init();
 234 
 235         register_filesystem(&proc_fs_type);
 236 }
 237 
 238 static int proc_root_getattr(const struct path *path, struct kstat *stat,
 239                              u32 request_mask, unsigned int query_flags)
 240 {
 241         generic_fillattr(d_inode(path->dentry), stat);
 242         stat->nlink = proc_root.nlink + nr_processes();
 243         return 0;
 244 }
 245 
 246 static struct dentry *proc_root_lookup(struct inode * dir, struct dentry * dentry, unsigned int flags)
 247 {
 248         if (!proc_pid_lookup(dentry, flags))
 249                 return NULL;
 250 
 251         return proc_lookup(dir, dentry, flags);
 252 }
 253 
 254 static int proc_root_readdir(struct file *file, struct dir_context *ctx)
 255 {
 256         if (ctx->pos < FIRST_PROCESS_ENTRY) {
 257                 int error = proc_readdir(file, ctx);
 258                 if (unlikely(error <= 0))
 259                         return error;
 260                 ctx->pos = FIRST_PROCESS_ENTRY;
 261         }
 262 
 263         return proc_pid_readdir(file, ctx);
 264 }
 265 
 266 /*
 267  * The root /proc directory is special, as it has the
 268  * <pid> directories. Thus we don't use the generic
 269  * directory handling functions for that..
 270  */
 271 static const struct file_operations proc_root_operations = {
 272         .read            = generic_read_dir,
 273         .iterate_shared  = proc_root_readdir,
 274         .llseek         = generic_file_llseek,
 275 };
 276 
 277 /*
 278  * proc root can do almost nothing..
 279  */
 280 static const struct inode_operations proc_root_inode_operations = {
 281         .lookup         = proc_root_lookup,
 282         .getattr        = proc_root_getattr,
 283 };
 284 
 285 /*
 286  * This is the root "inode" in the /proc tree..
 287  */
 288 struct proc_dir_entry proc_root = {
 289         .low_ino        = PROC_ROOT_INO, 
 290         .namelen        = 5, 
 291         .mode           = S_IFDIR | S_IRUGO | S_IXUGO, 
 292         .nlink          = 2, 
 293         .refcnt         = REFCOUNT_INIT(1),
 294         .proc_iops      = &proc_root_inode_operations, 
 295         .proc_fops      = &proc_root_operations,
 296         .parent         = &proc_root,
 297         .subdir         = RB_ROOT,
 298         .name           = "/proc",
 299 };
 300 
 301 int pid_ns_prepare_proc(struct pid_namespace *ns)
 302 {
 303         struct proc_fs_context *ctx;
 304         struct fs_context *fc;
 305         struct vfsmount *mnt;
 306 
 307         fc = fs_context_for_mount(&proc_fs_type, SB_KERNMOUNT);
 308         if (IS_ERR(fc))
 309                 return PTR_ERR(fc);
 310 
 311         if (fc->user_ns != ns->user_ns) {
 312                 put_user_ns(fc->user_ns);
 313                 fc->user_ns = get_user_ns(ns->user_ns);
 314         }
 315 
 316         ctx = fc->fs_private;
 317         if (ctx->pid_ns != ns) {
 318                 put_pid_ns(ctx->pid_ns);
 319                 get_pid_ns(ns);
 320                 ctx->pid_ns = ns;
 321         }
 322 
 323         mnt = fc_mount(fc);
 324         put_fs_context(fc);
 325         if (IS_ERR(mnt))
 326                 return PTR_ERR(mnt);
 327 
 328         ns->proc_mnt = mnt;
 329         return 0;
 330 }
 331 
 332 void pid_ns_release_proc(struct pid_namespace *ns)
 333 {
 334         kern_unmount(ns->proc_mnt);
 335 }

/* [<][>][^][v][top][bottom][index][help] */