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>.