1 // SPDX-License-Identifier: GPL-2.0
3 * devtmpfs - kernel-maintained tmpfs-based /dev
5 * Copyright (C) 2009, Kay Sievers <kay.sievers@vrfy.org>
7 * During bootup, before any driver core device is registered,
8 * devtmpfs, a tmpfs-based filesystem is created. Every driver-core
9 * device which requests a device node, will add a node in this
11 * By default, all devices are named after the name of the device,
12 * owned by root and have a default mode of 0600. Subsystems can
13 * overwrite the default setting if needed.
16 #include <linux/kernel.h>
17 #include <linux/syscalls.h>
18 #include <linux/mount.h>
19 #include <linux/device.h>
20 #include <linux/genhd.h>
21 #include <linux/namei.h>
23 #include <linux/shmem_fs.h>
24 #include <linux/ramfs.h>
25 #include <linux/sched.h>
26 #include <linux/slab.h>
27 #include <linux/kthread.h>
28 #include <uapi/linux/mount.h>
31 static struct task_struct *thread;
33 #if defined CONFIG_DEVTMPFS_MOUNT
34 static int mount_dev = 1;
39 static DEFINE_SPINLOCK(req_lock);
43 struct completion done;
46 umode_t mode; /* 0 => delete */
52 static int __init mount_param(char *str)
54 mount_dev = simple_strtoul(str, NULL, 0);
57 __setup("devtmpfs.mount=", mount_param);
59 static struct dentry *dev_mount(struct file_system_type *fs_type, int flags,
60 const char *dev_name, void *data)
63 return mount_single(fs_type, flags, data, shmem_fill_super);
65 return mount_single(fs_type, flags, data, ramfs_fill_super);
69 static struct file_system_type dev_fs_type = {
72 .kill_sb = kill_litter_super,
76 static inline int is_blockdev(struct device *dev)
78 return dev->class == &block_class;
81 static inline int is_blockdev(struct device *dev) { return 0; }
84 int devtmpfs_create_node(struct device *dev)
86 const char *tmp = NULL;
93 req.uid = GLOBAL_ROOT_UID;
94 req.gid = GLOBAL_ROOT_GID;
95 req.name = device_get_devnode(dev, &req.mode, &req.uid, &req.gid, &tmp);
101 if (is_blockdev(dev))
108 init_completion(&req.done);
110 spin_lock(&req_lock);
113 spin_unlock(&req_lock);
115 wake_up_process(thread);
116 wait_for_completion(&req.done);
123 int devtmpfs_delete_node(struct device *dev)
125 const char *tmp = NULL;
131 req.name = device_get_devnode(dev, NULL, NULL, NULL, &tmp);
138 init_completion(&req.done);
140 spin_lock(&req_lock);
143 spin_unlock(&req_lock);
145 wake_up_process(thread);
146 wait_for_completion(&req.done);
152 static int dev_mkdir(const char *name, umode_t mode)
154 struct dentry *dentry;
158 dentry = kern_path_create(AT_FDCWD, name, &path, LOOKUP_DIRECTORY);
160 return PTR_ERR(dentry);
162 err = vfs_mkdir(d_inode(path.dentry), dentry, mode);
164 /* mark as kernel-created inode */
165 d_inode(dentry)->i_private = &thread;
166 done_path_create(&path, dentry);
170 static int create_path(const char *nodepath)
176 /* parent directories do not exist, create them */
177 path = kstrdup(nodepath, GFP_KERNEL);
187 err = dev_mkdir(path, 0755);
188 if (err && err != -EEXIST)
197 static int handle_create(const char *nodename, umode_t mode, kuid_t uid,
198 kgid_t gid, struct device *dev)
200 struct dentry *dentry;
204 dentry = kern_path_create(AT_FDCWD, nodename, &path, 0);
205 if (dentry == ERR_PTR(-ENOENT)) {
206 create_path(nodename);
207 dentry = kern_path_create(AT_FDCWD, nodename, &path, 0);
210 return PTR_ERR(dentry);
212 err = vfs_mknod(d_inode(path.dentry), dentry, mode, dev->devt);
214 struct iattr newattrs;
216 newattrs.ia_mode = mode;
217 newattrs.ia_uid = uid;
218 newattrs.ia_gid = gid;
219 newattrs.ia_valid = ATTR_MODE|ATTR_UID|ATTR_GID;
220 inode_lock(d_inode(dentry));
221 notify_change(dentry, &newattrs, NULL);
222 inode_unlock(d_inode(dentry));
224 /* mark as kernel-created inode */
225 d_inode(dentry)->i_private = &thread;
227 done_path_create(&path, dentry);
231 static int dev_rmdir(const char *name)
234 struct dentry *dentry;
237 dentry = kern_path_locked(name, &parent);
239 return PTR_ERR(dentry);
240 if (d_really_is_positive(dentry)) {
241 if (d_inode(dentry)->i_private == &thread)
242 err = vfs_rmdir(d_inode(parent.dentry), dentry);
249 inode_unlock(d_inode(parent.dentry));
254 static int delete_path(const char *nodepath)
259 path = kstrdup(nodepath, GFP_KERNEL);
266 base = strrchr(path, '/');
270 err = dev_rmdir(path);
279 static int dev_mynode(struct device *dev, struct inode *inode, struct kstat *stat)
281 /* did we create it */
282 if (inode->i_private != &thread)
285 /* does the dev_t match */
286 if (is_blockdev(dev)) {
287 if (!S_ISBLK(stat->mode))
290 if (!S_ISCHR(stat->mode))
293 if (stat->rdev != dev->devt)
300 static int handle_remove(const char *nodename, struct device *dev)
303 struct dentry *dentry;
307 dentry = kern_path_locked(nodename, &parent);
309 return PTR_ERR(dentry);
311 if (d_really_is_positive(dentry)) {
313 struct path p = {.mnt = parent.mnt, .dentry = dentry};
314 err = vfs_getattr(&p, &stat, STATX_TYPE | STATX_MODE,
315 AT_STATX_SYNC_AS_STAT);
316 if (!err && dev_mynode(dev, d_inode(dentry), &stat)) {
317 struct iattr newattrs;
319 * before unlinking this node, reset permissions
320 * of possible references like hardlinks
322 newattrs.ia_uid = GLOBAL_ROOT_UID;
323 newattrs.ia_gid = GLOBAL_ROOT_GID;
324 newattrs.ia_mode = stat.mode & ~0777;
326 ATTR_UID|ATTR_GID|ATTR_MODE;
327 inode_lock(d_inode(dentry));
328 notify_change(dentry, &newattrs, NULL);
329 inode_unlock(d_inode(dentry));
330 err = vfs_unlink(d_inode(parent.dentry), dentry, NULL);
331 if (!err || err == -ENOENT)
338 inode_unlock(d_inode(parent.dentry));
341 if (deleted && strchr(nodename, '/'))
342 delete_path(nodename);
347 * If configured, or requested by the commandline, devtmpfs will be
348 * auto-mounted after the kernel mounted the root filesystem.
350 int devtmpfs_mount(const char *mntdir)
360 err = ksys_mount("devtmpfs", mntdir, "devtmpfs", MS_SILENT, NULL);
362 printk(KERN_INFO "devtmpfs: error mounting %i\n", err);
364 printk(KERN_INFO "devtmpfs: mounted\n");
368 static DECLARE_COMPLETION(setup_done);
370 static int handle(const char *name, umode_t mode, kuid_t uid, kgid_t gid,
374 return handle_create(name, mode, uid, gid, dev);
376 return handle_remove(name, dev);
379 static int devtmpfsd(void *p)
381 char options[] = "mode=0755";
383 *err = ksys_unshare(CLONE_NEWNS);
386 *err = ksys_mount("devtmpfs", "/", "devtmpfs", MS_SILENT, options);
389 ksys_chdir("/.."); /* will traverse into overmounted root */
391 complete(&setup_done);
393 spin_lock(&req_lock);
395 struct req *req = requests;
397 spin_unlock(&req_lock);
399 struct req *next = req->next;
400 req->err = handle(req->name, req->mode,
401 req->uid, req->gid, req->dev);
402 complete(&req->done);
405 spin_lock(&req_lock);
407 __set_current_state(TASK_INTERRUPTIBLE);
408 spin_unlock(&req_lock);
413 complete(&setup_done);
418 * Create devtmpfs instance, driver-core devices will add their device
421 int __init devtmpfs_init(void)
423 int err = register_filesystem(&dev_fs_type);
425 printk(KERN_ERR "devtmpfs: unable to register devtmpfs "
430 thread = kthread_run(devtmpfsd, &err, "kdevtmpfs");
431 if (!IS_ERR(thread)) {
432 wait_for_completion(&setup_done);
434 err = PTR_ERR(thread);
439 printk(KERN_ERR "devtmpfs: unable to create devtmpfs %i\n", err);
440 unregister_filesystem(&dev_fs_type);
444 printk(KERN_INFO "devtmpfs: initialized\n");