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