xnu-2422.115.4.tar.gz

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

diff --git a/bsd/miscfs/devfs/devfsdefs.h b/bsd/miscfs/devfs/devfsdefs.h
index b104d69278fcc037754b04724786a8868f46d380..e8b12000a3ef0c85235311c9550512e7d370ec91 100644 (file)
--- a/bsd/miscfs/devfs/devfsdefs.h
+++ b/bsd/miscfs/devfs/devfsdefs.h
@@ -1,23 +1,29 @@
 /*
  * Copyright (c) 2000-2002 Apple Computer, Inc. All rights reserved.
  *
 /*
  * Copyright (c) 2000-2002 Apple Computer, Inc. All rights reserved.
  *

- * @APPLE_LICENSE_HEADER_START@
+ * @APPLE_OSREFERENCE_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 file contains Original Code and/or Modifications of Original Code
+ * as defined in and that are subject to the Apple Public Source License
+ * Version 2.0 (the 'License'). You may not use this file except in
+ * compliance with the License. The rights granted to you under the License
+ * may not be used to create, or enable the creation or redistribution of,
+ * unlawful or unlicensed copies of an Apple operating system, or to
+ * circumvent, violate, or enable the circumvention or violation of, any
+ * terms of an Apple operating system software license agreement.

  * 
  * 

- * This Original Code and all software distributed under the License are
- * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
+ * Please obtain a copy of the License at
+ * http://www.opensource.apple.com/apsl/ and read it before using this file.
+ * 
+ * The 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,
  * 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.
+ * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
+ * Please see the License for the specific language governing rights and
+ * limitations under the License.

  * 
  * 

- * @APPLE_LICENSE_HEADER_END@
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@

  */
 /*
  * Copyright 1997,1998 Julian Elischer.  All rights reserved.
  */
 /*
  * Copyright 1997,1998 Julian Elischer.  All rights reserved.


@@ -46,6 +52,12 @@
  * 
  * devfsdefs.h
  */
  * 
  * devfsdefs.h
  */

+/*
+ * NOTICE: This file was modified by McAfee Research in 2004 to introduce
+ * support for mandatory and extensible security protections.  This notice
+ * is included in support of clause 2.2 (b) of the Apple Public License,
+ * Version 2.0.
+ */

 
 /*
  * HISTORY
 
 /*
  * HISTORY


@@ -60,6 +72,9 @@
 
 #include  <sys/appleapiopts.h>
 
 
 #include  <sys/appleapiopts.h>
 

+#include <security/mac.h>
+
+__BEGIN_DECLS

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


@@ -68,7 +83,10 @@ typedef enum {
     DEV_DIR,
     DEV_BDEV,
     DEV_CDEV,
     DEV_DIR,
     DEV_BDEV,
     DEV_CDEV,

-    DEV_SLNK
+    DEV_SLNK,
+#if FDESC
+    DEV_DEVFD
+#endif /* FDESC */

 } devfstype_t;
 
 extern int (**devfs_vnodeop_p)(void *);        /* our own vector array for dirs */
 } devfstype_t;
 
 extern int (**devfs_vnodeop_p)(void *);        /* our own vector array for dirs */


@@ -104,7 +122,18 @@ union devnode_type {
 struct devnode
 {
     devfstype_t                dn_type;
 struct devnode
 {
     devfstype_t                dn_type;

-    int                        dn_flags;
+    /* 
+     * Number of vnodes that point to this devnode.  Note, we do not
+     * add another reference for a lookup which finds an existing
+     * vnode; a reference is added when a vnode is created and removed
+     * when a vnode is reclaimed.  A devnode will not be freed while
+     * there are outstanding references.  A refcount can be added to
+     * prevent the free of a devnode in situations where there is not
+     * guaranteed to be a vnode holding a ref, but it is important to
+        * make sure that a deferred delete eventually happens if it is
+        * blocked behind that reference.
+     */
+    int                        dn_refcount;

     u_short            dn_mode;
     uid_t              dn_uid; 
     gid_t              dn_gid;
     u_short            dn_mode;
     uid_t              dn_uid; 
     gid_t              dn_gid;


@@ -120,17 +149,18 @@ struct devnode
     devnode_t *                dn_nextsibling; /* the list of equivalent nodes */
     devnode_t * *      dn_prevsiblingp;/* backpointer for the above */
     devnode_type_t     dn_typeinfo;
     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 */

     int                        dn_change;
     int                        dn_update;
     int                        dn_access;
     int                        dn_change;
     int                        dn_update;
     int                        dn_access;

-  int                  dn_lflags;
+    int                        dn_lflags;
+    ino_t              dn_ino;
+    int                        (*dn_clone)(dev_t dev, int action); /* get minor # */
+    struct label *     dn_label;       /* security label */

 };
 
 };
 

-#define        DN_BUSY                 0x01

 #define        DN_DELETE               0x02
 #define        DN_CREATE               0x04
 #define        DN_DELETE               0x02
 #define        DN_CREATE               0x04

-#define        DN_CREATEWAIT   0x08
+#define        DN_CREATEWAIT           0x08

 
 
 struct devdirent
 
 
 struct devdirent


@@ -148,6 +178,7 @@ struct devdirent
 extern devdirent_t *           dev_root;
 extern struct devfs_stats      devfs_stats;
 extern lck_mtx_t               devfs_mutex;
 extern devdirent_t *           dev_root;
 extern struct devfs_stats      devfs_stats;
 extern lck_mtx_t               devfs_mutex;

+extern lck_mtx_t               devfs_attr_mutex;

 
 /*
  * Rules for front nodes:
 
 /*
  * Rules for front nodes:


@@ -172,6 +203,7 @@ struct devfsmount
  */
 #include <sys/lock.h>
 #include <miscfs/devfs/devfs_proto.h>
  */
 #include <sys/lock.h>
 #include <miscfs/devfs/devfs_proto.h>

+#include <libkern/OSAtomic.h>          /* required for OSAddAtomic() */

 
 //#define HIDDEN_MOUNTPOINT    1
 
 
 //#define HIDDEN_MOUNTPOINT    1
 


@@ -183,43 +215,46 @@ struct devfsmount
 #define VTODN(vp)      ((devnode_t *)(vp)->v_data)
 
 #define DEVFS_LOCK()   lck_mtx_lock(&devfs_mutex)
 #define VTODN(vp)      ((devnode_t *)(vp)->v_data)
 
 #define DEVFS_LOCK()   lck_mtx_lock(&devfs_mutex)

-

 #define DEVFS_UNLOCK() lck_mtx_unlock(&devfs_mutex)
 
 #define DEVFS_UNLOCK() lck_mtx_unlock(&devfs_mutex)
 

+#define DEVFS_ATTR_LOCK_SPIN() lck_mtx_lock_spin(&devfs_attr_mutex);
+#define DEVFS_ATTR_UNLOCK()    lck_mtx_unlock(&devfs_attr_mutex);

 
 

-
+/*
+ * XXX all the (SInt32 *) casts below assume sizeof(int) == sizeof(long)
+ */

 static __inline__ void
 static __inline__ void

-DEVFS_INCR_ENTRIES()
+DEVFS_INCR_ENTRIES(void)

 {
     OSAddAtomic(1, &devfs_stats.entries);
 }
 
 static __inline__ void
 {
     OSAddAtomic(1, &devfs_stats.entries);
 }
 
 static __inline__ void

-DEVFS_DECR_ENTRIES()
+DEVFS_DECR_ENTRIES(void)

 {
     OSAddAtomic(-1, &devfs_stats.entries);
 }
 
 static __inline__ void
 {
     OSAddAtomic(-1, &devfs_stats.entries);
 }
 
 static __inline__ void

-DEVFS_INCR_NODES()
+DEVFS_INCR_NODES(void)

 {
     OSAddAtomic(1, &devfs_stats.nodes);
 }
 
 static __inline__ void
 {
     OSAddAtomic(1, &devfs_stats.nodes);
 }
 
 static __inline__ void

-DEVFS_DECR_NODES()
+DEVFS_DECR_NODES(void)

 {
     OSAddAtomic(-1, &devfs_stats.nodes);
 }
 
 static __inline__ void
 {
     OSAddAtomic(-1, &devfs_stats.nodes);
 }
 
 static __inline__ void

-DEVFS_INCR_MOUNTS()
+DEVFS_INCR_MOUNTS(void)

 {
     OSAddAtomic(1, &devfs_stats.mounts);
 }
 
 static __inline__ void
 {
     OSAddAtomic(1, &devfs_stats.mounts);
 }
 
 static __inline__ void

-DEVFS_DECR_MOUNTS()
+DEVFS_DECR_MOUNTS(void)

 {
     OSAddAtomic(-1, &devfs_stats.mounts);
 }
 {
     OSAddAtomic(-1, &devfs_stats.mounts);
 }


@@ -236,35 +271,41 @@ DEVFS_DECR_STRINGSPACE(int space)
     OSAddAtomic(-space, &devfs_stats.stringspace);
 }
 
     OSAddAtomic(-space, &devfs_stats.stringspace);
 }
 

-static __inline__ void
-dn_times(devnode_t * dnp, struct timeval *t1, struct timeval *t2, struct timeval *t3) 
-{
-       if (dnp->dn_access) {
-           dnp->dn_atime.tv_sec = t1->tv_sec;
-           dnp->dn_atime.tv_nsec = t1->tv_usec * 1000;
-           dnp->dn_access = 0;
-       }
-       if (dnp->dn_update) {
-           dnp->dn_mtime.tv_sec = t2->tv_sec;
-           dnp->dn_mtime.tv_nsec = t2->tv_usec * 1000;
-           dnp->dn_update = 0;
-       }
-       if (dnp->dn_change) {
-           dnp->dn_ctime.tv_sec = t3->tv_sec;
-           dnp->dn_ctime.tv_nsec = t3->tv_usec * 1000;
-           dnp->dn_change = 0;
-       }
-
-       return;
-}
+/* 
+ * Access, change, and modify times are protected by a separate lock,
+ * which allows tty times to be updated (no more than once per second)
+ * in the I/O path without too much fear of contention.
+ *
+ * For getattr, update times to current time if the last update was recent; 
+ * preserve  legacy behavior that frequent stats can yield sub-second resolutions.  
+ * If the last time is old, however, we know that the event that triggered
+ * the need for an update was no more than 1s after the last update.  In that case,
+ * use (last update + 1s) as the time, avoiding the illusion that last update happened
+ * much later than it really did.
+ */
+#define DEVFS_LAZY_UPDATE_SECONDS      1
+
+#define DEVFS_UPDATE_CHANGE            0x1
+#define DEVFS_UPDATE_MOD               0x2
+#define DEVFS_UPDATE_ACCESS            0x4

 
 static __inline__ void
 dn_copy_times(devnode_t * target, devnode_t * source)
 {
 
 static __inline__ void
 dn_copy_times(devnode_t * target, devnode_t * source)
 {

+    DEVFS_ATTR_LOCK_SPIN();

     target->dn_atime = source->dn_atime;
     target->dn_mtime = source->dn_mtime;
     target->dn_ctime = source->dn_ctime;
     target->dn_atime = source->dn_atime;
     target->dn_mtime = source->dn_mtime;
     target->dn_ctime = source->dn_ctime;

+    DEVFS_ATTR_UNLOCK();

     return;
 }
     return;
 }

+
+#ifdef BSD_KERNEL_PRIVATE
+int    devfs_make_symlink(devnode_t *dir_p, char *name, int mode, char *target, devdirent_t **newent);
+#endif /* BSD_KERNEL_PRIVATE */
+

 #endif /* __APPLE_API_PRIVATE */
 #endif /* __APPLE_API_PRIVATE */

+
+__END_DECLS
+

 #endif /* __DEVFS_DEVFSDEFS_H__ */
 #endif /* __DEVFS_DEVFSDEFS_H__ */