xnu-3789.1.32.tar.gz

[apple/xnu.git] / bsd / sys / vnode.h

diff --git a/bsd/sys/vnode.h b/bsd/sys/vnode.h
index bc8b67337798ea9611f3fc95ccb8d13b564e3454..72da264c4ecddb80799cdda81a9a54db7948ddf7 100644 (file)
--- a/bsd/sys/vnode.h
+++ b/bsd/sys/vnode.h
@@ -1,5 +1,5 @@
 /*
 /*

- * Copyright (c) 2000-2014 Apple Inc. All rights reserved.
+ * Copyright (c) 2000-2016 Apple Inc. All rights reserved.

  *
  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
  * 
  *
  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
  * 


@@ -108,11 +108,10 @@ enum vtagtype     {
        VT_KERNFS, VT_PROCFS, VT_AFS, VT_ISOFS, VT_MOCKFS,
        /* 16 - 20 */
        VT_HFS, VT_ZFS, VT_DEVFS, VT_WEBDAV, VT_UDF, 
        VT_KERNFS, VT_PROCFS, VT_AFS, VT_ISOFS, VT_MOCKFS,
        /* 16 - 20 */
        VT_HFS, VT_ZFS, VT_DEVFS, VT_WEBDAV, VT_UDF, 

-       /* 21 - 24 */
-       VT_AFP, VT_CDDA, VT_CIFS, VT_OTHER
+       /* 21 - 25 */
+       VT_AFP, VT_CDDA, VT_CIFS, VT_OTHER, VT_APFS

 };
 
 };
 

-

 /*
  * flags for VNOP_BLOCKMAP
  */
 /*
  * flags for VNOP_BLOCKMAP
  */


@@ -358,7 +357,7 @@ extern int vfs_resolver_auxiliary(resolver_result_t);
  @param vp The trigger vnode which needs resolving
  @param cnp Various data about lookup, e.g. filename and state flags
  @param pop The pathname operation that initiated the lookup (see enum path_operation).
  @param vp The trigger vnode which needs resolving
  @param cnp Various data about lookup, e.g. filename and state flags
  @param pop The pathname operation that initiated the lookup (see enum path_operation).

- @param flags
+ @param flags resolve flags

  @param data Arbitrary data supplied by vnode trigger creator
  @param ctx Context for authentication.
  @return RESOLVER_RESOLVED, RESOLVER_NOCHANGE, RESOLVER_UNRESOLVED or RESOLVER_ERROR
  @param data Arbitrary data supplied by vnode trigger creator
  @param ctx Context for authentication.
  @return RESOLVER_RESOLVED, RESOLVER_NOCHANGE, RESOLVER_UNRESOLVED or RESOLVER_ERROR


@@ -394,7 +393,7 @@ typedef resolver_result_t (* trigger_vnode_unresolve_callback_t)(
  @discussion This function is associated with a trigger vnode during a vnode create.  It is
  called to verify a rearm from VFS (i.e. should VFS rearm the trigger?).
  @param vp The trigger vnode which needs rearming
  @discussion This function is associated with a trigger vnode during a vnode create.  It is
  called to verify a rearm from VFS (i.e. should VFS rearm the trigger?).
  @param vp The trigger vnode which needs rearming

- @param flags
+ @param flags rearm flags

  @param data Arbitrary data supplied by vnode trigger creator
  @param ctx Context for authentication.
  @return RESOLVER_NOCHANGE or RESOLVER_ERROR
  @param data Arbitrary data supplied by vnode trigger creator
  @param ctx Context for authentication.
  @return RESOLVER_NOCHANGE or RESOLVER_ERROR


@@ -700,7 +699,8 @@ struct vnode_attr {
 #define        VA_UTIMES_NULL          0x010000        /* utimes argument was NULL */
 #define VA_EXCLUSIVE           0x020000        /* exclusive create request */
 #define VA_NOINHERIT           0x040000        /* Don't inherit ACLs from parent */
 #define        VA_UTIMES_NULL          0x010000        /* utimes argument was NULL */
 #define VA_EXCLUSIVE           0x020000        /* exclusive create request */
 #define VA_NOINHERIT           0x040000        /* Don't inherit ACLs from parent */

-#define VA_NOAUTH              0x080000        
+#define VA_NOAUTH              0x080000
+#define VA_64BITOBJIDS         0x100000        /* fileid/linkid/parentid are 64 bit */

 
 /*
  *  Modes.  Some values same as Ixxx entries from inode.h for now.
 
 /*
  *  Modes.  Some values same as Ixxx entries from inode.h for now.


@@ -806,7 +806,7 @@ __BEGIN_DECLS
  @param vpp  Pointer to a vnode pointer, to be filled in with newly created vnode.
  @return 0 for success, error code otherwise.
  */
  @param vpp  Pointer to a vnode pointer, to be filled in with newly created vnode.
  @return 0 for success, error code otherwise.
  */

-errno_t        vnode_create(uint32_t, uint32_t, void  *, vnode_t *);
+errno_t        vnode_create(uint32_t flavor, uint32_t size, void  *data, vnode_t *vpp);

 
 #if KERNEL_PRIVATE
 /*!
 
 #if KERNEL_PRIVATE
 /*!


@@ -822,7 +822,7 @@ errno_t     vnode_create(uint32_t, uint32_t, void  *, vnode_t *);
  @param vpp  Pointer to a vnode pointer, to be filled in with newly created vnode.
  @return 0 for success, error code otherwise.
  */
  @param vpp  Pointer to a vnode pointer, to be filled in with newly created vnode.
  @return 0 for success, error code otherwise.
  */

-errno_t        vnode_create_empty(vnode_t *);
+errno_t        vnode_create_empty(vnode_t *vpp);

 
 /*!
  @function vnode_initialize
 
 /*!
  @function vnode_initialize


@@ -836,7 +836,7 @@ errno_t     vnode_create_empty(vnode_t *);
  @param vpp  Pointer to a vnode pointer, to be filled in with newly created vnode.
  @return 0 for success, error code otherwise.
  */
  @param vpp  Pointer to a vnode pointer, to be filled in with newly created vnode.
  @return 0 for success, error code otherwise.
  */

-errno_t        vnode_initialize(uint32_t, uint32_t, void  *, vnode_t *);
+errno_t        vnode_initialize(uint32_t flavor, uint32_t size, void *data, vnode_t *vpp);

 #endif /* KERNEL_PRIVATE */
 
 /*!
 #endif /* KERNEL_PRIVATE */
 
 /*!


@@ -848,7 +848,7 @@ errno_t     vnode_initialize(uint32_t, uint32_t, void  *, vnode_t *);
  @param vp The vnode to mark.
  @return Always 0.
  */
  @param vp The vnode to mark.
  @return Always 0.
  */

-int    vnode_addfsref(vnode_t);
+int    vnode_addfsref(vnode_t vp);

 
 /*!
  @function vnode_removefsref
 
 /*!
  @function vnode_removefsref


@@ -857,7 +857,7 @@ int vnode_addfsref(vnode_t);
  @param vp The vnode to unmark.
  @return Always 0.
  */
  @param vp The vnode to unmark.
  @return Always 0.
  */

-int    vnode_removefsref(vnode_t);
+int    vnode_removefsref(vnode_t vp);

 
 /*!
  @function vnode_hasdirtyblks 
 
 /*!
  @function vnode_hasdirtyblks 


@@ -866,7 +866,7 @@ int vnode_removefsref(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if there are dirty blocks, 0 otherwise
  */
  @param vp The vnode to test.
  @return Nonzero if there are dirty blocks, 0 otherwise
  */

-int    vnode_hasdirtyblks(vnode_t);
+int    vnode_hasdirtyblks(vnode_t vp);

 
 /*!
  @function vnode_hascleanblks
 
 /*!
  @function vnode_hascleanblks


@@ -875,7 +875,7 @@ int vnode_hasdirtyblks(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if there are clean blocks, 0 otherwise.
  */
  @param vp The vnode to test.
  @return Nonzero if there are clean blocks, 0 otherwise.
  */

-int    vnode_hascleanblks(vnode_t);
+int    vnode_hascleanblks(vnode_t vp);

 
 #define        VNODE_ASYNC_THROTTLE    15
 /*!
 
 #define        VNODE_ASYNC_THROTTLE    15
 /*!


@@ -888,24 +888,22 @@ int       vnode_hascleanblks(vnode_t);
  @param msg String to pass  msleep() .
  @return 0 for success, or an error value from msleep().
  */
  @param msg String to pass  msleep() .
  @return 0 for success, or an error value from msleep().
  */

-int    vnode_waitforwrites(vnode_t, int, int, int, const char *);
+int    vnode_waitforwrites(vnode_t vp, int output_target, int slpflag, int slptimeout, const char *msg);

 
 /*!
  @function vnode_startwrite
  @abstract Increment the count of pending writes on a vnode.
  @param vp The vnode whose count to increment.
 
 /*!
  @function vnode_startwrite
  @abstract Increment the count of pending writes on a vnode.
  @param vp The vnode whose count to increment.

- @return void.

  */
  */

-void   vnode_startwrite(vnode_t);
+void   vnode_startwrite(vnode_t vp);

 
 /*!
  @function vnode_startwrite
  @abstract Decrement the count of pending writes on a vnode .
  @discussion Also wakes up threads waiting for the write count to drop, as in vnode_waitforwrites.
  @param vp The vnode whose count to decrement.
 
 /*!
  @function vnode_startwrite
  @abstract Decrement the count of pending writes on a vnode .
  @discussion Also wakes up threads waiting for the write count to drop, as in vnode_waitforwrites.
  @param vp The vnode whose count to decrement.

- @return void.

  */
  */

-void   vnode_writedone(vnode_t);
+void   vnode_writedone(vnode_t vp);

 
 /*!
  @function vnode_vtype
 
 /*!
  @function vnode_vtype


@@ -913,7 +911,7 @@ void        vnode_writedone(vnode_t);
  @param vp The vnode whose type to grab.
  @return The vnode's type.
  */
  @param vp The vnode whose type to grab.
  @return The vnode's type.
  */

-enum vtype     vnode_vtype(vnode_t);
+enum vtype     vnode_vtype(vnode_t vp);

 
 /*!
  @function vnode_vid
 
 /*!
  @function vnode_vid


@@ -921,7 +919,7 @@ enum vtype  vnode_vtype(vnode_t);
  @param vp The vnode whose vid to grab.
  @return The vnode's vid.
  */
  @param vp The vnode whose vid to grab.
  @return The vnode's vid.
  */

-uint32_t       vnode_vid(vnode_t);
+uint32_t       vnode_vid(vnode_t vp);

 
 /*!
  @function vnode_mountedhere
 
 /*!
  @function vnode_mountedhere


@@ -937,7 +935,7 @@ mount_t     vnode_mountedhere(vnode_t vp);
  @param vp The vnode whose mount to grab.
  @return The mount, directly.
  */
  @param vp The vnode whose mount to grab.
  @return The mount, directly.
  */

-mount_t        vnode_mount(vnode_t);
+mount_t        vnode_mount(vnode_t vp);

 
 /*!
  @function vnode_specrdev
 
 /*!
  @function vnode_specrdev


@@ -945,7 +943,7 @@ mount_t     vnode_mount(vnode_t);
  @param vp The vnode whose device id to extract--vnode must be a special file.
  @return The device id.
  */
  @param vp The vnode whose device id to extract--vnode must be a special file.
  @return The device id.
  */

-dev_t  vnode_specrdev(vnode_t);
+dev_t  vnode_specrdev(vnode_t vp);

 
 /*!
  @function vnode_fsnode
 
 /*!
  @function vnode_fsnode


@@ -953,16 +951,15 @@ dev_t     vnode_specrdev(vnode_t);
  @param vp The vnode whose data to grab.
  @return The filesystem-specific data, directly.
  */
  @param vp The vnode whose data to grab.
  @return The filesystem-specific data, directly.
  */

-void * vnode_fsnode(vnode_t);
+void * vnode_fsnode(vnode_t vp);

 
 /*!
  @function vnode_clearfsnode
  @abstract Sets a vnode's filesystem-specific data to be NULL.
  @discussion This routine should only be called when a vnode is no longer in use, i.e. during a VNOP_RECLAIM.
  @param vp The vnode whose data to clear out.
 
 /*!
  @function vnode_clearfsnode
  @abstract Sets a vnode's filesystem-specific data to be NULL.
  @discussion This routine should only be called when a vnode is no longer in use, i.e. during a VNOP_RECLAIM.
  @param vp The vnode whose data to clear out.

- @return void.

  */
  */

-void   vnode_clearfsnode(vnode_t);
+void   vnode_clearfsnode(vnode_t vp);

 
 /*!
  @function vnode_isvroot
 
 /*!
  @function vnode_isvroot


@@ -970,7 +967,7 @@ void        vnode_clearfsnode(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if the vnode is the root, 0 if it is not.
  */
  @param vp The vnode to test.
  @return Nonzero if the vnode is the root, 0 if it is not.
  */

-int    vnode_isvroot(vnode_t);
+int    vnode_isvroot(vnode_t vp);

 
 /*!
  @function vnode_issystem
 
 /*!
  @function vnode_issystem


@@ -978,7 +975,7 @@ int vnode_isvroot(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if the vnode is a system vnode, 0 if it is not.
  */
  @param vp The vnode to test.
  @return Nonzero if the vnode is a system vnode, 0 if it is not.
  */

-int    vnode_issystem(vnode_t);
+int    vnode_issystem(vnode_t vp);

 
 /*!
  @function vnode_ismount
 
 /*!
  @function vnode_ismount


@@ -987,7 +984,7 @@ int vnode_issystem(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if there is a mount in progress, 0 otherwise.
  */
  @param vp The vnode to test.
  @return Nonzero if there is a mount in progress, 0 otherwise.
  */

-int    vnode_ismount(vnode_t);
+int    vnode_ismount(vnode_t vp);

 
 /*!
  @function vnode_isreg
 
 /*!
  @function vnode_isreg


@@ -995,7 +992,7 @@ int vnode_ismount(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if the vnode is of type VREG, 0 otherwise.
  */
  @param vp The vnode to test.
  @return Nonzero if the vnode is of type VREG, 0 otherwise.
  */

-int    vnode_isreg(vnode_t);
+int    vnode_isreg(vnode_t vp);

 
 /*!
  @function vnode_isdir
 
 /*!
  @function vnode_isdir


@@ -1003,7 +1000,7 @@ int       vnode_isreg(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if the vnode is of type VDIR, 0 otherwise.
  */
  @param vp The vnode to test.
  @return Nonzero if the vnode is of type VDIR, 0 otherwise.
  */

-int    vnode_isdir(vnode_t);
+int    vnode_isdir(vnode_t vp);

 
 /*!
  @function vnode_islnk
 
 /*!
  @function vnode_islnk


@@ -1011,7 +1008,7 @@ int       vnode_isdir(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if the vnode is of type VLNK, 0 otherwise.
  */
  @param vp The vnode to test.
  @return Nonzero if the vnode is of type VLNK, 0 otherwise.
  */

-int    vnode_islnk(vnode_t);
+int    vnode_islnk(vnode_t vp);

 
 /*!
  @function vnode_isfifo
 
 /*!
  @function vnode_isfifo


@@ -1019,7 +1016,7 @@ int       vnode_islnk(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if the vnode is of type VFIFO, 0 otherwise.
  */
  @param vp The vnode to test.
  @return Nonzero if the vnode is of type VFIFO, 0 otherwise.
  */

-int    vnode_isfifo(vnode_t);
+int    vnode_isfifo(vnode_t vp);

 
 /*!
  @function vnode_isblk
 
 /*!
  @function vnode_isblk


@@ -1027,7 +1024,7 @@ int       vnode_isfifo(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if the vnode is of type VBLK, 0 otherwise.
  */
  @param vp The vnode to test.
  @return Nonzero if the vnode is of type VBLK, 0 otherwise.
  */

-int    vnode_isblk(vnode_t);
+int    vnode_isblk(vnode_t vp);

 
 /*!
  @function vnode_ischr
 
 /*!
  @function vnode_ischr


@@ -1035,7 +1032,7 @@ int       vnode_isblk(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if the vnode is of type VCHR, 0 otherwise.
  */
  @param vp The vnode to test.
  @return Nonzero if the vnode is of type VCHR, 0 otherwise.
  */

-int    vnode_ischr(vnode_t);
+int    vnode_ischr(vnode_t vp);

 
 /*!
  @function vnode_isswap
 
 /*!
  @function vnode_isswap


@@ -1052,7 +1049,7 @@ int       vnode_isswap(vnode_t vp);
  @param vp The vnode to test.
  @return Nonzero if the vnode is a named stream, 0 otherwise.
  */
  @param vp The vnode to test.
  @return Nonzero if the vnode is a named stream, 0 otherwise.
  */

-int    vnode_isnamedstream(vnode_t);
+int    vnode_isnamedstream(vnode_t vp);

 #endif
 
 /*!
 #endif
 
 /*!


@@ -1062,24 +1059,22 @@ int     vnode_isnamedstream(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if the vnode is a block device on which an filesystem is mounted, 0 otherwise.
  */
  @param vp The vnode to test.
  @return Nonzero if the vnode is a block device on which an filesystem is mounted, 0 otherwise.
  */

-int    vnode_ismountedon(vnode_t);
+int    vnode_ismountedon(vnode_t vp);

 
 /*!
  @function vnode_setmountedon
  @abstract Set flags indicating that a block device vnode has been mounted as a filesystem.
  @discussion A block device marked as being mounted on cannot be opened.
  @param vp The vnode to set flags on, a block device.
 
 /*!
  @function vnode_setmountedon
  @abstract Set flags indicating that a block device vnode has been mounted as a filesystem.
  @discussion A block device marked as being mounted on cannot be opened.
  @param vp The vnode to set flags on, a block device.

- @return void.

  */
  */

-void   vnode_setmountedon(vnode_t);
+void   vnode_setmountedon(vnode_t vp);

 
 /*!
  @function vnode_clearmountedon
  @abstract Clear flags indicating that a block device vnode has been mounted as a filesystem.
  @param vp The vnode to clear flags on, a block device.
 
 /*!
  @function vnode_clearmountedon
  @abstract Clear flags indicating that a block device vnode has been mounted as a filesystem.
  @param vp The vnode to clear flags on, a block device.

- @return void.

  */
  */

-void   vnode_clearmountedon(vnode_t);
+void   vnode_clearmountedon(vnode_t vp);

 
 /*!
  @function vnode_isrecycled
 
 /*!
  @function vnode_isrecycled


@@ -1088,7 +1083,7 @@ void      vnode_clearmountedon(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if vnode is dead or being recycled, 0 otherwise.
  */
  @param vp The vnode to test.
  @return Nonzero if vnode is dead or being recycled, 0 otherwise.
  */

-int    vnode_isrecycled(vnode_t);
+int    vnode_isrecycled(vnode_t vp);

 
 /*!
  @function vnode_isnocache
 
 /*!
  @function vnode_isnocache


@@ -1096,7 +1091,7 @@ int       vnode_isrecycled(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if vnode is set to not have data chached, 0 otherwise.
  */
  @param vp The vnode to test.
  @return Nonzero if vnode is set to not have data chached, 0 otherwise.
  */

-int    vnode_isnocache(vnode_t);
+int    vnode_isnocache(vnode_t vp);

 
 /*!
  @function vnode_israge
 
 /*!
  @function vnode_israge


@@ -1104,7 +1099,7 @@ int       vnode_isnocache(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if vnode is marked for rapid aging, 0 otherwise
  */
  @param vp The vnode to test.
  @return Nonzero if vnode is marked for rapid aging, 0 otherwise
  */

-int    vnode_israge(vnode_t);
+int    vnode_israge(vnode_t vp);

 
 /*!
  @function vnode_needssnapshots
 
 /*!
  @function vnode_needssnapshots


@@ -1112,23 +1107,21 @@ int     vnode_israge(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if vnode needs snapshot events, 0 otherwise
  */
  @param vp The vnode to test.
  @return Nonzero if vnode needs snapshot events, 0 otherwise
  */

-int    vnode_needssnapshots(vnode_t);
+int    vnode_needssnapshots(vnode_t vp);

 
 /*!
  @function vnode_setnocache
  @abstract Set a vnode to not have its data cached in memory (i.e. we write-through to disk and always read from disk).
  @param vp The vnode whose flags to set.
 
 /*!
  @function vnode_setnocache
  @abstract Set a vnode to not have its data cached in memory (i.e. we write-through to disk and always read from disk).
  @param vp The vnode whose flags to set.

- @return void.

  */
  */

-void   vnode_setnocache(vnode_t);
+void   vnode_setnocache(vnode_t vp);

 
 /*!
  @function vnode_clearnocache
  @abstract Clear the flag on a vnode indicating that data should not be cached in memory (i.e. we write-through to disk and always read from disk).
  @param vp The vnode whose flags to clear.
 
 /*!
  @function vnode_clearnocache
  @abstract Clear the flag on a vnode indicating that data should not be cached in memory (i.e. we write-through to disk and always read from disk).
  @param vp The vnode whose flags to clear.

- @return void.

  */
  */

-void   vnode_clearnocache(vnode_t);
+void   vnode_clearnocache(vnode_t vp);

 
 /*!
  @function vnode_isnoreadahead
 
 /*!
  @function vnode_isnoreadahead


@@ -1136,75 +1129,67 @@ void    vnode_clearnocache(vnode_t);
  @param vp The vnode to test.
  @return Nonzero if readahead is disabled, 0 otherwise.
  */
  @param vp The vnode to test.
  @return Nonzero if readahead is disabled, 0 otherwise.
  */

-int    vnode_isnoreadahead(vnode_t);
+int    vnode_isnoreadahead(vnode_t vp);

 
 /*!
  @function vnode_setnoreadahead
  @abstract Set a vnode to not have data speculatively read in in hopes of hitting in cache.
  @param vp The vnode on which to prevent readahead.
 
 /*!
  @function vnode_setnoreadahead
  @abstract Set a vnode to not have data speculatively read in in hopes of hitting in cache.
  @param vp The vnode on which to prevent readahead.

- @return void.

  */
  */

-void   vnode_setnoreadahead(vnode_t);
+void   vnode_setnoreadahead(vnode_t vp);

 
 /*!
  @function vnode_clearnoreadahead
  @abstract Clear the flag indicating that a vnode should not have data speculatively read in.
  @param vp The vnode whose flag to clear.
 
 /*!
  @function vnode_clearnoreadahead
  @abstract Clear the flag indicating that a vnode should not have data speculatively read in.
  @param vp The vnode whose flag to clear.

- @return void.

  */
  */

-void   vnode_clearnoreadahead(vnode_t);
+void   vnode_clearnoreadahead(vnode_t vp);

 
 /*!
  @function vnode_isfastdevicecandidate
  @abstract Check if a vnode is a candidate to store on the fast device of a composite disk system
  @param vp The vnode which you want to test.
  @return Nonzero if the vnode is marked as a fast-device candidate
 
 /*!
  @function vnode_isfastdevicecandidate
  @abstract Check if a vnode is a candidate to store on the fast device of a composite disk system
  @param vp The vnode which you want to test.
  @return Nonzero if the vnode is marked as a fast-device candidate

- @return void.

  */
  */

-int    vnode_isfastdevicecandidate(vnode_t);
+int    vnode_isfastdevicecandidate(vnode_t vp);

 
 /*!
  @function vnode_setfastdevicecandidate
  @abstract Mark a vnode as a candidate to store on the fast device of a composite disk system
 
 /*!
  @function vnode_setfastdevicecandidate
  @abstract Mark a vnode as a candidate to store on the fast device of a composite disk system

- @abstract If the vnode is a directory, all its children will inherit this bit.
+ @discussion If the vnode is a directory, all its children will inherit this bit.

  @param vp The vnode which you want marked.
  @param vp The vnode which you want marked.

- @return void.

  */
  */

-void   vnode_setfastdevicecandidate(vnode_t);
+void   vnode_setfastdevicecandidate(vnode_t vp);

 
 /*!
  @function vnode_clearfastdevicecandidate
  @abstract Clear the status of a vnode being a candidate to store on the fast device of a composite disk system.
  @param vp The vnode whose flag to clear.
 
 /*!
  @function vnode_clearfastdevicecandidate
  @abstract Clear the status of a vnode being a candidate to store on the fast device of a composite disk system.
  @param vp The vnode whose flag to clear.

- @return void.

  */
  */

-void   vnode_clearfastdevicecandidate(vnode_t);
+void   vnode_clearfastdevicecandidate(vnode_t vp);

 
 /*!
  @function vnode_isautocandidate
  @abstract Check if a vnode was automatically selected to be fast-dev candidate (see vnode_setfastdevicecandidate)
  @param vp The vnode which you want to test.
  @return Nonzero if the vnode was automatically marked as a fast-device candidate
 
 /*!
  @function vnode_isautocandidate
  @abstract Check if a vnode was automatically selected to be fast-dev candidate (see vnode_setfastdevicecandidate)
  @param vp The vnode which you want to test.
  @return Nonzero if the vnode was automatically marked as a fast-device candidate

- @return void.

  */
  */

-int    vnode_isautocandidate(vnode_t);
+int    vnode_isautocandidate(vnode_t vp);

 
 /*!
  @function vnode_setfastdevicecandidate
  @abstract Mark a vnode as an automatically selected candidate for storing on the fast device of a composite disk system
 
 /*!
  @function vnode_setfastdevicecandidate
  @abstract Mark a vnode as an automatically selected candidate for storing on the fast device of a composite disk system

- @abstract If the vnode is a directory, all its children will inherit this bit.
+ @discussion If the vnode is a directory, all its children will inherit this bit.

  @param vp The vnode which you want marked.
  @param vp The vnode which you want marked.

- @return void.

  */
  */

-void   vnode_setautocandidate(vnode_t);
+void   vnode_setautocandidate(vnode_t vp);

 
 /*!
  @function vnode_clearautocandidate
  @abstract Clear the status of a vnode being an automatic candidate (see above)
  @param vp The vnode whose flag to clear.
 
 /*!
  @function vnode_clearautocandidate
  @abstract Clear the status of a vnode being an automatic candidate (see above)
  @param vp The vnode whose flag to clear.

- @return void.

  */
  */

-void   vnode_clearautocandidate(vnode_t);
+void   vnode_clearautocandidate(vnode_t vp);

 
 /* left only for compat reasons as User code depends on this from getattrlist, for ex */
 
 
 /* left only for compat reasons as User code depends on this from getattrlist, for ex */
 


@@ -1213,9 +1198,8 @@ void      vnode_clearautocandidate(vnode_t);
  @abstract Set a vnode filesystem-specific "tag."
  @discussion Sets a tag indicating which filesystem a vnode belongs to, e.g. VT_HFS, VT_UDF, VT_ZFS.  The kernel never inspects this data, though the filesystem tags are defined in vnode.h; it is for the benefit of user programs via getattrlist.
  @param vp The vnode whose tag to set.
  @abstract Set a vnode filesystem-specific "tag."
  @discussion Sets a tag indicating which filesystem a vnode belongs to, e.g. VT_HFS, VT_UDF, VT_ZFS.  The kernel never inspects this data, though the filesystem tags are defined in vnode.h; it is for the benefit of user programs via getattrlist.
  @param vp The vnode whose tag to set.

- @return void.

  */
  */

-void   vnode_settag(vnode_t, int);
+void   vnode_settag(vnode_t vp, int tag);

 
 /*!
  @function vnode_tag
 
 /*!
  @function vnode_tag


@@ -1224,7 +1208,7 @@ void      vnode_settag(vnode_t, int);
  @param vp The vnode whose tag to grab.
  @return The tag.
  */
  @param vp The vnode whose tag to grab.
  @return The tag.
  */

-int    vnode_tag(vnode_t);
+int    vnode_tag(vnode_t vp);

 
 /*!
  @function vnode_getattr
 
 /*!
  @function vnode_getattr


@@ -1261,7 +1245,6 @@ vnode_t vfs_rootvnode(void);
  @abstract Clear out cached credentials on a vnode.
  @discussion When we authorize an action on a vnode, we cache the credential that was authorized and the actions it was authorized for in case a similar request follows.  This function destroys that caching.
  @param vp The vnode whose cache to clear.
  @abstract Clear out cached credentials on a vnode.
  @discussion When we authorize an action on a vnode, we cache the credential that was authorized and the actions it was authorized for in case a similar request follows.  This function destroys that caching.
  @param vp The vnode whose cache to clear.

- @return void.

  */
 void   vnode_uncache_credentials(vnode_t vp);
 
  */
 void   vnode_uncache_credentials(vnode_t vp);
 


@@ -1270,7 +1253,6 @@ void      vnode_uncache_credentials(vnode_t vp);
  @abstract Mark a vnode as being reachable by multiple paths, i.e. as a hard link.
  @discussion "Multipath" vnodes can be reached through more than one entry in the filesystem, and so must be handled differently for caching and event notification purposes.  A filesystem should mark a vnode with multiple hardlinks this way.
  @param vp The vnode to mark.
  @abstract Mark a vnode as being reachable by multiple paths, i.e. as a hard link.
  @discussion "Multipath" vnodes can be reached through more than one entry in the filesystem, and so must be handled differently for caching and event notification purposes.  A filesystem should mark a vnode with multiple hardlinks this way.
  @param vp The vnode to mark.

- @return void.

  */
 void   vnode_setmultipath(vnode_t vp);
 
  */
 void   vnode_setmultipath(vnode_t vp);
 


@@ -1280,7 +1262,7 @@ void      vnode_setmultipath(vnode_t vp);
  @param vp The vnode for which to get filesystem symlink size cap.
  @return Max symlink length.
  */
  @param vp The vnode for which to get filesystem symlink size cap.
  @return Max symlink length.
  */

-uint32_t  vnode_vfsmaxsymlen(vnode_t);
+uint32_t  vnode_vfsmaxsymlen(vnode_t vp);

 
 /*!
  @function vnode_vfsisrdonly
 
 /*!
  @function vnode_vfsisrdonly


@@ -1288,7 +1270,7 @@ uint32_t  vnode_vfsmaxsymlen(vnode_t);
  @param vp The vnode for which to get filesystem writeability.
  @return Nonzero if the filesystem is read-only, 0 otherwise.
  */
  @param vp The vnode for which to get filesystem writeability.
  @return Nonzero if the filesystem is read-only, 0 otherwise.
  */

-int    vnode_vfsisrdonly(vnode_t);
+int    vnode_vfsisrdonly(vnode_t vp);

 
 /*!
  @function vnode_vfstypenum
 
 /*!
  @function vnode_vfstypenum


@@ -1297,16 +1279,15 @@ int     vnode_vfsisrdonly(vnode_t);
  @param vp The vnode whose filesystem to examine.
  @return The type number of the fileystem to which the vnode belongs.
  */
  @param vp The vnode whose filesystem to examine.
  @return The type number of the fileystem to which the vnode belongs.
  */

-int    vnode_vfstypenum(vnode_t);
+int    vnode_vfstypenum(vnode_t vp);

 
 /*!
  @function vnode_vfsname
  @abstract Get the name of the filesystem to which a vnode belongs.
  @param vp The vnode whose filesystem to examine.
  @param buf Destination for vfs name: should have size MFSNAMELEN or greater.
 
 /*!
  @function vnode_vfsname
  @abstract Get the name of the filesystem to which a vnode belongs.
  @param vp The vnode whose filesystem to examine.
  @param buf Destination for vfs name: should have size MFSNAMELEN or greater.

- @return The name of the fileystem to which the vnode belongs.

  */
  */

-void   vnode_vfsname(vnode_t, char *);
+void   vnode_vfsname(vnode_t vp, char *buf);

 
 /*!
  @function vnode_vfs64bitready
 
 /*!
  @function vnode_vfs64bitready


@@ -1314,7 +1295,7 @@ void      vnode_vfsname(vnode_t, char *);
  @param vp The vnode whose filesystem to examine.
  @return Nonzero if filesystem is marked ready for 64-bit interactions; 0 otherwise.
  */
  @param vp The vnode whose filesystem to examine.
  @return Nonzero if filesystem is marked ready for 64-bit interactions; 0 otherwise.
  */

-int    vnode_vfs64bitready(vnode_t);
+int    vnode_vfs64bitready(vnode_t vp);

 
 /* These should move to private ... not documenting for now */
 int    vfs_context_get_special_port(vfs_context_t, int, ipc_port_t *);
 
 /* These should move to private ... not documenting for now */
 int    vfs_context_get_special_port(vfs_context_t, int, ipc_port_t *);


@@ -1326,7 +1307,7 @@ int       vfs_context_set_special_port(vfs_context_t, int, ipc_port_t);
  @param ctx Context whose associated process to find.
  @return Process if available, NULL otherwise.
  */
  @param ctx Context whose associated process to find.
  @return Process if available, NULL otherwise.
  */

-proc_t vfs_context_proc(vfs_context_t);
+proc_t vfs_context_proc(vfs_context_t ctx);

 
 /*!
  @function vfs_context_ucred
 
 /*!
  @function vfs_context_ucred


@@ -1335,7 +1316,7 @@ proc_t    vfs_context_proc(vfs_context_t);
  @param ctx Context whose associated process to find.
  @returns credential if process available; NULL otherwise
  */
  @param ctx Context whose associated process to find.
  @returns credential if process available; NULL otherwise
  */

-kauth_cred_t   vfs_context_ucred(vfs_context_t);
+kauth_cred_t   vfs_context_ucred(vfs_context_t ctx);

 
 /*!
  @function vfs_context_pid
 
 /*!
  @function vfs_context_pid


@@ -1343,7 +1324,7 @@ kauth_cred_t      vfs_context_ucred(vfs_context_t);
  @param ctx Context whose associated process to find.
  @return Process id.
  */
  @param ctx Context whose associated process to find.
  @return Process id.
  */

-int    vfs_context_pid(vfs_context_t);
+int    vfs_context_pid(vfs_context_t ctx);

 
 /*!
  @function vfs_context_issignal
 
 /*!
  @function vfs_context_issignal


@@ -1352,7 +1333,7 @@ int       vfs_context_pid(vfs_context_t);
  @param ctx Context whose associated process to find.
  @return Bitfield of pending signals.
  */
  @param ctx Context whose associated process to find.
  @return Bitfield of pending signals.
  */

-int    vfs_context_issignal(vfs_context_t, sigset_t);
+int    vfs_context_issignal(vfs_context_t ctx, sigset_t mask);

 
 /*!
  @function vfs_context_suser
 
 /*!
  @function vfs_context_suser


@@ -1360,7 +1341,7 @@ int       vfs_context_issignal(vfs_context_t, sigset_t);
  @param ctx Context to examine.
  @return Nonzero if context belongs to superuser, 0 otherwise.
  */
  @param ctx Context to examine.
  @return Nonzero if context belongs to superuser, 0 otherwise.
  */

-int    vfs_context_suser(vfs_context_t);
+int    vfs_context_suser(vfs_context_t ctx);

 
 /*!
  @function vfs_context_is64bit
 
 /*!
  @function vfs_context_is64bit


@@ -1368,7 +1349,7 @@ int       vfs_context_suser(vfs_context_t);
  @param ctx Context to examine.
  @return Nonzero if context is of 64-bit process, 0 otherwise.
  */
  @param ctx Context to examine.
  @return Nonzero if context is of 64-bit process, 0 otherwise.
  */

-int    vfs_context_is64bit(vfs_context_t);
+int    vfs_context_is64bit(vfs_context_t ctx);

 
 /*!
  @function vfs_context_create
 
 /*!
  @function vfs_context_create


@@ -1377,7 +1358,7 @@ int       vfs_context_is64bit(vfs_context_t);
  @param ctx Context to copy, or NULL to use information from running thread.
  @return The new context, or NULL in the event of failure.
  */
  @param ctx Context to copy, or NULL to use information from running thread.
  @return The new context, or NULL in the event of failure.
  */

-vfs_context_t vfs_context_create(vfs_context_t);
+vfs_context_t vfs_context_create(vfs_context_t ctx);

 
 /*!
  @function vfs_context_rele
 
 /*!
  @function vfs_context_rele


@@ -1386,7 +1367,7 @@ vfs_context_t vfs_context_create(vfs_context_t);
  @param ctx Context to release.
  @return Always 0.
  */
  @param ctx Context to release.
  @return Always 0.
  */

-int vfs_context_rele(vfs_context_t);
+int vfs_context_rele(vfs_context_t ctx);

 
 /*!
  @function vfs_context_current
 
 /*!
  @function vfs_context_current


@@ -1483,7 +1464,7 @@ int vnode_getwithvid_drainok(vnode_t, uint32_t);
  recycled. An iocount is required for any operation on a vnode.
  @return 0 for success, ENOENT if the vnode is dead, in the process of being reclaimed, or has been recycled and reused.
  */
  recycled. An iocount is required for any operation on a vnode.
  @return 0 for success, ENOENT if the vnode is dead, in the process of being reclaimed, or has been recycled and reused.
  */

-int    vnode_getwithref(vnode_t);
+int    vnode_getwithref(vnode_t vp);

 
 /*!
  @function vnode_put
 
 /*!
  @function vnode_put


@@ -1493,7 +1474,7 @@ int       vnode_getwithref(vnode_t);
  @param vp The vnode whose iocount to drop.
  @return Always 0.
  */
  @param vp The vnode whose iocount to drop.
  @return Always 0.
  */

-int    vnode_put(vnode_t);
+int    vnode_put(vnode_t vp);

 
 /*!
  @function vnode_ref
 
 /*!
  @function vnode_ref


@@ -1506,7 +1487,7 @@ int       vnode_put(vnode_t);
  @param vp The vnode on which to obtain a persistent reference.
  @return 0 for success; ENOENT if the vnode is dead or in the process of being recycled AND the calling thread is not the vnode owner.
  */
  @param vp The vnode on which to obtain a persistent reference.
  @return 0 for success; ENOENT if the vnode is dead or in the process of being recycled AND the calling thread is not the vnode owner.
  */

-int    vnode_ref(vnode_t);
+int    vnode_ref(vnode_t vp);

 
 /*!
  @function vnode_rele
 
 /*!
  @function vnode_rele


@@ -1515,9 +1496,8 @@ int       vnode_ref(vnode_t);
  opens the door for a vnode to be reused as a new file; it also triggers a VNOP_INACTIVE call to the filesystem,
  though that will not happen immediately if there are outstanding iocount references.
  @param vp The vnode whose usecount to drop.
  opens the door for a vnode to be reused as a new file; it also triggers a VNOP_INACTIVE call to the filesystem,
  though that will not happen immediately if there are outstanding iocount references.
  @param vp The vnode whose usecount to drop.

- @return void.

  */
  */

-void   vnode_rele(vnode_t);
+void   vnode_rele(vnode_t vp);

 
 /*!
  @function vnode_isinuse
 
 /*!
  @function vnode_isinuse


@@ -1530,9 +1510,8 @@ void      vnode_rele(vnode_t);
  may no longer be correct the very moment that the caller receives it.
  @param vp The vnode whose use-status to check.
  @param refcnt The threshold for saying that a vnode is in use.
  may no longer be correct the very moment that the caller receives it.
  @param vp The vnode whose use-status to check.
  @param refcnt The threshold for saying that a vnode is in use.

- @return void.

  */
  */

-int    vnode_isinuse(vnode_t, int);
+int    vnode_isinuse(vnode_t vp, int refcnt);

 
 /*!
  @function vnode_recycle
 
 /*!
  @function vnode_recycle


@@ -1542,7 +1521,7 @@ int       vnode_isinuse(vnode_t, int);
  @param vp The vnode to recycle.
  @return 1 if the vnode was reclaimed (i.e. there were no existing references), 0 if it was only marked for future reclaim.
  */
  @param vp The vnode to recycle.
  @return 1 if the vnode was reclaimed (i.e. there were no existing references), 0 if it was only marked for future reclaim.
  */

-int    vnode_recycle(vnode_t);
+int    vnode_recycle(vnode_t vp);

 
 #ifdef KERNEL_PRIVATE
 
 
 #ifdef KERNEL_PRIVATE
 


@@ -1579,7 +1558,7 @@ int       vnode_recycle(vnode_t);
  @discussion Will not reenter the filesystem.
  @return Zero if not monitored, nonzero if monitored.
  */ 
  @discussion Will not reenter the filesystem.
  @return Zero if not monitored, nonzero if monitored.
  */ 

-int    vnode_ismonitored(vnode_t);
+int    vnode_ismonitored(vnode_t vp);

 
 
 /*!
 
 
 /*!


@@ -1589,7 +1568,7 @@ int       vnode_ismonitored(vnode_t);
  @discussion Will not reenter the filesystem.
  @return nonzero if a dyld shared cache file, zero otherwise.
  */ 
  @discussion Will not reenter the filesystem.
  @return nonzero if a dyld shared cache file, zero otherwise.
  */ 

-int    vnode_isdyldsharedcache(vnode_t);
+int    vnode_isdyldsharedcache(vnode_t vp);

 
 
 /*!
 
 
 /*!


@@ -1626,7 +1605,6 @@ int       vn_getpath_fsenter(struct vnode *vp, char *pathbuf, int *len);
  @param name_hashval Hash value of name, if known.  Passing 0 causes the cache to hash the name itself.
  @param flags VNODE_UPDATE_PARENT: set parent.  VNODE_UPDATE_NAME: set name.  VNODE_UPDATE_CACHE: flush cache entries for hard links
  associated with this file.  VNODE_UPDATE_PURGE: flush cache entries for hard links and children of this file.
  @param name_hashval Hash value of name, if known.  Passing 0 causes the cache to hash the name itself.
  @param flags VNODE_UPDATE_PARENT: set parent.  VNODE_UPDATE_NAME: set name.  VNODE_UPDATE_CACHE: flush cache entries for hard links
  associated with this file.  VNODE_UPDATE_PURGE: flush cache entries for hard links and children of this file.

- @return void.

  */
 void   vnode_update_identity(vnode_t vp, vnode_t dvp, const char *name, int name_len, uint32_t name_hashval, int flags);
 
  */
 void   vnode_update_identity(vnode_t vp, vnode_t dvp, const char *name, int name_len, uint32_t name_hashval, int flags);
 


@@ -1650,7 +1628,7 @@ int       vn_bwrite(struct vnop_bwrite_args *ap);
  @param ctx Context for which to authorize actions.
  @return EACCESS if permission is denied.  0 if operation allowed.  Various errors from lower layers.
  */
  @param ctx Context for which to authorize actions.
  @return EACCESS if permission is denied.  0 if operation allowed.  Various errors from lower layers.
  */

-int    vnode_authorize(vnode_t /*vp*/, vnode_t /*dvp*/, kauth_action_t, vfs_context_t);
+int    vnode_authorize(vnode_t vp, vnode_t dvp, kauth_action_t action, vfs_context_t ctx);

 
 /*!
  @function vnode_authattr
 
 /*!
  @function vnode_authattr


@@ -1664,7 +1642,7 @@ int       vnode_authorize(vnode_t /*vp*/, vnode_t /*dvp*/, kauth_action_t, vfs_context
  @param ctx Context for which to authorize actions.
  @return 0 (and a result in "actionp" for success.  Otherwise, an error code.
  */
  @param ctx Context for which to authorize actions.
  @return 0 (and a result in "actionp" for success.  Otherwise, an error code.
  */

-int    vnode_authattr(vnode_t, struct vnode_attr *, kauth_action_t *, vfs_context_t);
+int    vnode_authattr(vnode_t vp, struct vnode_attr *vap, kauth_action_t *actionp, vfs_context_t ctx);

 
 /*!
  @function vnode_authattr_new
 
 /*!
  @function vnode_authattr_new


@@ -1677,7 +1655,7 @@ int       vnode_authattr(vnode_t, struct vnode_attr *, kauth_action_t *, vfs_context_t
  @param ctx Context for which to authorize actions.
  @return KAUTH_RESULT_ALLOW for success, an error to indicate invalid or disallowed attributes.
  */
  @param ctx Context for which to authorize actions.
  @return KAUTH_RESULT_ALLOW for success, an error to indicate invalid or disallowed attributes.
  */

-int    vnode_authattr_new(vnode_t /*dvp*/, struct vnode_attr *, int /*noauth*/, vfs_context_t);
+int    vnode_authattr_new(vnode_t dvp, struct vnode_attr *vap, int noauth, vfs_context_t ctx);

 
 /*!
  @function vnode_close
 
 /*!
  @function vnode_close


@@ -1689,7 +1667,7 @@ int       vnode_authattr_new(vnode_t /*dvp*/, struct vnode_attr *, int /*noauth*/, vfs
  @param ctx Context against which to validate operation.
  @return 0 for success or an error from the filesystem.
  */
  @param ctx Context against which to validate operation.
  @return 0 for success or an error from the filesystem.
  */

-errno_t vnode_close(vnode_t, int, vfs_context_t);
+errno_t vnode_close(vnode_t vp, int flags, vfs_context_t ctx);

 
 /*!
  @function vn_getpath
 
 /*!
  @function vn_getpath


@@ -1716,7 +1694,7 @@ int vn_getpath(struct vnode *vp, char *pathbuf, int *len);
  Will not reenter the filesystem.
  @return 0 for success, else an error code.
  */ 
  Will not reenter the filesystem.
  @return 0 for success, else an error code.
  */ 

-int    vnode_notify(vnode_t, uint32_t, struct vnode_attr*);
+int    vnode_notify(vnode_t vp, uint32_t events, struct vnode_attr *vap);

 
 /*!
  @function vfs_get_notify_attributes
 
 /*!
  @function vfs_get_notify_attributes


@@ -1742,7 +1720,7 @@ int       vfs_get_notify_attributes(struct vnode_attr *vap);
  @param flags VNODE_LOOKUP_NOFOLLOW: do not follow symbolic links.  VNODE_LOOKUP_NOCROSSMOUNT: do not cross mount points.
  @return Results 0 for success or an error code.
  */
  @param flags VNODE_LOOKUP_NOFOLLOW: do not follow symbolic links.  VNODE_LOOKUP_NOCROSSMOUNT: do not cross mount points.
  @return Results 0 for success or an error code.
  */

-errno_t vnode_lookup(const char *, int, vnode_t *, vfs_context_t);
+errno_t vnode_lookup(const char *path, int flags, vnode_t *vpp, vfs_context_t ctx);

 
 /*!
  @function vnode_open
 
 /*!
  @function vnode_open


@@ -1758,7 +1736,7 @@ errno_t vnode_lookup(const char *, int, vnode_t *, vfs_context_t);
  @param ctx Context with which to authorize open/creation.
  @return 0 for success or an error code.
  */
  @param ctx Context with which to authorize open/creation.
  @return 0 for success or an error code.
  */

-errno_t vnode_open(const char *, int, int, int, vnode_t *, vfs_context_t);
+errno_t vnode_open(const char *path, int fmode, int cmode, int flags, vnode_t *vpp, vfs_context_t ctx);

 
 /*
  * exported vnode operations
 
 /*
  * exported vnode operations


@@ -1785,7 +1763,7 @@ errno_t vnode_open(const char *, int, int, int, vnode_t *, vfs_context_t);
  @return Zero for success, else an error code.  Will return 0 immediately if there are no vnodes hooked into the mount.
  @discussion Skips vnodes which are dead, in the process of reclaim, suspended, or of type VNON.
  */
  @return Zero for success, else an error code.  Will return 0 immediately if there are no vnodes hooked into the mount.
  @discussion Skips vnodes which are dead, in the process of reclaim, suspended, or of type VNON.
  */

-int    vnode_iterate(struct mount *, int, int (*)(struct vnode *, void *), void *);
+int    vnode_iterate(struct mount *mp, int flags, int (*callout)(struct vnode *, void *), void *arg);

 
 /*
  * flags passed into vnode_iterate
 
 /*
  * flags passed into vnode_iterate


@@ -1824,7 +1802,7 @@ int       vnode_iterate(struct mount *, int, int (*)(struct vnode *, void *), void *);
  @param ctx Context against which to validate operation.
  @return 0 always.
  */
  @param ctx Context against which to validate operation.
  @return 0 always.
  */

-int    vn_revoke(vnode_t vp, int flags, vfs_context_t);
+int    vn_revoke(vnode_t vp, int flags, vfs_context_t ctx);

 
 /* namecache function prototypes */
 /*!
 
 /* namecache function prototypes */
 /*!


@@ -1850,7 +1828,6 @@ int       cache_lookup(vnode_t dvp, vnode_t *vpp, struct componentname *cnp);
  @param vp File to add to cache. A non-NULL vp is stored for rapid access; a NULL vp indicates 
  that there is no such file in the directory and speeds future failed lookups.
  @param cnp Various data about lookup, e.g. filename and intended operation.
  @param vp File to add to cache. A non-NULL vp is stored for rapid access; a NULL vp indicates 
  that there is no such file in the directory and speeds future failed lookups.
  @param cnp Various data about lookup, e.g. filename and intended operation.

- @return void.  

  */
 void   cache_enter(vnode_t dvp, vnode_t vp, struct componentname *cnp);
 
  */
 void   cache_enter(vnode_t dvp, vnode_t vp, struct componentname *cnp);
 


@@ -1860,7 +1837,6 @@ void      cache_enter(vnode_t dvp, vnode_t vp, struct componentname *cnp);
  @discussion Will flush all hardlinks to the vnode as well as all children (should any exist).  Logical 
  to use when cached data about a vnode becomes invalid, for instance in an unlink.
  @param vp The vnode to purge.
  @discussion Will flush all hardlinks to the vnode as well as all children (should any exist).  Logical 
  to use when cached data about a vnode becomes invalid, for instance in an unlink.
  @param vp The vnode to purge.

- @return void.  

  */
 void   cache_purge(vnode_t vp);
 
  */
 void   cache_purge(vnode_t vp);
 


@@ -1870,7 +1846,6 @@ void      cache_purge(vnode_t vp);
  @discussion Appropriate to use when negative cache information for a directory could have
  become invalid, e.g. after file creation.
  @param vp The vnode whose negative children to purge.
  @discussion Appropriate to use when negative cache information for a directory could have
  become invalid, e.g. after file creation.
  @param vp The vnode whose negative children to purge.

- @return void.  

  */
 void   cache_purge_negatives(vnode_t vp);
 
  */
 void   cache_purge_negatives(vnode_t vp);
 


@@ -1948,7 +1923,7 @@ int vn_searchfs_inappropriate_name(const char *name, int len);
  @param p Process requesting I/O.
  @return 0 for success; errors from filesystem, and EIO if did not perform all requested I/O and the "aresid" parameter is NULL.
  */
  @param p Process requesting I/O.
  @return 0 for success; errors from filesystem, and EIO if did not perform all requested I/O and the "aresid" parameter is NULL.
  */

-int    vn_rdwr(enum uio_rw, vnode_t, caddr_t, int, off_t, enum uio_seg, int, kauth_cred_t, int *, proc_t);
+int    vn_rdwr(enum uio_rw rw, struct vnode *vp, caddr_t base, int len, off_t offset, enum uio_seg segflg, int ioflg, kauth_cred_t cred, int *aresid, proc_t p);

 
 /*!
  @function vnode_getname
 
 /*!
  @function vnode_getname


@@ -1965,7 +1940,6 @@ const char        *vnode_getname(vnode_t vp);
  @abstract Release a reference on a name from the VFS cache.
  @discussion Should be called on a string obtained with vnode_getname().
  @param name String to release.
  @abstract Release a reference on a name from the VFS cache.
  @discussion Should be called on a string obtained with vnode_getname().
  @param name String to release.

- @return void.

  */
 void   vnode_putname(const char *name);
 
  */
 void   vnode_putname(const char *name);
 


@@ -1984,19 +1958,19 @@ vnode_t vnode_getparent(vnode_t vp);
  @function vnode_setdirty
  @abstract Mark the vnode as having data or metadata that needs to be written out during reclaim
  @discussion The vnode should be marked as dirty anytime a file system defers flushing of data or meta-data associated with it. 
  @function vnode_setdirty
  @abstract Mark the vnode as having data or metadata that needs to be written out during reclaim
  @discussion The vnode should be marked as dirty anytime a file system defers flushing of data or meta-data associated with it. 

- @param the vnode to mark as dirty
+ @param vp the vnode to mark as dirty

  @return 0 if successful else an error code.
  */
  @return 0 if successful else an error code.
  */

-int    vnode_setdirty(vnode_t);
+int    vnode_setdirty(vnode_t vp);

 
 /*!
  @function vnode_cleardirty
  @abstract Mark the vnode as clean i.e. all its data or metadata has been flushed
  @discussion The vnode should be marked as clean whenever the file system is done flushing data or meta-data associated with it.
 
 /*!
  @function vnode_cleardirty
  @abstract Mark the vnode as clean i.e. all its data or metadata has been flushed
  @discussion The vnode should be marked as clean whenever the file system is done flushing data or meta-data associated with it.

- @param the vnode to clear as being dirty
+ @param vp the vnode to clear as being dirty

  @return 0 if successful else an error code.
  */
  @return 0 if successful else an error code.
  */

-int    vnode_cleardirty(vnode_t);
+int    vnode_cleardirty(vnode_t vp);

 
 /*!
  @function vnode_isdirty
 
 /*!
  @function vnode_isdirty


@@ -2005,9 +1979,7 @@ int       vnode_cleardirty(vnode_t);
  @param vp the vnode to test.
  @return Non-zero if the vnode is dirty, 0 otherwise.
  */
  @param vp the vnode to test.
  @return Non-zero if the vnode is dirty, 0 otherwise.
  */

-int    vnode_isdirty(vnode_t);
-
-
+int    vnode_isdirty(vnode_t vp);

 
 #ifdef KERNEL_PRIVATE
 /*! 
 
 #ifdef KERNEL_PRIVATE
 /*! 


@@ -2030,10 +2002,20 @@ int vnode_lookup_continue_needed(vnode_t vp, struct componentname *cnp);
  */
 int vnode_istty(vnode_t vp);
 
  */
 int vnode_istty(vnode_t vp);
 

+/*!
+  @function bdevvp
+  @abstract create a vnode for a given dev_t
+  @result non-zero to indicate failure, vnode provided in *vpp arg
+  */
+int bdevvp (dev_t dev, struct vnode **vpp);
+

 /*
 /*

- * Get the context for the first kernel thread (private SPI)
+ @function vnode_getfromfd
+ @abstract get a vnode from a file descriptor
+ @result non-zero to indicate failure, vnode provided in *vpp arg

  */
  */

-vfs_context_t vfs_context_kernel(void);                /* get from 1st kernel thread */
+int vnode_getfromfd (vfs_context_t ctx, int fd, vnode_t *vpp);
+

 #endif /* KERNEL_PRIVATE */
 
 #ifdef BSD_KERNEL_PRIVATE
 #endif /* KERNEL_PRIVATE */
 
 #ifdef BSD_KERNEL_PRIVATE


@@ -2046,8 +2028,6 @@ int       vaccess(mode_t file_mode, uid_t uid, gid_t gid,
 int    check_mountedon(dev_t dev, enum vtype type, int  *errorp);
 int vn_getcdhash(struct vnode *vp, off_t offset, unsigned char *cdhash);
 void   vnode_reclaim(vnode_t);
 int    check_mountedon(dev_t dev, enum vtype type, int  *errorp);
 int vn_getcdhash(struct vnode *vp, off_t offset, unsigned char *cdhash);
 void   vnode_reclaim(vnode_t);

-int    vfs_context_issuser(vfs_context_t);
-vnode_t vfs_context_cwd(vfs_context_t);

 vnode_t        current_rootdir(void);
 vnode_t        current_workingdir(void);
 void   *vnode_vfsfsprivate(vnode_t);
 vnode_t        current_rootdir(void);
 vnode_t        current_workingdir(void);
 void   *vnode_vfsfsprivate(vnode_t);


@@ -2070,32 +2050,30 @@ boolean_t vnode_on_reliable_media(vnode_t);
  */
 vnode_t vnode_parent(vnode_t);
 void vnode_setparent(vnode_t, vnode_t);
  */
 vnode_t vnode_parent(vnode_t);
 void vnode_setparent(vnode_t, vnode_t);

+void vnode_setname(vnode_t, char *);
+/* XXX temporary until we can arrive at a KPI for NFS, Seatbelt */
+thread_t vfs_context_thread(vfs_context_t);
+#if CONFIG_IOSCHED
+vnode_t vnode_mountdevvp(vnode_t);
+#endif
+#endif /* BSD_KERNEL_PRIVATE */
+
+#ifdef KERNEL_PRIVATE

 /*!
  @function vnode_getname_printable
  @abstract Get a non-null printable name of a vnode.
 /*!
  @function vnode_getname_printable
  @abstract Get a non-null printable name of a vnode.

- @Used to make sure a printable name is returned for all vnodes. If a name exists or can be artificially created, the routine creates a new entry in the VFS namecache. Otherwise, the function returns an artificially created vnode name which is safer and easier to use. vnode_putname_printable() should be used to release names obtained by this routine. 
+ @Used to make sure a printable name is returned for all vnodes. If a name exists or can be artificially created, the routine creates a new entry in the VFS namecache. Otherwise, the function returns an artificially created vnode name which is safer and easier to use. vnode_putname_printable() should be used to release names obtained by this routine.

  @param vp The vnode whose name to grab.
  @return The printable name.
  */
 const char *vnode_getname_printable(vnode_t vp);
  @param vp The vnode whose name to grab.
  @return The printable name.
  */
 const char *vnode_getname_printable(vnode_t vp);

-

 /*!
  @function vnode_putname_printable
  @abstract Release a reference on a name from the VFS cache if it was added by the matching vnode_getname_printable() call.
  @param name String to release.
 /*!
  @function vnode_putname_printable
  @abstract Release a reference on a name from the VFS cache if it was added by the matching vnode_getname_printable() call.
  @param name String to release.

- @return void.

  */
 void vnode_putname_printable(const char *name);
  */
 void vnode_putname_printable(const char *name);

-void vnode_setname(vnode_t, char *);
-int vnode_isnoflush(vnode_t);
-void vnode_setnoflush(vnode_t);
-void vnode_clearnoflush(vnode_t);
-/* XXX temporary until we can arrive at a KPI for NFS, Seatbelt */
-thread_t vfs_context_thread(vfs_context_t);
-#if CONFIG_IOSCHED
-vnode_t vnode_mountdevvp(vnode_t);
-#endif
-#endif /* BSD_KERNEL_PRIVATE */
+#endif // KERNEL_PRIVATE

 
 /*
  * Helper functions for implementing VNOP_GETATTRLISTBULK for a filesystem
 
 /*
  * Helper functions for implementing VNOP_GETATTRLISTBULK for a filesystem


@@ -2108,18 +2086,18 @@ vnode_t vnode_mountdevvp(vnode_t);
  @param alp Pointer to attribute list structure.
  @param vap Pointer to vnode_attr structure.
  @param obj_vtype Type of object - If VNON is passed, then the type is ignored and common, file and dir attrs are used to initialise the vattrs. If set to VDIR, only common and directory attributes are used. For all other types, only common and file attrbutes are used.
  @param alp Pointer to attribute list structure.
  @param vap Pointer to vnode_attr structure.
  @param obj_vtype Type of object - If VNON is passed, then the type is ignored and common, file and dir attrs are used to initialise the vattrs. If set to VDIR, only common and directory attributes are used. For all other types, only common and file attrbutes are used.

- @param attr_fixed_sizep. Returns the fixed length required in the attrbute buffer for the object. NULL should be passed if it is not required.
+ @param attr_fixed_sizep Returns the fixed length required in the attrbute buffer for the object. NULL should be passed if it is not required.

  @param ctx vfs context of caller.
  @return error.
  */
  @param ctx vfs context of caller.
  @return error.
  */

-errno_t vfs_setup_vattr_from_attrlist(struct attrlist * /* alp */, struct vnode_attr * /* vap */, enum vtype /* obj_vtype */, ssize_t * /* attr_fixed_sizep */, vfs_context_t /* ctx */);
+errno_t vfs_setup_vattr_from_attrlist(struct attrlist *alp, struct vnode_attr *vap, enum vtype obj_vtype, ssize_t *attr_fixed_sizep, vfs_context_t ctx);

 
 /*!
  @function vfs_attr_pack
  @abstract Pack a vnode_attr structure into a buffer in the same format as getattrlist(2).
  @Used by a VNOP_GETATTRLISTBULK implementation to pack data provided into a vnode_attr structure into a buffer the way getattrlist(2) does.
  @param vp If available, the vnode for which the attributes are being given, NULL if vnode is not available (which will usually be the case for a VNOP_GETATTRLISTBULK implementation.
 
 /*!
  @function vfs_attr_pack
  @abstract Pack a vnode_attr structure into a buffer in the same format as getattrlist(2).
  @Used by a VNOP_GETATTRLISTBULK implementation to pack data provided into a vnode_attr structure into a buffer the way getattrlist(2) does.
  @param vp If available, the vnode for which the attributes are being given, NULL if vnode is not available (which will usually be the case for a VNOP_GETATTRLISTBULK implementation.

- @param auio - a uio_t initialised with one iovec..
+ @param uio - a uio_t initialised with one iovec..

  @param alp - Pointer to an attrlist structure.
  @param options - options for call (same as options for getattrlistbulk(2)).
  @param vap Pointer to a filled in vnode_attr structure. Data from the vnode_attr structure will be used to copy and lay out the data in the required format for getatrlistbulk(2) by this function.
  @param alp - Pointer to an attrlist structure.
  @param options - options for call (same as options for getattrlistbulk(2)).
  @param vap Pointer to a filled in vnode_attr structure. Data from the vnode_attr structure will be used to copy and lay out the data in the required format for getatrlistbulk(2) by this function.


@@ -2127,7 +2105,41 @@ errno_t vfs_setup_vattr_from_attrlist(struct attrlist * /* alp */, struct vnode_
  @param ctx vfs context of caller.
  @return error.
  */
  @param ctx vfs context of caller.
  @return error.
  */

-errno_t vfs_attr_pack(vnode_t /* vp */, uio_t /* uio */, struct attrlist * /* alp */, uint64_t /* options */, struct vnode_attr * /* vap */, void * /* fndesc */, vfs_context_t /* ctx */);
+errno_t vfs_attr_pack(vnode_t vp, uio_t uio, struct attrlist *alp, uint64_t options, struct vnode_attr *vap, void *fndesc, vfs_context_t ctx);
+
+#ifdef KERNEL_PRIVATE
+
+// Returns a value suitable, safe and consistent for tracing and logging
+vm_offset_t kdebug_vnode(vnode_t vp);
+int vn_pathconf(vnode_t, int, int32_t *, vfs_context_t);
+int vnode_should_flush_after_write(vnode_t vp, int ioflag);
+void vfs_setowner(mount_t mp, uid_t uid, gid_t gid);
+uint64_t vfs_idle_time(mount_t mp);
+// Required until XsanFS is fixed...
+#ifndef vnode_usecount
+int vnode_usecount(vnode_t vp);
+#endif
+int vnode_iocount(vnode_t vp);
+void vnode_rele_ext(vnode_t, int, int);
+int is_package_name(const char *name, int len);
+int    vfs_context_issuser(vfs_context_t);
+int vfs_context_iskernel(vfs_context_t);
+vfs_context_t vfs_context_kernel(void);                /* get from 1st kernel thread */
+vnode_t vfs_context_cwd(vfs_context_t);
+int vnode_isnoflush(vnode_t);
+void vnode_setnoflush(vnode_t);
+void vnode_clearnoflush(vnode_t);
+
+#define BUILDPATH_NO_FS_ENTER     0x1 /* Use cache values, do not enter file system */
+#define BUILDPATH_CHECKACCESS     0x2 /* Check if parents have search rights */
+#define BUILDPATH_CHECK_MOVED     0x4 /* Return EAGAIN if the parent hierarchy is modified */
+#define BUILDPATH_VOLUME_RELATIVE 0x8 /* Return path relative to the nearest mount point */
+
+int    build_path(vnode_t first_vp, char *buff, int buflen, int *outlen, int flags, vfs_context_t ctx);
+
+int vnode_issubdir(vnode_t vp, vnode_t dvp, int *is_subdir, vfs_context_t ctx);
+
+#endif // KERNEL_PRIVATE

 
 __END_DECLS
 
 
 __END_DECLS