2 * Copyright (c) 2009 The DragonFly Project. All rights reserved.
4 * This code is derived from software contributed to The DragonFly Project
5 * by Alex Hornung <ahornung@gmail.com>
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in
15 * the documentation and/or other materials provided with the
17 * 3. Neither the name of The DragonFly Project nor the names of its
18 * contributors may be used to endorse or promote products derived
19 * from this software without specific, prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
24 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
25 * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
26 * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
27 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
28 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
29 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
31 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 #include <sys/param.h>
35 #include <sys/systm.h>
36 #include <sys/kernel.h>
38 #include <sys/mount.h>
39 #include <sys/vnode.h>
40 #include <sys/types.h>
43 #include <sys/msgport.h>
44 #include <sys/sysctl.h>
45 #include <sys/ucred.h>
46 #include <sys/devfs.h>
47 #include <sys/devfs_rules.h>
50 #include <sys/msgport2.h>
51 #include <sys/spinlock2.h>
52 #include <sys/sysref2.h>
54 MALLOC_DEFINE(M_DEVFS, "devfs", "Device File System (devfs) allocations");
55 DEVFS_DEFINE_CLONE_BITMAP(ops_id);
57 * SYSREF Integration - reference counting, allocation,
58 * sysid and syslink integration.
60 static void devfs_cdev_terminate(cdev_t dev);
61 static void devfs_cdev_lock(cdev_t dev);
62 static void devfs_cdev_unlock(cdev_t dev);
63 static struct sysref_class cdev_sysref_class = {
66 .proto = SYSREF_PROTO_DEV,
67 .offset = offsetof(struct cdev, si_sysref),
68 .objsize = sizeof(struct cdev),
72 .terminate = (sysref_terminate_func_t)devfs_cdev_terminate,
73 .lock = (sysref_lock_func_t)devfs_cdev_lock,
74 .unlock = (sysref_unlock_func_t)devfs_cdev_unlock
78 static struct objcache *devfs_node_cache;
79 static struct objcache *devfs_msg_cache;
80 static struct objcache *devfs_dev_cache;
82 static struct objcache_malloc_args devfs_node_malloc_args = {
83 sizeof(struct devfs_node), M_DEVFS };
84 struct objcache_malloc_args devfs_msg_malloc_args = {
85 sizeof(struct devfs_msg), M_DEVFS };
86 struct objcache_malloc_args devfs_dev_malloc_args = {
87 sizeof(struct cdev), M_DEVFS };
89 static struct devfs_dev_head devfs_dev_list =
90 TAILQ_HEAD_INITIALIZER(devfs_dev_list);
91 static struct devfs_mnt_head devfs_mnt_list =
92 TAILQ_HEAD_INITIALIZER(devfs_mnt_list);
93 static struct devfs_chandler_head devfs_chandler_list =
94 TAILQ_HEAD_INITIALIZER(devfs_chandler_list);
95 static struct devfs_alias_head devfs_alias_list =
96 TAILQ_HEAD_INITIALIZER(devfs_alias_list);
97 static struct devfs_dev_ops_head devfs_dev_ops_list =
98 TAILQ_HEAD_INITIALIZER(devfs_dev_ops_list);
100 struct lock devfs_lock;
101 struct lwkt_token devfs_token;
102 static struct lwkt_port devfs_dispose_port;
103 static struct lwkt_port devfs_msg_port;
104 static struct thread *td_core;
106 static struct spinlock ino_lock;
108 static int devfs_debug_enable;
109 static int devfs_run;
111 static ino_t devfs_fetch_ino(void);
112 static int devfs_create_all_dev_worker(struct devfs_node *);
113 static int devfs_create_dev_worker(cdev_t, uid_t, gid_t, int);
114 static int devfs_destroy_dev_worker(cdev_t);
115 static int devfs_destroy_related_worker(cdev_t);
116 static int devfs_destroy_dev_by_ops_worker(struct dev_ops *, int);
117 static int devfs_propagate_dev(cdev_t, int);
118 static int devfs_unlink_dev(cdev_t dev);
119 static void devfs_msg_exec(devfs_msg_t msg);
121 static int devfs_chandler_add_worker(const char *, d_clone_t *);
122 static int devfs_chandler_del_worker(const char *);
124 static void devfs_msg_autofree_reply(lwkt_port_t, lwkt_msg_t);
125 static void devfs_msg_core(void *);
127 static int devfs_find_device_by_name_worker(devfs_msg_t);
128 static int devfs_find_device_by_udev_worker(devfs_msg_t);
130 static int devfs_apply_reset_rules_caller(char *, int);
132 static int devfs_scan_callback_worker(devfs_scan_t *, void *);
134 static struct devfs_node *devfs_resolve_or_create_dir(struct devfs_node *,
135 char *, size_t, int);
137 static int devfs_make_alias_worker(struct devfs_alias *);
138 static int devfs_destroy_alias_worker(struct devfs_alias *);
139 static int devfs_alias_remove(cdev_t);
140 static int devfs_alias_reap(void);
141 static int devfs_alias_propagate(struct devfs_alias *, int);
142 static int devfs_alias_apply(struct devfs_node *, struct devfs_alias *);
143 static int devfs_alias_check_create(struct devfs_node *);
145 static int devfs_clr_related_flag_worker(cdev_t, uint32_t);
146 static int devfs_destroy_related_without_flag_worker(cdev_t, uint32_t);
148 static void *devfs_reaperp_callback(struct devfs_node *, void *);
149 static void *devfs_gc_dirs_callback(struct devfs_node *, void *);
150 static void *devfs_gc_links_callback(struct devfs_node *, struct devfs_node *);
152 devfs_inode_to_vnode_worker_callback(struct devfs_node *, ino_t *);
155 * devfs_debug() is a SYSCTL and TUNABLE controlled debug output function
159 devfs_debug(int level, char *fmt, ...)
164 if (level <= devfs_debug_enable)
172 * devfs_allocp() Allocates a new devfs node with the specified
173 * parameters. The node is also automatically linked into the topology
174 * if a parent is specified. It also calls the rule and alias stuff to
175 * be applied on the new node
178 devfs_allocp(devfs_nodetype devfsnodetype, char *name,
179 struct devfs_node *parent, struct mount *mp, cdev_t dev)
181 struct devfs_node *node = NULL;
182 size_t namlen = strlen(name);
184 node = objcache_get(devfs_node_cache, M_WAITOK);
185 bzero(node, sizeof(*node));
187 atomic_add_long(&DEVFS_MNTDATA(mp)->leak_count, 1);
192 node->d_dir.d_ino = devfs_fetch_ino();
195 * Cookie jar for children. Leave 0 and 1 for '.' and '..' entries
198 node->cookie_jar = 2;
201 * Access Control members
203 node->mode = DEVFS_DEFAULT_MODE;
204 node->uid = DEVFS_DEFAULT_UID;
205 node->gid = DEVFS_DEFAULT_GID;
207 switch (devfsnodetype) {
210 * Ensure that we don't recycle the root vnode by marking it as
211 * linked into the topology.
213 node->flags |= DEVFS_NODE_LINKED;
215 TAILQ_INIT(DEVFS_DENODE_HEAD(node));
216 node->d_dir.d_type = DT_DIR;
221 node->d_dir.d_type = DT_LNK;
225 node->d_dir.d_type = DT_REG;
230 node->d_dir.d_type = DT_CHR;
233 node->mode = dev->si_perms;
234 node->uid = dev->si_uid;
235 node->gid = dev->si_gid;
237 devfs_alias_check_create(node);
242 panic("devfs_allocp: unknown node type");
246 node->node_type = devfsnodetype;
248 /* Initialize the dirent structure of each devfs vnode */
249 node->d_dir.d_namlen = namlen;
250 node->d_dir.d_name = kmalloc(namlen+1, M_DEVFS, M_WAITOK);
251 memcpy(node->d_dir.d_name, name, namlen);
252 node->d_dir.d_name[namlen] = '\0';
254 /* Initialize the parent node element */
255 node->parent = parent;
257 /* Initialize *time members */
258 nanotime(&node->atime);
259 node->mtime = node->ctime = node->atime;
262 * Associate with parent as last step, clean out namecache
265 if ((parent != NULL) &&
266 ((parent->node_type == Nroot) || (parent->node_type == Ndir))) {
268 node->cookie = parent->cookie_jar++;
269 node->flags |= DEVFS_NODE_LINKED;
270 TAILQ_INSERT_TAIL(DEVFS_DENODE_HEAD(parent), node, link);
272 /* This forces negative namecache lookups to clear */
273 ++mp->mnt_namecache_gen;
277 * Apply rules (requires root node, skip if we are creating the root node)
279 if (DEVFS_MNTDATA(mp)->root_node)
280 devfs_rule_check_apply(node, NULL);
282 atomic_add_long(&DEVFS_MNTDATA(mp)->file_count, 1);
288 * devfs_allocv() allocates a new vnode based on a devfs node.
291 devfs_allocv(struct vnode **vpp, struct devfs_node *node)
299 * devfs master lock must not be held across a vget() call, we have
300 * to hold our ad-hoc vp to avoid a free race from destroying the
301 * contents of the structure. The vget() will interlock recycles
305 while ((vp = node->v_node) != NULL) {
307 lockmgr(&devfs_lock, LK_RELEASE);
308 error = vget(vp, LK_EXCLUSIVE);
310 lockmgr(&devfs_lock, LK_EXCLUSIVE);
315 if (error != ENOENT) {
322 * devfs master lock must not be held across a getnewvnode() call.
324 lockmgr(&devfs_lock, LK_RELEASE);
325 if ((error = getnewvnode(VT_DEVFS, node->mp, vpp, 0, 0)) != 0) {
326 lockmgr(&devfs_lock, LK_EXCLUSIVE);
329 lockmgr(&devfs_lock, LK_EXCLUSIVE);
333 if (node->v_node != NULL) {
342 switch (node->node_type) {
344 vsetflags(vp, VROOT);
360 KKASSERT(node->d_dev);
362 vp->v_uminor = node->d_dev->si_uminor;
363 vp->v_umajor = node->d_dev->si_umajor;
365 v_associate_rdev(vp, node->d_dev);
366 vp->v_ops = &node->mp->mnt_vn_spec_ops;
367 if (node->d_dev->si_ops->head.flags & D_KVABIO)
368 vsetflags(vp, VKVABIO);
372 panic("devfs_allocv: unknown node type");
380 * devfs_allocvp allocates both a devfs node (with the given settings) and a vnode
381 * based on the newly created devfs node.
384 devfs_allocvp(struct mount *mp, struct vnode **vpp, devfs_nodetype devfsnodetype,
385 char *name, struct devfs_node *parent, cdev_t dev)
387 struct devfs_node *node;
389 node = devfs_allocp(devfsnodetype, name, parent, mp, dev);
392 devfs_allocv(vpp, node);
400 * Destroy the devfs_node. The node must be unlinked from the topology.
402 * This function will also destroy any vnode association with the node
405 * The cdev_t itself remains intact.
407 * The core lock is not necessarily held on call and must be temporarily
408 * released if it is to avoid a deadlock.
411 devfs_freep(struct devfs_node *node)
417 KKASSERT(((node->flags & DEVFS_NODE_LINKED) == 0) ||
418 (node->node_type == Nroot));
421 * Protect against double frees
423 KKASSERT((node->flags & DEVFS_DESTROYED) == 0);
424 node->flags |= DEVFS_DESTROYED;
427 * Avoid deadlocks between devfs_lock and the vnode lock when
428 * disassociating the vnode (stress2 pty vs ls -la /dev/pts).
430 * This also prevents the vnode reclaim code from double-freeing
431 * the node. The vget() is required to safely modified the vp
432 * and cycle the refs to terminate an inactive vp.
434 if (lockstatus(&devfs_lock, curthread) == LK_EXCLUSIVE) {
435 lockmgr(&devfs_lock, LK_RELEASE);
441 while ((vp = node->v_node) != NULL) {
442 if (vget(vp, LK_EXCLUSIVE | LK_RETRY) != 0)
453 atomic_subtract_long(&DEVFS_MNTDATA(node->mp)->leak_count, 1);
454 if (node->symlink_name) {
455 kfree(node->symlink_name, M_DEVFS);
456 node->symlink_name = NULL;
460 * Remove the node from the orphan list if it is still on it.
462 if (node->flags & DEVFS_ORPHANED)
463 devfs_tracer_del_orphan(node);
465 if (node->d_dir.d_name) {
466 kfree(node->d_dir.d_name, M_DEVFS);
467 node->d_dir.d_name = NULL;
469 atomic_subtract_long(&DEVFS_MNTDATA(node->mp)->file_count, 1);
470 objcache_put(devfs_node_cache, node);
473 lockmgr(&devfs_lock, LK_EXCLUSIVE);
479 * Returns a valid vp associated with the devfs alias node or NULL
481 static void *devfs_alias_getvp(struct devfs_node *node)
483 struct devfs_node *found = node;
486 while ((found->node_type == Nlink) && (found->link_target)) {
488 devfs_debug(DEVFS_DEBUG_SHOW, "Recursive link or depth >= 8");
492 found = found->link_target;
496 return found->v_node;
500 * Unlink the devfs node from the topology and add it to the orphan list.
501 * The node will later be destroyed by freep.
503 * Any vnode association, including the v_rdev and v_data, remains intact
507 devfs_unlinkp(struct devfs_node *node)
510 struct devfs_node *parent;
514 * Add the node to the orphan list, so it is referenced somewhere, to
515 * so we don't leak it.
517 devfs_tracer_add_orphan(node);
519 parent = node->parent;
522 * If the parent is known we can unlink the node out of the topology
525 TAILQ_REMOVE(DEVFS_DENODE_HEAD(parent), node, link);
527 node->flags &= ~DEVFS_NODE_LINKED;
533 * Namecache invalidation.
534 * devfs alias nodes are special: their v_node entry is always null
535 * and they use the one from their link target.
536 * We thus use the target node's vp to invalidate both alias and target
537 * entries in the namecache.
538 * Doing so for the target is not necessary but it would be more
539 * expensive to resolve only the namecache entry of the alias node
540 * from the information available in this function.
542 if (node->node_type == Nlink)
543 vp = devfs_alias_getvp(node);
548 cache_inval_vp(vp, CINV_DESTROY);
554 devfs_iterate_topology(struct devfs_node *node,
555 devfs_iterate_callback_t *callback, void *arg1)
557 struct devfs_node *node1, *node2;
560 if ((node->node_type == Nroot) || (node->node_type == Ndir)) {
561 if (node->nchildren > 2) {
562 TAILQ_FOREACH_MUTABLE(node1, DEVFS_DENODE_HEAD(node),
564 if ((ret = devfs_iterate_topology(node1, callback, arg1)))
570 ret = callback(node, arg1);
575 devfs_alias_reaper_callback(struct devfs_node *node, void *unused)
577 if (node->node_type == Nlink) {
586 * devfs_reaperp() is a recursive function that iterates through all the
587 * topology, unlinking and freeing all devfs nodes.
590 devfs_reaperp_callback(struct devfs_node *node, void *unused)
599 devfs_gc_dirs_callback(struct devfs_node *node, void *unused)
601 if (node->node_type == Ndir) {
602 if ((node->nchildren == 2) &&
603 !(node->flags & DEVFS_USER_CREATED)) {
613 devfs_gc_links_callback(struct devfs_node *node, struct devfs_node *target)
615 if ((node->node_type == Nlink) && (node->link_target == target)) {
624 * devfs_gc() is devfs garbage collector. It takes care of unlinking and
625 * freeing a node, but also removes empty directories and links that link
626 * via devfs auto-link mechanism to the node being deleted.
629 devfs_gc(struct devfs_node *node)
631 struct devfs_node *root_node = DEVFS_MNTDATA(node->mp)->root_node;
633 if (node->nlinks > 0)
634 devfs_iterate_topology(root_node,
635 (devfs_iterate_callback_t *)devfs_gc_links_callback, node);
638 devfs_iterate_topology(root_node,
639 (devfs_iterate_callback_t *)devfs_gc_dirs_callback, NULL);
647 * devfs_create_dev() is the asynchronous entry point for device creation.
648 * It just sends a message with the relevant details to the devfs core.
650 * This function will reference the passed device. The reference is owned
651 * by devfs and represents all of the device's node associations.
654 devfs_create_dev(cdev_t dev, uid_t uid, gid_t gid, int perms)
657 devfs_msg_send_dev(DEVFS_DEVICE_CREATE, dev, uid, gid, perms);
663 * devfs_destroy_dev() is the asynchronous entry point for device destruction.
664 * It just sends a message with the relevant details to the devfs core.
667 devfs_destroy_dev(cdev_t dev)
669 devfs_msg_send_dev(DEVFS_DEVICE_DESTROY, dev, 0, 0, 0);
674 * devfs_mount_add() is the synchronous entry point for adding a new devfs
675 * mount. It sends a synchronous message with the relevant details to the
679 devfs_mount_add(struct devfs_mnt_data *mnt)
683 msg = devfs_msg_get();
685 devfs_msg_send_sync(DEVFS_MOUNT_ADD, msg);
692 * devfs_mount_del() is the synchronous entry point for removing a devfs mount.
693 * It sends a synchronous message with the relevant details to the devfs core.
696 devfs_mount_del(struct devfs_mnt_data *mnt)
700 msg = devfs_msg_get();
702 devfs_msg_send_sync(DEVFS_MOUNT_DEL, msg);
709 * devfs_destroy_related() is the synchronous entry point for device
710 * destruction by subname. It just sends a message with the relevant details to
714 devfs_destroy_related(cdev_t dev)
718 msg = devfs_msg_get();
720 devfs_msg_send_sync(DEVFS_DESTROY_RELATED, msg);
726 devfs_clr_related_flag(cdev_t dev, uint32_t flag)
730 msg = devfs_msg_get();
731 msg->mdv_flags.dev = dev;
732 msg->mdv_flags.flag = flag;
733 devfs_msg_send_sync(DEVFS_CLR_RELATED_FLAG, msg);
740 devfs_destroy_related_without_flag(cdev_t dev, uint32_t flag)
744 msg = devfs_msg_get();
745 msg->mdv_flags.dev = dev;
746 msg->mdv_flags.flag = flag;
747 devfs_msg_send_sync(DEVFS_DESTROY_RELATED_WO_FLAG, msg);
754 * devfs_create_all_dev is the asynchronous entry point to trigger device
755 * node creation. It just sends a message with the relevant details to
759 devfs_create_all_dev(struct devfs_node *root)
761 devfs_msg_send_generic(DEVFS_CREATE_ALL_DEV, root);
766 * devfs_destroy_dev_by_ops is the asynchronous entry point to destroy all
767 * devices with a specific set of dev_ops and minor. It just sends a
768 * message with the relevant details to the devfs core.
771 devfs_destroy_dev_by_ops(struct dev_ops *ops, int minor)
773 devfs_msg_send_ops(DEVFS_DESTROY_DEV_BY_OPS, ops, minor);
778 * devfs_clone_handler_add is the synchronous entry point to add a new
779 * clone handler. It just sends a message with the relevant details to
783 devfs_clone_handler_add(const char *name, d_clone_t *nhandler)
787 msg = devfs_msg_get();
788 msg->mdv_chandler.name = name;
789 msg->mdv_chandler.nhandler = nhandler;
790 devfs_msg_send_sync(DEVFS_CHANDLER_ADD, msg);
796 * devfs_clone_handler_del is the synchronous entry point to remove a
797 * clone handler. It just sends a message with the relevant details to
801 devfs_clone_handler_del(const char *name)
805 msg = devfs_msg_get();
806 msg->mdv_chandler.name = name;
807 msg->mdv_chandler.nhandler = NULL;
808 devfs_msg_send_sync(DEVFS_CHANDLER_DEL, msg);
814 * devfs_find_device_by_name is the synchronous entry point to find a
815 * device given its name. It sends a synchronous message with the
816 * relevant details to the devfs core and returns the answer.
819 devfs_find_device_by_name(const char *fmt, ...)
830 kvasnrprintf(&target, PATH_MAX, 10, fmt, ap);
833 msg = devfs_msg_get();
834 msg->mdv_name = target;
835 devfs_msg_send_sync(DEVFS_FIND_DEVICE_BY_NAME, msg);
836 found = msg->mdv_cdev;
844 * devfs_find_device_by_udev is the synchronous entry point to find a
845 * device given its udev number. It sends a synchronous message with
846 * the relevant details to the devfs core and returns the answer.
849 devfs_find_device_by_udev(udev_t udev)
854 msg = devfs_msg_get();
855 msg->mdv_udev = udev;
856 devfs_msg_send_sync(DEVFS_FIND_DEVICE_BY_UDEV, msg);
857 found = msg->mdv_cdev;
860 devfs_debug(DEVFS_DEBUG_DEBUG,
861 "devfs_find_device_by_udev found? %s -end:3-\n",
862 ((found) ? found->si_name:"NO"));
867 devfs_inode_to_vnode(struct mount *mp, ino_t target)
869 struct vnode *vp = NULL;
875 msg = devfs_msg_get();
876 msg->mdv_ino.mp = mp;
877 msg->mdv_ino.ino = target;
878 devfs_msg_send_sync(DEVFS_INODE_TO_VNODE, msg);
879 vp = msg->mdv_ino.vp;
880 vn_lock(vp, LK_EXCLUSIVE | LK_RETRY);
887 * devfs_make_alias is the asynchronous entry point to register an alias
888 * for a device. It just sends a message with the relevant details to the
892 devfs_make_alias(const char *name, cdev_t dev_target)
894 struct devfs_alias *alias;
899 alias = kmalloc(sizeof(struct devfs_alias), M_DEVFS, M_WAITOK);
900 alias->name = kstrdup(name, M_DEVFS);
902 alias->dev_target = dev_target;
904 devfs_msg_send_generic(DEVFS_MAKE_ALIAS, alias);
909 * devfs_destroy_alias is the asynchronous entry point to deregister an alias
910 * for a device. It just sends a message with the relevant details to the
914 devfs_destroy_alias(const char *name, cdev_t dev_target)
916 struct devfs_alias *alias;
921 alias = kmalloc(sizeof(struct devfs_alias), M_DEVFS, M_WAITOK);
922 alias->name = kstrdup(name, M_DEVFS);
924 alias->dev_target = dev_target;
926 devfs_msg_send_generic(DEVFS_DESTROY_ALIAS, alias);
931 * devfs_apply_rules is the asynchronous entry point to trigger application
932 * of all rules. It just sends a message with the relevant details to the
936 devfs_apply_rules(char *mntto)
940 new_name = kstrdup(mntto, M_DEVFS);
941 devfs_msg_send_name(DEVFS_APPLY_RULES, new_name);
947 * devfs_reset_rules is the asynchronous entry point to trigger reset of all
948 * rules. It just sends a message with the relevant details to the devfs core.
951 devfs_reset_rules(char *mntto)
955 new_name = kstrdup(mntto, M_DEVFS);
956 devfs_msg_send_name(DEVFS_RESET_RULES, new_name);
963 * devfs_scan_callback is the asynchronous entry point to call a callback
965 * It just sends a message with the relevant details to the devfs core.
968 devfs_scan_callback(devfs_scan_t *callback, void *arg)
974 msg = devfs_msg_get();
975 msg->mdv_load = callback;
976 msg->mdv_load2 = arg;
977 devfs_msg_send_sync(DEVFS_SCAN_CALLBACK, msg);
985 * Acts as a message drain. Any message that is replied to here gets destroyed
986 * and the memory freed.
989 devfs_msg_autofree_reply(lwkt_port_t port, lwkt_msg_t msg)
991 devfs_msg_put((devfs_msg_t)msg);
995 * devfs_msg_get allocates a new devfs msg and returns it.
1000 return objcache_get(devfs_msg_cache, M_WAITOK);
1004 * devfs_msg_put deallocates a given devfs msg.
1007 devfs_msg_put(devfs_msg_t msg)
1009 objcache_put(devfs_msg_cache, msg);
1014 * devfs_msg_send is the generic asynchronous message sending facility
1015 * for devfs. By default the reply port is the automatic disposal port.
1017 * If the current thread is the devfs_msg_port thread we execute the
1018 * operation synchronously.
1021 devfs_msg_send(uint32_t cmd, devfs_msg_t devfs_msg)
1023 lwkt_port_t port = &devfs_msg_port;
1025 lwkt_initmsg(&devfs_msg->hdr, &devfs_dispose_port, 0);
1027 devfs_msg->hdr.u.ms_result = cmd;
1029 if (port->mpu_td == curthread) {
1030 devfs_msg_exec(devfs_msg);
1031 lwkt_replymsg(&devfs_msg->hdr, 0);
1033 lwkt_sendmsg(port, (lwkt_msg_t)devfs_msg);
1038 * devfs_msg_send_sync is the generic synchronous message sending
1039 * facility for devfs. It initializes a local reply port and waits
1040 * for the core's answer. The core will write the answer on the same
1041 * message which is sent back as reply. The caller still has a reference
1042 * to the message, so we don't need to return it.
1045 devfs_msg_send_sync(uint32_t cmd, devfs_msg_t devfs_msg)
1047 struct lwkt_port rep_port;
1049 lwkt_port_t port = &devfs_msg_port;
1051 lwkt_initport_thread(&rep_port, curthread);
1052 lwkt_initmsg(&devfs_msg->hdr, &rep_port, 0);
1054 devfs_msg->hdr.u.ms_result = cmd;
1056 error = lwkt_domsg(port, (lwkt_msg_t)devfs_msg, 0);
1062 * sends a message with a generic argument.
1065 devfs_msg_send_generic(uint32_t cmd, void *load)
1067 devfs_msg_t devfs_msg = devfs_msg_get();
1069 devfs_msg->mdv_load = load;
1070 devfs_msg_send(cmd, devfs_msg);
1074 * sends a message with a name argument.
1077 devfs_msg_send_name(uint32_t cmd, char *name)
1079 devfs_msg_t devfs_msg = devfs_msg_get();
1081 devfs_msg->mdv_name = name;
1082 devfs_msg_send(cmd, devfs_msg);
1086 * sends a message with a mount argument.
1089 devfs_msg_send_mount(uint32_t cmd, struct devfs_mnt_data *mnt)
1091 devfs_msg_t devfs_msg = devfs_msg_get();
1093 devfs_msg->mdv_mnt = mnt;
1094 devfs_msg_send(cmd, devfs_msg);
1098 * sends a message with an ops argument.
1101 devfs_msg_send_ops(uint32_t cmd, struct dev_ops *ops, int minor)
1103 devfs_msg_t devfs_msg = devfs_msg_get();
1105 devfs_msg->mdv_ops.ops = ops;
1106 devfs_msg->mdv_ops.minor = minor;
1107 devfs_msg_send(cmd, devfs_msg);
1111 * sends a message with a clone handler argument.
1114 devfs_msg_send_chandler(uint32_t cmd, char *name, d_clone_t handler)
1116 devfs_msg_t devfs_msg = devfs_msg_get();
1118 devfs_msg->mdv_chandler.name = name;
1119 devfs_msg->mdv_chandler.nhandler = handler;
1120 devfs_msg_send(cmd, devfs_msg);
1124 * sends a message with a device argument.
1127 devfs_msg_send_dev(uint32_t cmd, cdev_t dev, uid_t uid, gid_t gid, int perms)
1129 devfs_msg_t devfs_msg = devfs_msg_get();
1131 devfs_msg->mdv_dev.dev = dev;
1132 devfs_msg->mdv_dev.uid = uid;
1133 devfs_msg->mdv_dev.gid = gid;
1134 devfs_msg->mdv_dev.perms = perms;
1136 devfs_msg_send(cmd, devfs_msg);
1140 * sends a message with a link argument.
1143 devfs_msg_send_link(uint32_t cmd, char *name, char *target, struct mount *mp)
1145 devfs_msg_t devfs_msg = devfs_msg_get();
1147 devfs_msg->mdv_link.name = name;
1148 devfs_msg->mdv_link.target = target;
1149 devfs_msg->mdv_link.mp = mp;
1150 devfs_msg_send(cmd, devfs_msg);
1154 * devfs_msg_core is the main devfs thread. It handles all incoming messages
1155 * and calls the relevant worker functions. By using messages it's assured
1156 * that events occur in the correct order.
1159 devfs_msg_core(void *arg)
1163 lwkt_initport_thread(&devfs_msg_port, curthread);
1165 lockmgr(&devfs_lock, LK_EXCLUSIVE);
1168 lockmgr(&devfs_lock, LK_RELEASE);
1170 lwkt_gettoken(&devfs_token);
1173 msg = (devfs_msg_t)lwkt_waitport(&devfs_msg_port, 0);
1174 devfs_debug(DEVFS_DEBUG_DEBUG,
1175 "devfs_msg_core, new msg: %x\n",
1176 (unsigned int)msg->hdr.u.ms_result);
1177 devfs_msg_exec(msg);
1178 lwkt_replymsg(&msg->hdr, 0);
1181 lwkt_reltoken(&devfs_token);
1188 devfs_msg_exec(devfs_msg_t msg)
1190 struct devfs_mnt_data *mnt;
1191 struct devfs_node *node;
1195 * Acquire the devfs lock to ensure safety of all called functions
1197 lockmgr(&devfs_lock, LK_EXCLUSIVE);
1199 switch (msg->hdr.u.ms_result) {
1200 case DEVFS_DEVICE_CREATE:
1201 dev = msg->mdv_dev.dev;
1202 devfs_create_dev_worker(dev,
1205 msg->mdv_dev.perms);
1207 case DEVFS_DEVICE_DESTROY:
1208 dev = msg->mdv_dev.dev;
1209 devfs_destroy_dev_worker(dev);
1211 case DEVFS_DESTROY_RELATED:
1212 devfs_destroy_related_worker(msg->mdv_load);
1214 case DEVFS_DESTROY_DEV_BY_OPS:
1215 devfs_destroy_dev_by_ops_worker(msg->mdv_ops.ops,
1216 msg->mdv_ops.minor);
1218 case DEVFS_CREATE_ALL_DEV:
1219 node = (struct devfs_node *)msg->mdv_load;
1220 devfs_create_all_dev_worker(node);
1222 case DEVFS_MOUNT_ADD:
1224 TAILQ_INSERT_TAIL(&devfs_mnt_list, mnt, link);
1225 devfs_create_all_dev_worker(mnt->root_node);
1227 case DEVFS_MOUNT_DEL:
1229 TAILQ_REMOVE(&devfs_mnt_list, mnt, link);
1230 /* Be sure to remove all the aliases first */
1231 devfs_iterate_topology(mnt->root_node, devfs_alias_reaper_callback,
1233 devfs_iterate_topology(mnt->root_node, devfs_reaperp_callback,
1235 if (mnt->leak_count) {
1236 devfs_debug(DEVFS_DEBUG_SHOW,
1237 "Leaked %ld devfs_node elements!\n",
1241 case DEVFS_CHANDLER_ADD:
1242 devfs_chandler_add_worker(msg->mdv_chandler.name,
1243 msg->mdv_chandler.nhandler);
1245 case DEVFS_CHANDLER_DEL:
1246 devfs_chandler_del_worker(msg->mdv_chandler.name);
1248 case DEVFS_FIND_DEVICE_BY_NAME:
1249 devfs_find_device_by_name_worker(msg);
1251 case DEVFS_FIND_DEVICE_BY_UDEV:
1252 devfs_find_device_by_udev_worker(msg);
1254 case DEVFS_MAKE_ALIAS:
1255 devfs_make_alias_worker((struct devfs_alias *)msg->mdv_load);
1257 case DEVFS_DESTROY_ALIAS:
1258 devfs_destroy_alias_worker((struct devfs_alias *)msg->mdv_load);
1260 case DEVFS_APPLY_RULES:
1261 devfs_apply_reset_rules_caller(msg->mdv_name, 1);
1263 case DEVFS_RESET_RULES:
1264 devfs_apply_reset_rules_caller(msg->mdv_name, 0);
1266 case DEVFS_SCAN_CALLBACK:
1267 devfs_scan_callback_worker((devfs_scan_t *)msg->mdv_load,
1270 case DEVFS_CLR_RELATED_FLAG:
1271 devfs_clr_related_flag_worker(msg->mdv_flags.dev,
1272 msg->mdv_flags.flag);
1274 case DEVFS_DESTROY_RELATED_WO_FLAG:
1275 devfs_destroy_related_without_flag_worker(msg->mdv_flags.dev,
1276 msg->mdv_flags.flag);
1278 case DEVFS_INODE_TO_VNODE:
1279 msg->mdv_ino.vp = devfs_iterate_topology(
1280 DEVFS_MNTDATA(msg->mdv_ino.mp)->root_node,
1281 (devfs_iterate_callback_t *)devfs_inode_to_vnode_worker_callback,
1284 case DEVFS_TERMINATE_CORE:
1290 devfs_debug(DEVFS_DEBUG_WARNING,
1291 "devfs_msg_core: unknown message "
1292 "received at core\n");
1295 lockmgr(&devfs_lock, LK_RELEASE);
1299 devfs_devctl_notify(cdev_t dev, const char *ev)
1301 static const char prefix[] = "cdev=";
1305 namelen = strlen(dev->si_name);
1306 data = kmalloc(namelen + sizeof(prefix), M_TEMP, M_WAITOK);
1307 memcpy(data, prefix, sizeof(prefix) - 1);
1308 memcpy(data + sizeof(prefix) - 1, dev->si_name, namelen + 1);
1309 devctl_notify("DEVFS", "CDEV", ev, data);
1310 kfree(data, M_TEMP);
1314 * Worker function to insert a new dev into the dev list and initialize its
1315 * permissions. It also calls devfs_propagate_dev which in turn propagates
1316 * the change to all mount points.
1318 * The passed dev is already referenced. This reference is eaten by this
1319 * function and represents the dev's linkage into devfs_dev_list.
1322 devfs_create_dev_worker(cdev_t dev, uid_t uid, gid_t gid, int perms)
1328 dev->si_perms = perms;
1330 devfs_link_dev(dev);
1331 devfs_propagate_dev(dev, 1);
1333 udev_event_attach(dev, NULL, 0);
1334 devfs_devctl_notify(dev, "CREATE");
1340 * Worker function to delete a dev from the dev list and free the cdev.
1341 * It also calls devfs_propagate_dev which in turn propagates the change
1342 * to all mount points.
1345 devfs_destroy_dev_worker(cdev_t dev)
1350 KKASSERT((lockstatus(&devfs_lock, curthread)) == LK_EXCLUSIVE);
1352 error = devfs_unlink_dev(dev);
1353 devfs_propagate_dev(dev, 0);
1355 devfs_devctl_notify(dev, "DESTROY");
1356 udev_event_detach(dev, NULL, 0);
1359 release_dev(dev); /* link ref */
1367 * Worker function to destroy all devices with a certain basename.
1368 * Calls devfs_destroy_dev_worker for the actual destruction.
1371 devfs_destroy_related_worker(cdev_t needle)
1376 devfs_debug(DEVFS_DEBUG_DEBUG, "related worker: %s\n",
1378 TAILQ_FOREACH(dev, &devfs_dev_list, link) {
1379 if (dev->si_parent == needle) {
1380 devfs_destroy_related_worker(dev);
1381 devfs_destroy_dev_worker(dev);
1389 devfs_clr_related_flag_worker(cdev_t needle, uint32_t flag)
1393 TAILQ_FOREACH_MUTABLE(dev, &devfs_dev_list, link, dev1) {
1394 if (dev->si_parent == needle) {
1395 devfs_clr_related_flag_worker(dev, flag);
1396 dev->si_flags &= ~flag;
1404 devfs_destroy_related_without_flag_worker(cdev_t needle, uint32_t flag)
1409 devfs_debug(DEVFS_DEBUG_DEBUG, "related_wo_flag: %s\n",
1412 TAILQ_FOREACH(dev, &devfs_dev_list, link) {
1413 if (dev->si_parent == needle) {
1414 devfs_destroy_related_without_flag_worker(dev, flag);
1415 if (!(dev->si_flags & flag)) {
1416 devfs_destroy_dev_worker(dev);
1417 devfs_debug(DEVFS_DEBUG_DEBUG,
1418 "related_wo_flag: %s restart\n", dev->si_name);
1428 * Worker function that creates all device nodes on top of a devfs
1432 devfs_create_all_dev_worker(struct devfs_node *root)
1438 TAILQ_FOREACH(dev, &devfs_dev_list, link) {
1439 devfs_create_device_node(root, dev, NULL, NULL, NULL);
1446 * Worker function that destroys all devices that match a specific
1447 * dev_ops and/or minor. If minor is less than 0, it is not matched
1448 * against. It also propagates all changes.
1451 devfs_destroy_dev_by_ops_worker(struct dev_ops *ops, int minor)
1457 TAILQ_FOREACH_MUTABLE(dev, &devfs_dev_list, link, dev1) {
1458 if (dev->si_ops != ops)
1460 if ((minor < 0) || (dev->si_uminor == minor)) {
1461 devfs_destroy_dev_worker(dev);
1469 * Worker function that registers a new clone handler in devfs.
1472 devfs_chandler_add_worker(const char *name, d_clone_t *nhandler)
1474 struct devfs_clone_handler *chandler = NULL;
1475 u_char len = strlen(name);
1480 TAILQ_FOREACH(chandler, &devfs_chandler_list, link) {
1481 if (chandler->namlen != len)
1484 if (!memcmp(chandler->name, name, len)) {
1485 /* Clonable basename already exists */
1490 chandler = kmalloc(sizeof(*chandler), M_DEVFS, M_WAITOK | M_ZERO);
1491 chandler->name = kstrdup(name, M_DEVFS);
1492 chandler->namlen = len;
1493 chandler->nhandler = nhandler;
1495 TAILQ_INSERT_TAIL(&devfs_chandler_list, chandler, link);
1500 * Worker function that removes a given clone handler from the
1501 * clone handler list.
1504 devfs_chandler_del_worker(const char *name)
1506 struct devfs_clone_handler *chandler, *chandler2;
1507 u_char len = strlen(name);
1512 TAILQ_FOREACH_MUTABLE(chandler, &devfs_chandler_list, link, chandler2) {
1513 if (chandler->namlen != len)
1515 if (memcmp(chandler->name, name, len))
1518 TAILQ_REMOVE(&devfs_chandler_list, chandler, link);
1519 kfree(chandler->name, M_DEVFS);
1520 kfree(chandler, M_DEVFS);
1528 * Worker function that finds a given device name and changes
1529 * the message received accordingly so that when replied to,
1530 * the answer is returned to the caller.
1533 devfs_find_device_by_name_worker(devfs_msg_t devfs_msg)
1535 struct devfs_alias *alias;
1537 cdev_t found = NULL;
1539 TAILQ_FOREACH(dev, &devfs_dev_list, link) {
1540 if (strcmp(devfs_msg->mdv_name, dev->si_name) == 0) {
1545 if (found == NULL) {
1546 TAILQ_FOREACH(alias, &devfs_alias_list, link) {
1547 if (strcmp(devfs_msg->mdv_name, alias->name) == 0) {
1548 found = alias->dev_target;
1553 devfs_msg->mdv_cdev = found;
1559 * Worker function that finds a given device udev and changes
1560 * the message received accordingly so that when replied to,
1561 * the answer is returned to the caller.
1564 devfs_find_device_by_udev_worker(devfs_msg_t devfs_msg)
1567 cdev_t found = NULL;
1569 TAILQ_FOREACH_MUTABLE(dev, &devfs_dev_list, link, dev1) {
1570 if (((udev_t)dev->si_inode) == devfs_msg->mdv_udev) {
1575 devfs_msg->mdv_cdev = found;
1581 * Worker function that inserts a given alias into the
1582 * alias list, and propagates the alias to all mount
1586 devfs_make_alias_worker(struct devfs_alias *alias)
1588 struct devfs_alias *alias2;
1589 size_t len = strlen(alias->name);
1592 TAILQ_FOREACH(alias2, &devfs_alias_list, link) {
1593 if (len != alias2->namlen)
1596 if (!memcmp(alias->name, alias2->name, len)) {
1604 * The alias doesn't exist yet, so we add it to the alias list
1606 TAILQ_INSERT_TAIL(&devfs_alias_list, alias, link);
1607 devfs_alias_propagate(alias, 0);
1608 udev_event_attach(alias->dev_target, alias->name, 1);
1610 devfs_debug(DEVFS_DEBUG_WARNING,
1611 "Warning: duplicate devfs_make_alias for %s\n",
1613 kfree(alias->name, M_DEVFS);
1614 kfree(alias, M_DEVFS);
1621 * Worker function that delete a given alias from the
1622 * alias list, and propagates the removal to all mount
1626 devfs_destroy_alias_worker(struct devfs_alias *alias)
1628 struct devfs_alias *alias2;
1631 TAILQ_FOREACH(alias2, &devfs_alias_list, link) {
1632 if (alias->dev_target != alias2->dev_target)
1635 if (devfs_WildCmp(alias->name, alias2->name) == 0) {
1642 devfs_debug(DEVFS_DEBUG_WARNING,
1643 "Warning: devfs_destroy_alias for inexistant alias: %s\n",
1645 kfree(alias->name, M_DEVFS);
1646 kfree(alias, M_DEVFS);
1649 * The alias exists, so we delete it from the alias list
1651 TAILQ_REMOVE(&devfs_alias_list, alias2, link);
1652 devfs_alias_propagate(alias2, 1);
1653 udev_event_detach(alias2->dev_target, alias2->name, 1);
1654 kfree(alias->name, M_DEVFS);
1655 kfree(alias, M_DEVFS);
1656 kfree(alias2->name, M_DEVFS);
1657 kfree(alias2, M_DEVFS);
1664 * Function that removes and frees all aliases.
1667 devfs_alias_reap(void)
1669 struct devfs_alias *alias, *alias2;
1671 TAILQ_FOREACH_MUTABLE(alias, &devfs_alias_list, link, alias2) {
1672 TAILQ_REMOVE(&devfs_alias_list, alias, link);
1673 kfree(alias->name, M_DEVFS);
1674 kfree(alias, M_DEVFS);
1680 * Function that removes an alias matching a specific cdev and frees
1684 devfs_alias_remove(cdev_t dev)
1686 struct devfs_alias *alias, *alias2;
1688 TAILQ_FOREACH_MUTABLE(alias, &devfs_alias_list, link, alias2) {
1689 if (alias->dev_target == dev) {
1690 TAILQ_REMOVE(&devfs_alias_list, alias, link);
1691 udev_event_detach(alias->dev_target, alias->name, 1);
1692 kfree(alias->name, M_DEVFS);
1693 kfree(alias, M_DEVFS);
1700 * This function propagates an alias addition or removal to
1704 devfs_alias_propagate(struct devfs_alias *alias, int remove)
1706 struct devfs_mnt_data *mnt;
1708 TAILQ_FOREACH(mnt, &devfs_mnt_list, link) {
1710 devfs_destroy_node(mnt->root_node, alias->name);
1712 devfs_alias_apply(mnt->root_node, alias);
1719 * This function is a recursive function iterating through
1720 * all device nodes in the topology and, if applicable,
1721 * creating the relevant alias for a device node.
1724 devfs_alias_apply(struct devfs_node *node, struct devfs_alias *alias)
1726 struct devfs_node *node1, *node2;
1728 KKASSERT(alias != NULL);
1730 if ((node->node_type == Nroot) || (node->node_type == Ndir)) {
1731 if (node->nchildren > 2) {
1732 TAILQ_FOREACH_MUTABLE(node1, DEVFS_DENODE_HEAD(node), link, node2) {
1733 devfs_alias_apply(node1, alias);
1737 if (node->d_dev == alias->dev_target)
1738 devfs_alias_create(alias->name, node, 0);
1744 * This function checks if any alias possibly is applicable
1745 * to the given node. If so, the alias is created.
1748 devfs_alias_check_create(struct devfs_node *node)
1750 struct devfs_alias *alias;
1752 TAILQ_FOREACH(alias, &devfs_alias_list, link) {
1753 if (node->d_dev == alias->dev_target)
1754 devfs_alias_create(alias->name, node, 0);
1760 * This function creates an alias with a given name
1761 * linking to a given devfs node. It also increments
1762 * the link count on the target node.
1765 devfs_alias_create(char *name_orig, struct devfs_node *target, int rule_based)
1767 struct mount *mp = target->mp;
1768 struct devfs_node *parent = DEVFS_MNTDATA(mp)->root_node;
1769 struct devfs_node *linknode;
1770 char *create_path = NULL;
1775 KKASSERT((lockstatus(&devfs_lock, curthread)) == LK_EXCLUSIVE);
1777 name_buf = kmalloc(PATH_MAX, M_TEMP, M_WAITOK);
1778 devfs_resolve_name_path(name_orig, name_buf, &create_path, &name);
1781 parent = devfs_resolve_or_create_path(parent, create_path, 1);
1784 if (devfs_find_device_node_by_name(parent, name)) {
1785 devfs_debug(DEVFS_DEBUG_WARNING,
1786 "Node already exists: %s "
1787 "(devfs_make_alias_worker)!\n",
1793 linknode = devfs_allocp(Nlink, name, parent, mp, NULL);
1794 if (linknode == NULL) {
1799 linknode->link_target = target;
1803 linknode->flags |= DEVFS_RULE_CREATED;
1806 kfree(name_buf, M_TEMP);
1811 * This function is called by the core and handles mount point
1812 * strings. It either calls the relevant worker (devfs_apply_
1813 * reset_rules_worker) on all mountpoints or only a specific
1817 devfs_apply_reset_rules_caller(char *mountto, int apply)
1819 struct devfs_mnt_data *mnt;
1821 if (mountto[0] == '*') {
1822 TAILQ_FOREACH(mnt, &devfs_mnt_list, link) {
1823 devfs_iterate_topology(mnt->root_node,
1824 (apply)?(devfs_rule_check_apply):(devfs_rule_reset_node),
1828 TAILQ_FOREACH(mnt, &devfs_mnt_list, link) {
1829 if (!strcmp(mnt->mp->mnt_stat.f_mntonname, mountto)) {
1830 devfs_iterate_topology(mnt->root_node,
1831 (apply)?(devfs_rule_check_apply):(devfs_rule_reset_node),
1838 kfree(mountto, M_DEVFS);
1843 * This function calls a given callback function for
1844 * every dev node in the devfs dev list.
1847 devfs_scan_callback_worker(devfs_scan_t *callback, void *arg)
1850 struct devfs_alias *alias, *alias1;
1852 TAILQ_FOREACH_MUTABLE(dev, &devfs_dev_list, link, dev1) {
1853 callback(dev->si_name, dev, false, arg);
1855 TAILQ_FOREACH_MUTABLE(alias, &devfs_alias_list, link, alias1) {
1856 callback(alias->name, alias->dev_target, true, arg);
1863 * This function tries to resolve a given directory, or if not
1864 * found and creation requested, creates the given directory.
1866 static struct devfs_node *
1867 devfs_resolve_or_create_dir(struct devfs_node *parent, char *dir_name,
1868 size_t name_len, int create)
1870 struct devfs_node *node, *found = NULL;
1872 TAILQ_FOREACH(node, DEVFS_DENODE_HEAD(parent), link) {
1873 if (name_len != node->d_dir.d_namlen)
1876 if (!memcmp(dir_name, node->d_dir.d_name, name_len)) {
1882 if ((found == NULL) && (create)) {
1883 found = devfs_allocp(Ndir, dir_name, parent, parent->mp, NULL);
1890 * This function tries to resolve a complete path. If creation is requested,
1891 * if a given part of the path cannot be resolved (because it doesn't exist),
1895 devfs_resolve_or_create_path(struct devfs_node *parent, char *path, int create)
1897 struct devfs_node *node = parent;
1904 buf = kmalloc(PATH_MAX, M_TEMP, M_WAITOK);
1906 while (*path && idx < PATH_MAX - 1) {
1911 node = devfs_resolve_or_create_dir(node, buf, idx, create);
1921 node = devfs_resolve_or_create_dir(node, buf, idx, create);
1922 kfree (buf, M_TEMP);
1927 * Takes a full path and strips it into a directory path and a name.
1928 * For a/b/c/foo, it returns foo in namep and a/b/c in pathp. It
1929 * requires a working buffer with enough size to keep the whole
1933 devfs_resolve_name_path(char *fullpath, char *buf, char **pathp, char **namep)
1937 size_t len = strlen(fullpath) + 1;
1940 KKASSERT((fullpath != NULL) && (buf != NULL));
1941 KKASSERT((pathp != NULL) && (namep != NULL));
1943 memcpy(buf, fullpath, len);
1945 for (i = len-1; i>= 0; i--) {
1946 if (buf[i] == '/') {
1966 * This function creates a new devfs node for a given device. It can
1967 * handle a complete path as device name, and accordingly creates
1968 * the path and the final device node.
1970 * The reference count on the passed dev remains unchanged.
1973 devfs_create_device_node(struct devfs_node *root, cdev_t dev,
1974 int *existsp, char *dev_name, char *path_fmt, ...)
1976 struct devfs_node *parent, *node = NULL;
1982 char *create_path = NULL;
1983 char *names = "pqrsPQRS";
1985 name_buf = kmalloc(PATH_MAX, M_TEMP, M_WAITOK);
1990 if (path_fmt != NULL) {
1991 __va_start(ap, path_fmt);
1992 kvasnrprintf(&path, PATH_MAX, 10, path_fmt, ap);
1996 parent = devfs_resolve_or_create_path(root, path, 1);
1999 devfs_resolve_name_path(
2000 ((dev_name == NULL) && (dev))?(dev->si_name):(dev_name),
2001 name_buf, &create_path, &name);
2004 parent = devfs_resolve_or_create_path(parent, create_path, 1);
2007 node = devfs_find_device_node_by_name(parent, name);
2009 if (node->d_dev == dev) {
2011 * Allow case where device caches dev after the
2012 * close and might desire to reuse it.
2017 devfs_debug(DEVFS_DEBUG_WARNING,
2018 "devfs_create_device_node: "
2019 "DEVICE %s ALREADY EXISTS!!! "
2020 "Ignoring creation request.\n",
2027 node = devfs_allocp(Ndev, name, parent, parent->mp, dev);
2028 nanotime(&parent->mtime);
2031 * Ugly unix98 pty magic, to hide pty master (ptm) devices and their
2034 if ((dev) && (strlen(dev->si_name) >= 4) &&
2035 (!memcmp(dev->si_name, "ptm/", 4))) {
2036 node->parent->flags |= DEVFS_HIDDEN;
2037 node->flags |= DEVFS_HIDDEN;
2041 * Ugly pty magic, to tag pty devices as such and hide them if needed.
2043 if ((strlen(name) >= 3) && (!memcmp(name, "pty", 3)))
2044 node->flags |= (DEVFS_PTY | DEVFS_INVISIBLE);
2046 if ((strlen(name) >= 3) && (!memcmp(name, "tty", 3))) {
2048 for (i = 0; i < strlen(names); i++) {
2049 if (name[3] == names[i]) {
2055 node->flags |= (DEVFS_PTY | DEVFS_INVISIBLE);
2059 kfree(name_buf, M_TEMP);
2065 * This function finds a given device node in the topology with a given
2069 devfs_find_device_node_callback(struct devfs_node *node, cdev_t target)
2071 if ((node->node_type == Ndev) && (node->d_dev == target)) {
2079 * This function finds a device node in the given parent directory by its
2080 * name and returns it.
2083 devfs_find_device_node_by_name(struct devfs_node *parent, char *target)
2085 struct devfs_node *node, *found = NULL;
2086 size_t len = strlen(target);
2088 TAILQ_FOREACH(node, DEVFS_DENODE_HEAD(parent), link) {
2089 if (len != node->d_dir.d_namlen)
2092 if (!memcmp(node->d_dir.d_name, target, len)) {
2102 devfs_inode_to_vnode_worker_callback(struct devfs_node *node, ino_t *inop)
2104 struct vnode *vp = NULL;
2105 ino_t target = *inop;
2107 if (node->d_dir.d_ino == target) {
2110 vget(vp, LK_EXCLUSIVE | LK_RETRY);
2113 devfs_allocv(&vp, node);
2122 * This function takes a cdev and removes its devfs node in the
2123 * given topology. The cdev remains intact.
2126 devfs_destroy_device_node(struct devfs_node *root, cdev_t target)
2128 KKASSERT(target != NULL);
2129 return devfs_destroy_node(root, target->si_name);
2133 * This function takes a path to a devfs node, resolves it and
2134 * removes the devfs node from the given topology.
2137 devfs_destroy_node(struct devfs_node *root, char *target)
2139 struct devfs_node *node, *parent;
2142 char *create_path = NULL;
2146 name_buf = kmalloc(PATH_MAX, M_TEMP, M_WAITOK);
2147 ksnprintf(name_buf, PATH_MAX, "%s", target);
2149 devfs_resolve_name_path(target, name_buf, &create_path, &name);
2152 parent = devfs_resolve_or_create_path(root, create_path, 0);
2156 if (parent == NULL) {
2157 kfree(name_buf, M_TEMP);
2161 node = devfs_find_device_node_by_name(parent, name);
2164 nanotime(&node->parent->mtime);
2168 kfree(name_buf, M_TEMP);
2174 * Just set perms and ownership for given node.
2177 devfs_set_perms(struct devfs_node *node, uid_t uid, gid_t gid,
2178 u_short mode, u_long flags)
2188 * Propagates a device attach/detach to all mount
2189 * points. Also takes care of automatic alias removal
2190 * for a deleted cdev.
2193 devfs_propagate_dev(cdev_t dev, int attach)
2195 struct devfs_mnt_data *mnt;
2197 TAILQ_FOREACH(mnt, &devfs_mnt_list, link) {
2199 /* Device is being attached */
2200 devfs_create_device_node(mnt->root_node, dev,
2203 /* Device is being detached */
2204 devfs_alias_remove(dev);
2205 devfs_destroy_device_node(mnt->root_node, dev);
2212 * devfs_clone either returns a basename from a complete name by
2213 * returning the length of the name without trailing digits, or,
2214 * if clone != 0, calls the device's clone handler to get a new
2215 * device, which in turn is returned in devp.
2217 * Caller must hold a shared devfs_lock
2220 devfs_clone(cdev_t dev, const char *name, size_t len, int mode,
2224 struct devfs_clone_handler *chandler;
2225 struct dev_clone_args ap;
2227 TAILQ_FOREACH(chandler, &devfs_chandler_list, link) {
2228 if (chandler->namlen != len)
2230 if ((!memcmp(chandler->name, name, len)) &&
2231 (chandler->nhandler)) {
2233 * We have to unlock across the config and the
2234 * callback to avoid deadlocking. The device is
2235 * likely to obtain its own lock in the callback
2236 * and might then call into devfs.
2238 lockmgr(&devfs_lock, LK_RELEASE);
2240 ap.a_head.a_dev = dev;
2246 error = (chandler->nhandler)(&ap);
2247 lockmgr(&devfs_lock, LK_SHARED);
2260 * Registers a new orphan in the orphan list.
2263 devfs_tracer_add_orphan(struct devfs_node *node)
2265 struct devfs_orphan *orphan;
2268 orphan = kmalloc(sizeof(struct devfs_orphan), M_DEVFS, M_WAITOK);
2269 orphan->node = node;
2271 KKASSERT((node->flags & DEVFS_ORPHANED) == 0);
2272 node->flags |= DEVFS_ORPHANED;
2273 TAILQ_INSERT_TAIL(DEVFS_ORPHANLIST(node->mp), orphan, link);
2277 * Removes an orphan from the orphan list.
2280 devfs_tracer_del_orphan(struct devfs_node *node)
2282 struct devfs_orphan *orphan;
2286 TAILQ_FOREACH(orphan, DEVFS_ORPHANLIST(node->mp), link) {
2287 if (orphan->node == node) {
2288 node->flags &= ~DEVFS_ORPHANED;
2289 TAILQ_REMOVE(DEVFS_ORPHANLIST(node->mp), orphan, link);
2290 kfree(orphan, M_DEVFS);
2297 * Counts the orphans in the orphan list, and if cleanup
2298 * is specified, also frees the orphan and removes it from
2302 devfs_tracer_orphan_count(struct mount *mp, int cleanup)
2304 struct devfs_orphan *orphan, *orphan2;
2307 TAILQ_FOREACH_MUTABLE(orphan, DEVFS_ORPHANLIST(mp), link, orphan2) {
2310 * If we are instructed to clean up, we do so.
2313 TAILQ_REMOVE(DEVFS_ORPHANLIST(mp), orphan, link);
2314 orphan->node->flags &= ~DEVFS_ORPHANED;
2315 devfs_freep(orphan->node);
2316 kfree(orphan, M_DEVFS);
2324 * Fetch an ino_t from the global d_ino by increasing it
2328 devfs_fetch_ino(void)
2332 spin_lock(&ino_lock);
2334 spin_unlock(&ino_lock);
2340 * Allocates a new cdev and initializes it's most basic
2344 devfs_new_cdev(struct dev_ops *ops, int minor, struct dev_ops *bops)
2346 cdev_t dev = sysref_alloc(&cdev_sysref_class);
2348 sysref_activate(&dev->si_sysref);
2350 bzero(dev, offsetof(struct cdev, si_sysref));
2355 dev->si_drv1 = NULL;
2356 dev->si_drv2 = NULL;
2357 dev->si_lastread = 0; /* time_uptime */
2358 dev->si_lastwrite = 0; /* time_uptime */
2360 dev->si_dict = NULL;
2361 dev->si_parent = NULL;
2364 dev->si_uminor = minor;
2365 dev->si_bops = bops;
2368 * Since the disk subsystem is in the way, we need to
2369 * propagate the D_CANFREE from bops (and ops) to
2372 if (bops && (bops->head.flags & D_CANFREE)) {
2373 dev->si_flags |= SI_CANFREE;
2374 } else if (ops->head.flags & D_CANFREE) {
2375 dev->si_flags |= SI_CANFREE;
2378 /* If there is a backing device, we reference its ops */
2379 dev->si_inode = makeudev(
2380 devfs_reference_ops((bops)?(bops):(ops)),
2382 dev->si_umajor = umajor(dev->si_inode);
2388 devfs_cdev_terminate(cdev_t dev)
2392 /* Check if it is locked already. if not, we acquire the devfs lock */
2393 if ((lockstatus(&devfs_lock, curthread)) != LK_EXCLUSIVE) {
2394 lockmgr(&devfs_lock, LK_EXCLUSIVE);
2399 * Make sure the node isn't linked anymore. Otherwise we've screwed
2400 * up somewhere, since normal devs are unlinked on the call to
2401 * destroy_dev and only-cdevs that have not been used for cloning
2402 * are not linked in the first place. only-cdevs used for cloning
2403 * will be linked in, too, and should only be destroyed via
2404 * destroy_dev, not destroy_only_dev, so we catch that problem, too.
2406 KKASSERT((dev->si_flags & SI_DEVFS_LINKED) == 0);
2408 /* If we acquired the lock, we also get rid of it */
2410 lockmgr(&devfs_lock, LK_RELEASE);
2412 /* If there is a backing device, we release the backing device's ops */
2413 devfs_release_ops((dev->si_bops)?(dev->si_bops):(dev->si_ops));
2415 /* Finally destroy the device */
2416 sysref_put(&dev->si_sysref);
2420 * Dummies for now (individual locks for MPSAFE)
2423 devfs_cdev_lock(cdev_t dev)
2428 devfs_cdev_unlock(cdev_t dev)
2433 devfs_detached_filter_eof(struct knote *kn, long hint)
2435 kn->kn_flags |= (EV_EOF | EV_NODATA);
2440 devfs_detached_filter_detach(struct knote *kn)
2442 cdev_t dev = (cdev_t)kn->kn_hook;
2444 knote_remove(&dev->si_kqinfo.ki_note, kn);
2447 static struct filterops devfs_detached_filterops =
2448 { FILTEROP_ISFD, NULL,
2449 devfs_detached_filter_detach,
2450 devfs_detached_filter_eof };
2453 * Delegates knote filter handling responsibility to devfs
2455 * Any device that implements kqfilter event handling and could be detached
2456 * or shut down out from under the kevent subsystem must allow devfs to
2457 * assume responsibility for any knotes it may hold.
2460 devfs_assume_knotes(cdev_t dev, struct kqinfo *kqi)
2463 * Let kern/kern_event.c do the heavy lifting.
2465 knote_assume_knotes(kqi, &dev->si_kqinfo,
2466 &devfs_detached_filterops, (void *)dev);
2469 * These should probably be activated individually, but doing so
2470 * would require refactoring kq's public in-kernel interface.
2472 KNOTE(&dev->si_kqinfo.ki_note, 0);
2476 * Links a given cdev into the dev list.
2479 devfs_link_dev(cdev_t dev)
2481 KKASSERT((dev->si_flags & SI_DEVFS_LINKED) == 0);
2482 dev->si_flags |= SI_DEVFS_LINKED;
2483 TAILQ_INSERT_TAIL(&devfs_dev_list, dev, link);
2489 * Removes a given cdev from the dev list. The caller is responsible for
2490 * releasing the reference on the device associated with the linkage.
2492 * Returns EALREADY if the dev has already been unlinked.
2495 devfs_unlink_dev(cdev_t dev)
2497 if ((dev->si_flags & SI_DEVFS_LINKED)) {
2498 TAILQ_REMOVE(&devfs_dev_list, dev, link);
2499 dev->si_flags &= ~SI_DEVFS_LINKED;
2506 devfs_node_is_accessible(struct devfs_node *node)
2508 if ((node) && (!(node->flags & DEVFS_HIDDEN)))
2515 devfs_reference_ops(struct dev_ops *ops)
2518 struct devfs_dev_ops *found = NULL;
2519 struct devfs_dev_ops *devops;
2521 TAILQ_FOREACH(devops, &devfs_dev_ops_list, link) {
2522 if (devops->ops == ops) {
2529 found = kmalloc(sizeof(struct devfs_dev_ops), M_DEVFS, M_WAITOK);
2531 found->ref_count = 0;
2532 TAILQ_INSERT_TAIL(&devfs_dev_ops_list, found, link);
2537 if (found->ref_count == 0) {
2538 found->id = devfs_clone_bitmap_get(&DEVFS_CLONE_BITMAP(ops_id), 255);
2539 if (found->id == -1) {
2540 /* Ran out of unique ids */
2541 devfs_debug(DEVFS_DEBUG_WARNING,
2542 "devfs_reference_ops: WARNING: ran out of unique ids\n");
2552 devfs_release_ops(struct dev_ops *ops)
2554 struct devfs_dev_ops *found = NULL;
2555 struct devfs_dev_ops *devops;
2557 TAILQ_FOREACH(devops, &devfs_dev_ops_list, link) {
2558 if (devops->ops == ops) {
2568 if (found->ref_count == 0) {
2569 TAILQ_REMOVE(&devfs_dev_ops_list, found, link);
2570 devfs_clone_bitmap_put(&DEVFS_CLONE_BITMAP(ops_id), found->id);
2571 kfree(found, M_DEVFS);
2576 * Wait for asynchronous messages to complete in the devfs helper
2577 * thread, then return. Do nothing if the helper thread is dead
2578 * or we are being indirectly called from the helper thread itself.
2585 if (devfs_run && curthread != td_core) {
2586 msg = devfs_msg_get();
2587 devfs_msg_send_sync(DEVFS_SYNC, msg);
2593 * Called on init of devfs; creates the objcaches and
2594 * spawns off the devfs core thread. Also initializes
2600 devfs_debug(DEVFS_DEBUG_DEBUG, "devfs_init() called\n");
2601 /* Create objcaches for nodes, msgs and devs */
2602 devfs_node_cache = objcache_create("devfs-node-cache", 0, 0,
2604 objcache_malloc_alloc,
2605 objcache_malloc_free,
2606 &devfs_node_malloc_args );
2608 devfs_msg_cache = objcache_create("devfs-msg-cache", 0, 0,
2610 objcache_malloc_alloc,
2611 objcache_malloc_free,
2612 &devfs_msg_malloc_args );
2614 devfs_dev_cache = objcache_create("devfs-dev-cache", 0, 0,
2616 objcache_malloc_alloc,
2617 objcache_malloc_free,
2618 &devfs_dev_malloc_args );
2620 devfs_clone_bitmap_init(&DEVFS_CLONE_BITMAP(ops_id));
2622 /* Initialize the reply-only port which acts as a message drain */
2623 lwkt_initport_replyonly(&devfs_dispose_port, devfs_msg_autofree_reply);
2625 /* Initialize *THE* devfs lock */
2626 lockinit(&devfs_lock, "devfs_core lock", 0, 0);
2627 lwkt_token_init(&devfs_token, "devfs_core");
2629 lockmgr(&devfs_lock, LK_EXCLUSIVE);
2630 lwkt_create(devfs_msg_core, /*args*/NULL, &td_core, NULL,
2631 0, -1, "devfs_msg_core");
2632 while (devfs_run == 0)
2633 lksleep(td_core, &devfs_lock, 0, "devfsc", 0);
2634 lockmgr(&devfs_lock, LK_RELEASE);
2636 devfs_debug(DEVFS_DEBUG_DEBUG, "devfs_init finished\n");
2640 * Called on unload of devfs; takes care of destroying the core
2641 * and the objcaches. Also removes aliases that are no longer needed.
2646 devfs_debug(DEVFS_DEBUG_DEBUG, "devfs_uninit() called\n");
2648 devfs_msg_send(DEVFS_TERMINATE_CORE, NULL);
2650 tsleep(td_core, 0, "devfsc", hz*10);
2651 tsleep(td_core, 0, "devfsc", hz);
2653 devfs_clone_bitmap_uninit(&DEVFS_CLONE_BITMAP(ops_id));
2655 /* Destroy the objcaches */
2656 objcache_destroy(devfs_msg_cache);
2657 objcache_destroy(devfs_node_cache);
2658 objcache_destroy(devfs_dev_cache);
2664 * This is a sysctl handler to assist userland devname(3) to
2665 * find the device name for a given udev.
2668 devfs_sysctl_devname_helper(SYSCTL_HANDLER_ARGS)
2674 if ((error = SYSCTL_IN(req, &udev, sizeof(udev_t))))
2677 devfs_debug(DEVFS_DEBUG_DEBUG,
2678 "devfs sysctl, received udev: %d\n", udev);
2683 if ((found = devfs_find_device_by_udev(udev)) == NULL)
2686 return(SYSCTL_OUT(req, found->si_name, strlen(found->si_name) + 1));
2690 SYSCTL_PROC(_kern, OID_AUTO, devname,
2691 CTLTYPE_OPAQUE | CTLFLAG_RW | CTLFLAG_ANYBODY | CTLFLAG_NOLOCK,
2692 NULL, 0, devfs_sysctl_devname_helper, "",
2693 "helper for devname(3)");
2695 SYSCTL_NODE(_vfs, OID_AUTO, devfs, CTLFLAG_RW, 0, "devfs");
2696 TUNABLE_INT("vfs.devfs.debug", &devfs_debug_enable);
2697 SYSCTL_INT(_vfs_devfs, OID_AUTO, debug, CTLFLAG_RW, &devfs_debug_enable,
2698 0, "Enable DevFS debugging");
2700 SYSINIT(vfs_devfs_register, SI_SUB_DEVFS_CORE, SI_ORDER_FIRST,
2702 SYSUNINIT(vfs_devfs_register, SI_SUB_DEVFS_CORE, SI_ORDER_ANY,
2703 devfs_uninit, NULL);
2706 * WildCmp() - compare wild string to sane string
2708 * Returns 0 on success, -1 on failure.
2711 wildCmp(const char **mary, int d, const char *w, const char *s)
2716 * skip fixed portion
2722 * optimize terminator
2726 if (w[1] != '?' && w[1] != '*') {
2728 * optimize * followed by non-wild
2730 for (i = 0; s + i < mary[d]; ++i) {
2731 if (s[i] == w[1] && wildCmp(mary, d + 1, w + 1, s + i) == 0)
2738 for (i = 0; s + i < mary[d]; ++i) {
2739 if (wildCmp(mary, d + 1, w + 1, s + i) == 0)
2754 if (*w == 0) /* terminator */
2767 * WildCaseCmp() - compare wild string to sane string, case insensitive
2769 * Returns 0 on success, -1 on failure.
2772 wildCaseCmp(const char **mary, int d, const char *w, const char *s)
2777 * skip fixed portion
2783 * optimize terminator
2787 if (w[1] != '?' && w[1] != '*') {
2789 * optimize * followed by non-wild
2791 for (i = 0; s + i < mary[d]; ++i) {
2792 if (s[i] == w[1] && wildCaseCmp(mary, d + 1, w + 1, s + i) == 0)
2799 for (i = 0; s + i < mary[d]; ++i) {
2800 if (wildCaseCmp(mary, d + 1, w + 1, s + i) == 0)
2814 #define tolower(x) ((x >= 'A' && x <= 'Z')?(x+('a'-'A')):(x))
2815 if (tolower(*w) != tolower(*s))
2818 if (*w == 0) /* terminator */
2829 struct cdev_privdata {
2831 cdevpriv_dtr_t cdpd_dtr;
2835 devfs_get_cdevpriv(struct file *fp, void **datap)
2842 spin_lock_shared(&fp->f_spin);
2843 if (fp->f_data1 == NULL) {
2847 struct cdev_privdata *p = fp->f_data1;
2849 *datap = p->cdpd_data;
2852 spin_unlock_shared(&fp->f_spin);
2858 devfs_set_cdevpriv(struct file *fp, void *priv, cdevpriv_dtr_t dtr)
2860 struct cdev_privdata *p;
2866 p = kmalloc(sizeof(struct cdev_privdata), M_DEVFS, M_WAITOK);
2867 p->cdpd_data = priv;
2870 spin_lock(&fp->f_spin);
2871 if (fp->f_data1 == NULL) {
2877 spin_unlock(&fp->f_spin);
2886 devfs_clear_cdevpriv(struct file *fp)
2888 struct cdev_privdata *p;
2893 spin_lock(&fp->f_spin);
2896 spin_unlock(&fp->f_spin);
2899 p->cdpd_dtr(p->cdpd_data);
2905 devfs_WildCmp(const char *w, const char *s)
2909 int slen = strlen(s);
2912 for (i = c = 0; w[i]; ++i) {
2916 mary = kmalloc(sizeof(char *) * (c + 1), M_DEVFS, M_WAITOK);
2917 for (i = 0; i < c; ++i)
2919 i = wildCmp(mary, 0, w, s);
2920 kfree(mary, M_DEVFS);
2925 devfs_WildCaseCmp(const char *w, const char *s)
2929 int slen = strlen(s);
2932 for (i = c = 0; w[i]; ++i) {
2936 mary = kmalloc(sizeof(char *) * (c + 1), M_DEVFS, M_WAITOK);
2937 for (i = 0; i < c; ++i)
2939 i = wildCaseCmp(mary, 0, w, s);
2940 kfree(mary, M_DEVFS);