NAME    [Toc]    [Back]

     vget -- get a vnode from the free list

SYNOPSIS    [Toc]    [Back]

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

     int
     vget(struct vnode *vp, int lockflag, struct thread *td);

DESCRIPTION    [Toc]    [Back]

     Get a vnode from the free list and increment its reference count.

     vp        the vnode to remove from the free list

     lockflag  if non-zero, the vnode will also be locked

     When not in use, vnodes are kept on a free list.  The vnodes still reference
 valid files but may be reused to refer to a new file at any time.
     Often, these vnodes are also held in caches in the system, such as the
     name cache.

     When a vnode which is on the free list is used again, for instance if the
     vnode was found in the name cache as a result of a call to VOP_LOOKUP(9)
     then the new user must call vget() to increment the reference count and
     remove it from the free list.

SEE ALSO    [Toc]    [Back]

     vnode(9), vput(9), vref(9), vrele(9)

AUTHORS    [Toc]    [Back]

     This man page was written by Doug Rabson.


FreeBSD 5.2.1			 July 24, 1996			 FreeBSD 5.2.1