[apple/xnu.git] / bsd / miscfs / devfs / devfsdefs.h

/*
 * Copyright (c) 2000-2002 Apple Computer, Inc. All rights reserved.
 *
 * @APPLE_LICENSE_HEADER_START@
 * 
 * The contents of this file constitute Original Code as defined in and
 * are subject to the Apple Public Source License Version 1.1 (the
 * "License").  You may not use this file except in compliance with the
 * License.  Please obtain a copy of the License at
 * http://www.apple.com/publicsource and read it before using this file.
 * 
 * This Original Code and all software distributed under the License are
 * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
 * License for the specific language governing rights and limitations
 * under the License.
 * 
 * @APPLE_LICENSE_HEADER_END@
 */
/*
 * Copyright 1997,1998 Julian Elischer.  All rights reserved.
 * julian@freebsd.org
 * 
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are
 * met:
 *  1. Redistributions of source code must retain the above copyright
 *     notice, this list of conditions and the following disclaimer.
 *  2. Redistributions in binary form must reproduce the above copyright notice,
 *     this list of conditions and the following disclaimer in the documentation
 *     and/or other materials provided with the distribution.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER ``AS IS'' AND ANY EXPRESS
 * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED.  IN NO EVENT SHALL THE HOLDER OR CONTRIBUTORS BE LIABLE FOR
 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 * 
 * devfsdefs.h
 */

/*
 * HISTORY
 *  8-April-1999 Dieter Siegmund (dieter@apple.com)
 *	Ported to from FreeBSD 3.1
 *	Removed unnecessary/unused defines
 *	Renamed structures/elements to clarify usage in code.
 */

#ifndef __DEVFS_DEVFSDEFS_H__
#define __DEVFS_DEVFSDEFS_H__

#include  <sys/appleapiopts.h>

#ifdef __APPLE_API_PRIVATE
#define DEVMAXNAMESIZE 	32 		/* XXX */
#define DEVMAXPATHSIZE 	128		/* XXX */

typedef enum {
    DEV_DIR,
    DEV_BDEV,
    DEV_CDEV,
    DEV_SLNK
} devfstype_t;

extern int (**devfs_vnodeop_p)(void *);	/* our own vector array for dirs */
extern int (**devfs_spec_vnodeop_p)(void *); /* our own vector array for devs */
extern struct vfsops devfs_vfsops;

typedef	struct devnode		devnode_t;
typedef struct devdirent 	devdirent_t;
typedef union devnode_type 	devnode_type_t;

struct devfs_stats {
    int			nodes;
    int			entries;
    int			mounts;
    int			stringspace;
};

union devnode_type {
    dev_t		dev;
    struct {
	devdirent_t *	dirlist;
	devdirent_t * *	dirlast;
	devnode_t *	parent;
	devdirent_t *	myname;		/* my entry in .. */
	int		entrycount;
    }Dir;
    struct {
	char *		name;	/* must be allocated separately */
	int		namelen;
    }Slnk;
};

#define	DN_ACCESS	0x0001		/* Access time update request. */
#define	DN_CHANGE	0x0002		/* Inode change time update request. */
#define	DN_UPDATE	0x0004		/* Modification time update request. */
#define	DN_MODIFIED	0x0008		/* Inode has been modified. */
#define	DN_RENAME	0x0010		/* Inode is being renamed. */

struct devnode
{
    devfstype_t		dn_type;
    int			dn_flags;
    u_short		dn_mode;
    uid_t		dn_uid; 
    gid_t		dn_gid;
    struct timespec	dn_atime;/* time of last access */
    struct timespec	dn_mtime;/* time of last modification */
    struct timespec	dn_ctime;/* time file changed */
    int	(***dn_ops)(void *);/* yuk... pointer to pointer(s) to funcs */
    int			dn_links;/* how many file links does this node have? */
    struct devfsmount *	dn_dvm; /* the mount structure for this 'plane' */
    struct vnode *	dn_vn;	/* address of last vnode that represented us */
    int			dn_len;   /* of any associated info (e.g. dir data) */
    devdirent_t *	dn_linklist;/* circular list of hardlinks to this node */
    devdirent_t *	dn_last_lookup;	/* name I was last looked up from */
    devnode_t *		dn_nextsibling;	/* the list of equivalent nodes */
    devnode_t * *	dn_prevsiblingp;/* backpointer for the above */
    devnode_type_t	dn_typeinfo;
    int			dn_delete;	/* mark for deletion */
};

struct devdirent
{
    /*-----------------------directory entry fields-------------*/
    char		de_name[DEVMAXNAMESIZE];
    devnode_t *		de_dnp;		/* the "inode" (devnode) pointer */
    devnode_t *		de_parent;	/* backpointer to the directory itself */
    devdirent_t *	de_next;	/* next object in this directory */
    devdirent_t *	*de_prevp;	/* previous pointer in directory linked list */
    devdirent_t *	de_nextlink;	/* next hardlink to this node */
    devdirent_t *	*de_prevlinkp;	/* previous hardlink pointer for this node */
};

extern devdirent_t * 		dev_root;
extern struct lock__bsd__	devfs_lock;
extern struct devfs_stats	devfs_stats;

/*
 * Rules for front nodes:
 * Dirs hava a strict 1:1 relationship with their OWN devnode
 * Symlinks similarly
 * Device Nodes ALWAYS point to the devnode that is linked
 * to the Backing node. (with a ref count)
 */

/*
 * DEVFS specific per/mount information, used to link a monted fs to a
 * particular 'plane' of front nodes.
 */
struct devfsmount
{
    struct mount *	mount;	/* vfs mount struct for this fs	*/
    devdirent_t *	plane_root;/* the root of this 'plane'	*/
};

/*
 * Prototypes for DEVFS virtual filesystem operations
 */
#include <sys/lock.h>
#include <miscfs/devfs/devfs_proto.h>

//#define HIDDEN_MOUNTPOINT	1

/* misc */
#define M_DEVFSNAME	M_DEVFS
#define M_DEVFSNODE	M_DEVFS
#define M_DEVFSMNT	M_DEVFS

#define VTODN(vp)	((devnode_t *)(vp)->v_data)

static __inline__ int
DEVFS_LOCK(struct proc * p)
{
    return (lockmgr(&devfs_lock, LK_EXCLUSIVE, NULL, p));
}

static __inline__ int
DEVFS_UNLOCK(struct proc * p)
{
    return (lockmgr(&devfs_lock, LK_RELEASE, NULL, p));
}

static __inline__ void
DEVFS_INCR_ENTRIES()
{
    devfs_stats.entries++;
}

static __inline__ void
DEVFS_DECR_ENTRIES()
{
    devfs_stats.entries--;
}

static __inline__ void
DEVFS_INCR_NODES()
{
    devfs_stats.nodes++;
}

static __inline__ void
DEVFS_DECR_NODES()
{
    devfs_stats.nodes--;
}

static __inline__ void
DEVFS_INCR_MOUNTS()
{
    devfs_stats.mounts++;
}

static __inline__ void
DEVFS_DECR_MOUNTS()
{
    devfs_stats.mounts--;
}

static __inline__ void
DEVFS_INCR_STRINGSPACE(int space)
{
    devfs_stats.stringspace += space;
}

static __inline__ void
DEVFS_DECR_STRINGSPACE(int space)
{
    devfs_stats.stringspace -= space;
    if (devfs_stats.stringspace < 0) {
	printf("DEVFS_DECR_STRINGSPACE: (%d - %d < 0)\n",
	       devfs_stats.stringspace + space, space);
	devfs_stats.stringspace = 0;
    }
}

static __inline__ void
dn_times(devnode_t * dnp, struct timeval t1, struct timeval t2) 
{
    if (dnp->dn_flags & (DN_ACCESS | DN_CHANGE | DN_UPDATE)) {
	if (dnp->dn_flags & DN_ACCESS) {
	    dnp->dn_atime.tv_sec = t1.tv_sec;
	    dnp->dn_atime.tv_nsec = t1.tv_usec * 1000;
	}
	if (dnp->dn_flags & DN_UPDATE) {
	    dnp->dn_mtime.tv_sec = t2.tv_sec;
	    dnp->dn_mtime.tv_nsec = t2.tv_usec * 1000;
	}
	if (dnp->dn_flags & DN_CHANGE) {
	    dnp->dn_ctime.tv_sec = time.tv_sec;
	    dnp->dn_ctime.tv_nsec = time.tv_usec * 1000;
	}
	dnp->dn_flags &= ~(DN_ACCESS | DN_CHANGE | DN_UPDATE);
    }
    return;
}

static __inline__ void
dn_copy_times(devnode_t * target, devnode_t * source)
{
    target->dn_atime = source->dn_atime;
    target->dn_mtime = source->dn_mtime;
    target->dn_ctime = source->dn_ctime;
    return;
}
#endif /* __APPLE_API_PRIVATE */
#endif /* __DEVFS_DEVFSDEFS_H__ */
Commit	Line	Data
1c79356b	1	/*
9bccf70c	2	* Copyright (c) 2000-2002 Apple Computer, Inc. All rights reserved.
1c79356b A	3	*
	4	* @APPLE_LICENSE_HEADER_START@
	5	*
e5568f75 A	6	* The contents of this file constitute Original Code as defined in and
	7	* are subject to the Apple Public Source License Version 1.1 (the
	8	* "License"). You may not use this file except in compliance with the
	9	* License. Please obtain a copy of the License at
	10	* http://www.apple.com/publicsource and read it before using this file.
1c79356b	11	*
e5568f75 A	12	* This Original Code and all software distributed under the License are
e5568f75 A	13	* distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
1c79356b A	14	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
1c79356b A	15	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
e5568f75 A	16	* FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the
	17	* License for the specific language governing rights and limitations
	18	* under the License.
1c79356b A	19	*
	20	* @APPLE_LICENSE_HEADER_END@
	21	*/
	22	/*
	23	* Copyright 1997,1998 Julian Elischer. All rights reserved.
	24	* julian@freebsd.org
	25	*
	26	* Redistribution and use in source and binary forms, with or without
	27	* modification, are permitted provided that the following conditions are
	28	* met:
	29	* 1. Redistributions of source code must retain the above copyright
	30	* notice, this list of conditions and the following disclaimer.
	31	* 2. Redistributions in binary form must reproduce the above copyright notice,
	32	* this list of conditions and the following disclaimer in the documentation
	33	* and/or other materials provided with the distribution.
	34	*
	35	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER ``AS IS'' AND ANY EXPRESS
	36	* OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
	37	* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
	38	* DISCLAIMED. IN NO EVENT SHALL THE HOLDER OR CONTRIBUTORS BE LIABLE FOR
	39	* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
	40	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
	41	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
	42	* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	43	* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	44	* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	45	* SUCH DAMAGE.
	46	*
	47	* devfsdefs.h
	48	*/
	49
	50	/*
	51	* HISTORY
	52	* 8-April-1999 Dieter Siegmund (dieter@apple.com)
	53	* Ported to from FreeBSD 3.1
	54	* Removed unnecessary/unused defines
	55	* Renamed structures/elements to clarify usage in code.
	56	*/
	57
9bccf70c A	58	#ifndef __DEVFS_DEVFSDEFS_H__
9bccf70c A	59	#define __DEVFS_DEVFSDEFS_H__
1c79356b	60
9bccf70c A	61	#include <sys/appleapiopts.h>
	62
	63	#ifdef __APPLE_API_PRIVATE
1c79356b A	64	#define DEVMAXNAMESIZE 32 /* XXX */
	65	#define DEVMAXPATHSIZE 128 /* XXX */
	66
	67	typedef enum {
	68	DEV_DIR,
	69	DEV_BDEV,
	70	DEV_CDEV,
55e303ae	71	DEV_SLNK
1c79356b A	72	} devfstype_t;
	73
	74	extern int (*devfs_vnodeop_p)(void ); /* our own vector array for dirs */
	75	extern int (*devfs_spec_vnodeop_p)(void ); /* our own vector array for devs */
	76	extern struct vfsops devfs_vfsops;
	77
	78	typedef struct devnode devnode_t;
	79	typedef struct devdirent devdirent_t;
	80	typedef union devnode_type devnode_type_t;
	81
	82	struct devfs_stats {
	83	int nodes;
	84	int entries;
	85	int mounts;
	86	int stringspace;
	87	};
	88
	89	union devnode_type {
	90	dev_t dev;
	91	struct {
	92	devdirent_t * dirlist;
	93	devdirent_t * * dirlast;
	94	devnode_t * parent;
	95	devdirent_t * myname; /* my entry in .. */
	96	int entrycount;
	97	}Dir;
	98	struct {
	99	char * name; /* must be allocated separately */
	100	int namelen;
	101	}Slnk;
	102	};
	103
	104	#define DN_ACCESS 0x0001 /* Access time update request. */
	105	#define DN_CHANGE 0x0002 /* Inode change time update request. */
	106	#define DN_UPDATE 0x0004 /* Modification time update request. */
	107	#define DN_MODIFIED 0x0008 /* Inode has been modified. */
	108	#define DN_RENAME 0x0010 /* Inode is being renamed. */
	109
	110	struct devnode
	111	{
	112	devfstype_t dn_type;
	113	int dn_flags;
	114	u_short dn_mode;
0b4e3aa0 A	115	uid_t dn_uid;
0b4e3aa0 A	116	gid_t dn_gid;
1c79356b A	117	struct timespec dn_atime;/* time of last access */
	118	struct timespec dn_mtime;/* time of last modification */
	119	struct timespec dn_ctime;/* time file changed */
	120	int (**dn_ops)(void );/* yuk... pointer to pointer(s) to funcs */
	121	int dn_links;/* how many file links does this node have? */
	122	struct devfsmount * dn_dvm; /* the mount structure for this 'plane' */
	123	struct vnode * dn_vn; /* address of last vnode that represented us */
	124	int dn_len; /* of any associated info (e.g. dir data) */
	125	devdirent_t * dn_linklist;/* circular list of hardlinks to this node */
	126	devdirent_t * dn_last_lookup; /* name I was last looked up from */
	127	devnode_t * dn_nextsibling; /* the list of equivalent nodes */
	128	devnode_t * * dn_prevsiblingp;/* backpointer for the above */
	129	devnode_type_t dn_typeinfo;
	130	int dn_delete; /* mark for deletion */
	131	};
	132
	133	struct devdirent
	134	{
	135	/-----------------------directory entry fields-------------/
	136	char de_name[DEVMAXNAMESIZE];
	137	devnode_t * de_dnp; /* the "inode" (devnode) pointer */
	138	devnode_t * de_parent; /* backpointer to the directory itself */
	139	devdirent_t * de_next; /* next object in this directory */
	140	devdirent_t * de_prevp; / previous pointer in directory linked list */
	141	devdirent_t * de_nextlink; /* next hardlink to this node */
	142	devdirent_t * de_prevlinkp; / previous hardlink pointer for this node */
	143	};
	144
	145	extern devdirent_t * dev_root;
	146	extern struct lock__bsd__ devfs_lock;
	147	extern struct devfs_stats devfs_stats;
	148
	149	/*
	150	* Rules for front nodes:
	151	* Dirs hava a strict 1:1 relationship with their OWN devnode
	152	* Symlinks similarly
	153	* Device Nodes ALWAYS point to the devnode that is linked
	154	* to the Backing node. (with a ref count)
	155	*/
	156
	157	/*
	158	* DEVFS specific per/mount information, used to link a monted fs to a
	159	* particular 'plane' of front nodes.
	160	*/
	161	struct devfsmount
	162	{
	163	struct mount * mount; /* vfs mount struct for this fs */
	164	devdirent_t * plane_root;/* the root of this 'plane' */
	165	};
	166
	167	/*
	168	* Prototypes for DEVFS virtual filesystem operations
	169	*/
	170	#include <sys/lock.h>
	171	#include <miscfs/devfs/devfs_proto.h>
	172
	173	//#define HIDDEN_MOUNTPOINT 1
	174
	175	/* misc */
	176	#define M_DEVFSNAME M_DEVFS
	177	#define M_DEVFSNODE M_DEVFS
	178	#define M_DEVFSMNT M_DEVFS
	179
1c79356b	180	#define VTODN(vp) ((devnode_t *)(vp)->v_data)
1c79356b A	181
	182	static __inline__ int
	183	DEVFS_LOCK(struct proc * p)
	184	{
	185	return (lockmgr(&devfs_lock, LK_EXCLUSIVE, NULL, p));
	186	}
	187
	188	static __inline__ int
	189	DEVFS_UNLOCK(struct proc * p)
	190	{
	191	return (lockmgr(&devfs_lock, LK_RELEASE, NULL, p));
	192	}
	193
	194	static __inline__ void
	195	DEVFS_INCR_ENTRIES()
	196	{
	197	devfs_stats.entries++;
	198	}
	199
	200	static __inline__ void
	201	DEVFS_DECR_ENTRIES()
	202	{
	203	devfs_stats.entries--;
	204	}
	205
	206	static __inline__ void
	207	DEVFS_INCR_NODES()
	208	{
	209	devfs_stats.nodes++;
	210	}
	211
	212	static __inline__ void
	213	DEVFS_DECR_NODES()
	214	{
	215	devfs_stats.nodes--;
	216	}
	217
	218	static __inline__ void
	219	DEVFS_INCR_MOUNTS()
	220	{
	221	devfs_stats.mounts++;
	222	}
	223
	224	static __inline__ void
	225	DEVFS_DECR_MOUNTS()
	226	{
	227	devfs_stats.mounts--;
	228	}
	229
	230	static __inline__ void
	231	DEVFS_INCR_STRINGSPACE(int space)
	232	{
	233	devfs_stats.stringspace += space;
	234	}
	235
	236	static __inline__ void
	237	DEVFS_DECR_STRINGSPACE(int space)
	238	{
	239	devfs_stats.stringspace -= space;
	240	if (devfs_stats.stringspace < 0) {
	241	printf("DEVFS_DECR_STRINGSPACE: (%d - %d < 0)\n",
	242	devfs_stats.stringspace + space, space);
	243	devfs_stats.stringspace = 0;
	244	}
245	}
246
247	static __inline__ void
248	dn_times(devnode_t * dnp, struct timeval t1, struct timeval t2)
249	{
250	if (dnp->dn_flags & (DN_ACCESS \| DN_CHANGE \| DN_UPDATE)) {
251	if (dnp->dn_flags & DN_ACCESS) {
252	dnp->dn_atime.tv_sec = t1.tv_sec;
253	dnp->dn_atime.tv_nsec = t1.tv_usec * 1000;
254	}
255	if (dnp->dn_flags & DN_UPDATE) {
256	dnp->dn_mtime.tv_sec = t2.tv_sec;
257	dnp->dn_mtime.tv_nsec = t2.tv_usec * 1000;
258	}
259	if (dnp->dn_flags & DN_CHANGE) {
260	dnp->dn_ctime.tv_sec = time.tv_sec;
261	dnp->dn_ctime.tv_nsec = time.tv_usec * 1000;
262	}
263	dnp->dn_flags &= ~(DN_ACCESS \| DN_CHANGE \| DN_UPDATE);
264	}
265	return;
266	}
267
268	static __inline__ void
269	dn_copy_times(devnode_t * target, devnode_t * source)
270	{
271	target->dn_atime = source->dn_atime;
272	target->dn_mtime = source->dn_mtime;
273	target->dn_ctime = source->dn_ctime;
274	return;
275	}
9bccf70c A	276	#endif /* __APPLE_API_PRIVATE */
9bccf70c A	277	#endif /* __DEVFS_DEVFSDEFS_H__ */