getnewvnode(9) [osx man page]

GETNEWVNODE(9)						   BSD Kernel Developer's Manual					    GETNEWVNODE(9)

NAME

     getnewvnode -- get a new vnode

SYNOPSIS

     #include <sys/param.h>
     #include <sys/vnode.h>
     #include <sys/mount.h>

     int
     getnewvnode(const char *tag, struct mount *mp, vop_t **vops, struct vnode **vpp);

DESCRIPTION

     The getnewvnode() function initializes a new vnode, assigning it the vnode operations passed in vops.  The vnode is either freshly allocated,
     or taken from the head of the free list depending on the number of vnodes already in the system.

     The arguments to getnewvnode() are:

     tag   The file system type string.  This field should only be referenced for debugging or for userland utilities.

     mp    The mount point to add the new vnode to.

     vops  The vnode operations to assign to the new vnode.

     vpp   Points to the new vnode upon successful completion.

RETURN VALUES

     getnewvnode() returns 0 on success.  There are currently no failure conditions - that do not result in a panic.

AUTHORS

     This manual page was written by Chad David <davidc@acns.ab.ca>.

BSD
								 November 21, 2001							       BSD

INSMNTQUE(9)						   BSD Kernel Developer's Manual					      INSMNTQUE(9)

NAME

     insmntque, insmntque1 -- associate a vnode with a mount

SYNOPSIS

     #include <sys/param.h>
     #include <sys/vnode.h>

     int
     insmntque(struct vnode *vp, struct mount *mp);

     int
     insmntque1(struct vnode *vp, struct mount *mp, void (*dtr)(struct vnode *, void *), void *dtr_arg);

DESCRIPTION

     The insmntque() function associates a vnode with a mount.	This includes updating v_mount for the vnode, and inserting the vnode into the
     mount's vnode list.

     The mount reference count is incremented for each vnode added to the mount, and that reference is decremented by vgone(9).

     The mount's interlock is held while the vnode is inserted.  For MP-safe file systems, the vnode must be exclusively locked.

     On failure, insmntque() calls vgone(9) on the supplied vnode, and then drops the vnode lock and reference.  If more elaborated cleanup after
     insmntque() failure is needed, the insmntque1() function may be used instead.  The dtr argument is a pointer to a function that is called on
     failure.  This function may perform any custom cleanup.  The vnode pointer is supplied as the first argument to dtr.  The dtr_arg argument is
     the second, supplying any additional context needed.

RETURN VALUES

     The insmntque() function will always return 0, unless the file system is currently being unmounted in which case it may return EBUSY.  Also,
     insmntque() may be forced to insert the vnode into the mount's vnode list by setting the VV_FORCEINSMQ flag in the vnode v_flag, even if the
     file system is being unmounted.

SEE ALSO

     vgone(9)

AUTHORS

     This manual page was written by Chad David <davidc@acns.ab.ca>.

BSD
								 September 8, 2008							       BSD