vget(9)

NAME

vget — get a vnode from the free list

SYNOPSIS

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

int
vget(struct vnode *vp, int flags);

DESCRIPTION

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

Its arguments are:

vp

The vnode to remove from the free list.

flags

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.

ERRORS

[ENOENT]

The vnode vp is in the process of being cleaned out from the underlying file system.

[EBUSY]

The vnode vp is in the process of being cleaned out from the underlying file system, and it wasn't possible to sleep on it because the LK_NOWAIT flag was specified.

SEE ALSO

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

AUTHORS

This man page was originally written by Doug Rabson for FreeBSD.