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
37 #if !defined(_KERNEL) && !defined(_KERNEL_STRUCTURES)
38 #error "This file should not be included by userland programs."
42 #include <sys/queue.h>
50 #ifndef _SYS_MSGPORT_H_
51 #include <sys/msgport.h>
53 #ifndef _SYS_DIRENT_H_
54 #include <sys/dirent.h>
56 #ifndef _SYS_DEVICE_H_
57 #include <sys/device.h>
60 #include <sys/ucred.h>
65 Proot, /* the filesystem root */
73 ino_t d_ino; /* file number of entry */
74 uint16_t d_namlen; /* strlen(d_name) */
75 uint8_t d_type; /* file type */
80 cdev_t d_dev; /* device assoicated with this node */
82 struct mount *mp; /* mount point of this node */
83 struct devfs_dirent d_dir; /* dirent data (name, inode, ...) */
84 struct vnode *v_node; /* assoicated vnode */
85 struct devfs_node *parent; /* parent of this node */
86 devfs_nodetype node_type; /* devfs node type */
88 u_int64_t refs; /* number of open references */
89 size_t nchildren; /* number of children of a parent */
90 u_int64_t cookie_jar; /* cookie pool for children */
91 u_int64_t cookie; /* directory entry cookie for readdir */
93 struct devfs_node *link_target; /* target of this autolink-type node */
94 size_t nlinks; /* number of links that point to this node */
96 char *symlink_name; /* symlink name for readlink */
97 size_t symlink_namelen; /* symlink name length for readlink */
99 u_short mode; /* files access mode and type */
100 uid_t uid; /* owner user id */
101 gid_t gid; /* owner group id */
104 struct timespec atime; /* time of last access */
105 struct timespec mtime; /* time of last modification */
106 struct timespec ctime; /* time file changed */
109 TAILQ_ENTRY(devfs_node) link;
110 TAILQ_HEAD(, devfs_node) list; /* linked list of children */
113 struct devfs_orphan {
114 struct devfs_node *node;
116 TAILQ_ENTRY(devfs_orphan) link;
119 struct devfs_mnt_data {
120 TAILQ_HEAD(, devfs_orphan) orphan_list;
122 struct devfs_node *root_node;
130 TAILQ_ENTRY(devfs_mnt_data) link;
133 struct devfs_clone_handler {
138 TAILQ_ENTRY(devfs_clone_handler) link;
143 char name[PATH_MAX + 1];
146 TAILQ_ENTRY(devfs_alias) link;
150 typedef struct devfs_msg {
162 struct devfs_mnt_data *mnt;
189 struct devfs_node *node;
206 #define mdv_chandler __m_u.__m_chandler
207 #define mdv_mnt __m_u.__m_mnt.mnt
208 #define mdv_load __m_u.__m_gen.load
209 #define mdv_response __m_u.__m_resp.resp
210 #define mdv_dev __m_u.__m_dev
211 #define mdv_link __m_u.__m_link
212 #define mdv_udev __m_u.__m_udev.udev
213 #define mdv_cdev __m_u.__m_cdev.cdev
214 #define mdv_name __m_u.__m_name.name
215 #define mdv_clone __m_u.__m_clone
216 #define mdv_node __m_u.__m_node.node
217 #define mdv_ops __m_u.__m_ops
218 #define mdv_flags __m_u.__m_flags
222 typedef struct devfs_core_args {
224 } *devfs_core_args_t;
227 TAILQ_HEAD(devfs_node_head, devfs_node);
228 TAILQ_HEAD(devfs_dev_head, cdev);
229 TAILQ_HEAD(devfs_mnt_head, devfs_mnt_data);
230 TAILQ_HEAD(devfs_chandler_head, devfs_clone_handler);
231 TAILQ_HEAD(devfs_alias_head, devfs_alias);
233 typedef void (devfs_scan_t)(cdev_t);
236 #define DEVFS_NODE(x) ((struct devfs_node *)((x)->v_data))
237 #define DEVFS_MNTDATA(x) ((struct devfs_mnt_data *)((x)->mnt_data))
238 #define DEVFS_ORPHANLIST(x) (&(DEVFS_MNTDATA(x)->orphan_list))
239 #define DEVFS_DENODE_HEAD(x) (&((x)->list))
240 #define DEVFS_ISDIGIT(x) ((x >= '0') && (x <= '9'))
242 #define DEVFS_DEFAULT_MODE ((VREAD|VWRITE|VEXEC) | ((VREAD|VEXEC)>>3) | ((VREAD|VEXEC)>>6)); /* -rwxr-xr-x */
243 #define DEVFS_DEFAULT_UID 0 /* root */
244 #define DEVFS_DEFAULT_GID 5 /* operator */
249 #define DEVFS_DEBUG_SHOW 0x00
250 #define DEVFS_DEBUG_WARNING 0x01
251 #define DEVFS_DEBUG_INFO 0x02
252 #define DEVFS_DEBUG_DEBUG 0x03
257 #define DEVFS_TERMINATE_CORE 0x01
258 #define DEVFS_DEVICE_CREATE 0x02
259 #define DEVFS_DEVICE_DESTROY 0x03
260 #define DEVFS_MOUNT_ADD 0x04
261 #define DEVFS_MOUNT_DEL 0x05
262 #define DEVFS_CREATE_ALL_DEV 0x06
263 #define DEVFS_DESTROY_SUBNAMES 0x07
264 #define DEVFS_DESTROY_DEV_BY_OPS 0x08
265 #define DEVFS_CHANDLER_ADD 0x09
266 #define DEVFS_CHANDLER_DEL 0x0A
267 #define DEVFS_FIND_DEVICE_BY_UDEV 0x0B
268 #define DEVFS_FIND_DEVICE_BY_NAME 0x0C
269 #define DEVFS_MAKE_ALIAS 0x0D
270 #define DEVFS_APPLY_RULES 0x0F
271 #define DEVFS_RESET_RULES 0x10
272 #define DEVFS_SCAN_CALLBACK 0x11
273 #define DEVFS_CLR_SUBNAMES_FLAG 0x12
274 #define DEVFS_DESTROY_SUBNAMES_WO_FLAG 0x13
275 #define DEVFS_SYNC 0x99
280 #define DEVFS_NODE_LINKED 0x01 /* Linked into topology */
281 #define DEVFS_USER_CREATED 0x02 /* Node was user-created */
282 #define DEVFS_ORPHANED 0x04 /* on orphan list */
283 #define DEVFS_CLONED 0x08 /* Created by cloning code */
284 #define DEVFS_HIDDEN 0x10 /* Makes node inaccessible, apart from already allocated vnodes*/
285 #define DEVFS_INVISIBLE 0x20 /* Makes node invisible in a readdir() */
286 #define DEVFS_PTY 0x40 /* PTY device */
287 #define DEVFS_DESTROYED 0x80 /* Sanity check */
293 #define DEVFS_UNIT_HSIZE 64 /* power of 2 */
294 #define DEVFS_UNIT_HMASK (DEVFS_UNIT_HSIZE - 1)
295 #define DEVFS_CLONE_HASHLIST(name) devfs_ ## name ## _clone_hashlist
296 #define DEVFS_DECLARE_CLONE_HASHLIST(name) struct devfs_unit_hash* DEVFS_CLONE_HASHLIST(name) [DEVFS_UNIT_HSIZE]
299 #define DEVFS_BITMAP_INITIAL_SIZE 1
300 #define DEVFS_CLONE_BITMAP(name) devfs_ ## name ## _clone_bitmap
301 #define DEVFS_DECLARE_CLONE_BITMAP(name) struct devfs_bitmap DEVFS_CLONE_BITMAP(name)
302 #define devfs_clone_bitmap_put devfs_clone_bitmap_rst
304 struct devfs_bitmap {
306 unsigned long *bitmap;
309 struct devfs_unit_hash {
310 struct devfs_unit_hash *next;
316 struct devfs_clone_helper {
317 DEVFS_DECLARE_CLONE_HASHLIST(generic);
318 DEVFS_DECLARE_CLONE_BITMAP(generic);
321 #define DEVFS_CLONE_HELPER(name) devfs_ ## name ## _clone_helper
322 #define DEVFS_DECLARE_CLONE_HELPER(name) static struct devfs_clone_helper DEVFS_CLONE_HELPER(name)
325 void devfs_clone_bitmap_init(struct devfs_bitmap *);
326 void devfs_clone_bitmap_uninit(struct devfs_bitmap *);
327 void devfs_clone_bitmap_resize(struct devfs_bitmap *, int);
328 int devfs_clone_bitmap_fff(struct devfs_bitmap *);
329 void devfs_clone_bitmap_set(struct devfs_bitmap *, int);
330 void devfs_clone_bitmap_rst(struct devfs_bitmap *, int);
331 int devfs_clone_bitmap_get(struct devfs_bitmap *, int);
332 int devfs_clone_bitmap_chk(struct devfs_bitmap *, int);
334 void devfs_clone_helper_init(struct devfs_clone_helper *);
335 void devfs_clone_helper_uninit(struct devfs_clone_helper *);
336 int devfs_clone_helper_insert(struct devfs_clone_helper *, cdev_t);
337 int devfs_clone_helper_remove(struct devfs_clone_helper *, int);
343 int devfs_debug(int level, char *fmt, ...);
344 int devfs_allocv(struct vnode **, struct devfs_node *);
345 struct devfs_node *devfs_allocp(devfs_nodetype, char *, struct devfs_node *, struct mount *, cdev_t);
346 int devfs_allocvp(struct mount *, struct vnode **, devfs_nodetype, char *, struct devfs_node *, cdev_t);
348 int devfs_freep(struct devfs_node *);
349 int devfs_reaperp(struct devfs_node *);
351 int devfs_unlinkp(struct devfs_node *);
353 void devfs_tracer_add_orphan(struct devfs_node *);
354 void devfs_tracer_del_orphan(struct devfs_node *);
355 size_t devfs_tracer_orphan_count(struct mount *, int);
357 int devfs_set_perms(struct devfs_node *, uid_t, gid_t, u_short, u_long);
358 int devfs_gc(struct devfs_node *);
360 int devfs_create_dev(cdev_t, uid_t, gid_t, int);
361 int devfs_destroy_dev(cdev_t);
363 devfs_msg_t devfs_msg_send_sync(uint32_t, devfs_msg_t);
364 __uint32_t devfs_msg_send(uint32_t, devfs_msg_t);
365 __uint32_t devfs_msg_send_dev(uint32_t, cdev_t dev, uid_t, gid_t, int);
366 __uint32_t devfs_msg_send_mount(uint32_t, struct devfs_mnt_data *);
367 __uint32_t devfs_msg_send_ops(uint32_t, struct dev_ops *, int);
368 __uint32_t devfs_msg_send_chandler(uint32_t, char *, d_clone_t);
369 __uint32_t devfs_msg_send_generic(uint32_t, void *);
370 __uint32_t devfs_msg_send_name(uint32_t, char *);
371 __uint32_t devfs_msg_send_link(uint32_t, char *, char *, struct mount *);
373 devfs_msg_t devfs_msg_get(void);
374 int devfs_msg_put(devfs_msg_t);
376 int devfs_mount_add(struct devfs_mnt_data *);
377 int devfs_mount_del(struct devfs_mnt_data *);
379 int devfs_create_all_dev(struct devfs_node *);
381 struct devfs_node *devfs_resolve_or_create_path(struct devfs_node *, char *, int);
382 int devfs_resolve_name_path(char *, char *, char **, char **);
383 struct devfs_node *devfs_create_device_node(struct devfs_node *, cdev_t, char *, char *, ...);
385 int devfs_destroy_device_node(struct devfs_node *, cdev_t);
386 int devfs_destroy_subnames(char *);
387 int devfs_destroy_dev_by_ops(struct dev_ops *, int);
388 struct devfs_node *devfs_find_device_node(struct devfs_node *, cdev_t);
389 struct devfs_node *devfs_find_device_node_by_name(struct devfs_node *, char *);
391 cdev_t devfs_new_cdev(struct dev_ops *, int);
393 cdev_t devfs_find_device_by_name(const char *, ...);
394 cdev_t devfs_find_device_by_udev(udev_t);
396 int devfs_clone_handler_add(char *, d_clone_t *);
397 int devfs_clone_handler_del(char *);
398 int devfs_clone(char *, size_t *, cdev_t *, int, struct ucred *);
400 int devfs_link_dev(cdev_t);
402 int devfs_make_alias(char *, cdev_t);
404 int devfs_alias_create(char *name_orig, struct devfs_node *target);
406 int devfs_apply_rules(char *);
407 int devfs_reset_rules(char *);
409 int devfs_scan_callback(devfs_scan_t *);
410 int devfs_node_to_path(struct devfs_node *, char *);
412 int devfs_clr_subnames_flag(char *, uint32_t);
413 int devfs_destroy_subnames_without_flag(char *, uint32_t);
414 int devfs_node_is_accessible(struct devfs_node *);
416 int devfs_reference_ops(struct dev_ops *);
417 void devfs_release_ops(struct dev_ops *);
419 void devfs_config(void *);
420 #endif /* _VFS_DEVFS_H_ */