]> git.saurik.com Git - apple/xnu.git/blobdiff - bsd/miscfs/devfs/devfs.h
xnu-7195.101.1.tar.gz
[apple/xnu.git] / bsd / miscfs / devfs / devfs.h
index c76d8544ac224d3b2421a1ae5e5c9c338b25edeb..ea9e80edf7b0ed762e28ac6e9988a3827e985ad6 100644 (file)
@@ -1,28 +1,34 @@
 /*
  * 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
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
+ *
+ * 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.
+ *
+ * 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,
- * 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@
+ * 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_OSREFERENCE_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:
@@ -31,7 +37,7 @@
  *  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
  * 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.
- * 
+ *
  * miscfs/devfs/devfs.h
  */
 
 #ifndef _MISCFS_DEVFS_DEVFS_H_
-#define        _MISCFS_DEVFS_DEVFS_H_
+#define _MISCFS_DEVFS_DEVFS_H_
 
 #include <sys/appleapiopts.h>
+#include <sys/cdefs.h>
+
+#define DEVFS_CHAR      0
+#define DEVFS_BLOCK     1
 
-#ifdef __APPLE_API_UNSTABLE
-#define DEVFS_CHAR     0
-#define DEVFS_BLOCK    1
+/*
+ * Argument to clone callback after dev
+ */
+#define DEVFS_CLONE_ALLOC       1       /* Allocate minor number slot */
+#define DEVFS_CLONE_FREE        0       /* Free minor number slot */
 
 __BEGIN_DECLS
 
+/*
+ * Function: devfs_make_node_clone
+ *
+ * Purpose
+ *   Create a device node with the given pathname in the devfs namespace;
+ *   before returning a dev_t value for an open instance, the dev_t has
+ *   it's minor number updated by calling the supplied clone function on
+ *   the supplied dev..
+ *
+ * Parameters:
+ *   dev        - the dev_t value to associate
+ *   chrblk    - block or character device (DEVFS_CHAR or DEVFS_BLOCK)
+ *   uid, gid  - ownership
+ *   perms     - permissions
+ *   clone     - minor number cloning function
+ *   fmt, ...  - print format string and args to format the path name
+ * Returns:
+ *   A handle to a device node if successful, NULL otherwise.
+ */
+void *  devfs_make_node_clone(dev_t dev, int chrblk, uid_t uid, gid_t gid,
+    int perms, int (*clone)(dev_t dev, int action),
+    const char *fmt, ...);
+
 /*
  * Function: devfs_make_node
  *
@@ -65,7 +100,7 @@ __BEGIN_DECLS
  *   Create a device node with the given pathname in the devfs namespace.
  *
  * Parameters:
- *   dev       - the dev_t value to associate
+ *   dev        - the dev_t value to associate
  *   chrblk    - block or character device (DEVFS_CHAR or DEVFS_BLOCK)
  *   uid, gid  - ownership
  *   perms     - permissions
@@ -73,9 +108,10 @@ __BEGIN_DECLS
  * Returns:
  *   A handle to a device node if successful, NULL otherwise.
  */
-void *         devfs_make_node __P((dev_t dev, int chrblk, uid_t uid, gid_t gid, 
-                            int perms, char *fmt, ...));
+void *  devfs_make_node(dev_t dev, int chrblk, uid_t uid, gid_t gid,
+    int perms, const char *fmt, ...);
 
+#ifdef BSD_KERNEL_PRIVATE
 /*
  * Function: devfs_make_link
  *
@@ -85,7 +121,8 @@ void *       devfs_make_node __P((dev_t dev, int chrblk, uid_t uid, gid_t gid,
  * Returns:
  *   0 if successful, -1 if failed
  */
-int    devfs_link __P((void * handle, char *fmt, ...));
+int     devfs_make_link(void * handle, char *fmt, ...);
+#endif /* BSD_KERNEL_PRIVATE */
 
 /*
  * Function: devfs_remove
@@ -94,24 +131,27 @@ int        devfs_link __P((void * handle, char *fmt, ...));
  *   Remove the device node returned by devfs_make_node() along with
  *   any links created with devfs_make_link().
  */
-void   devfs_remove __P((void * handle));
+void    devfs_remove(void * handle);
 
 __END_DECLS
-#endif /* __APPLE_API_UNSTABLE */
 
 #ifdef __APPLE_API_PRIVATE
 /* XXX */
-#define        UID_ROOT        0
-#define        UID_BIN         3
-#define        UID_UUCP        66
+#define UID_ROOT        0
+#define UID_BIN         3
+#define UID_UUCP        66
+#define UID_LOGD        272
 
 /* XXX */
-#define        GID_WHEEL       0
-#define        GID_KMEM        2
-#define        GID_OPERATOR    5
-#define        GID_BIN         7
-#define        GID_GAMES       13
-#define        GID_DIALER      68
+#define GID_WHEEL       0
+#define GID_KMEM        2
+#define GID_TTY         4
+#define GID_OPERATOR    5
+#define GID_BIN         7
+#define GID_GAMES       13
+#define GID_DIALER      68
+#define GID_WINDOWSERVER 88
+#define GID_LOGD        272
 #endif /* __APPLE_API_PRIVATE */
 
 #endif /* !_MISCFS_DEVFS_DEVFS_H_ */