vget(9)

Usage

#include <sys/param.h>

#include <sys/vnode.h>

int

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

Overview

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.

Referred to by

vput(9) decrement the use count for a vnode and unlock it vref(9) increment the use count for a vnode vnode(9) internal representation of a file or directory vrele(9) decrement the use count for a vnode VFS_VGET(9) convert an inode number to a vnode VFS_FHTOVP(9) turn an NFS filehandle into a vnode VREF(9) increment the use count for a vnode VREF(9freebsd) increment the use count for a vnode vput(9freebsd) decrement the use count for a vnode vref(9freebsd) increment the use count for a vnode vnode(9freebsd) internal representation of a file or directory vrefl(9) increment the use count for a vnode vrefl(9freebsd) increment the use count for a vnode vrele(9freebsd) decrement the use count for a vnode vunref(9) decrement the use count for a vnode vunref(9freebsd) decrement the use count for a vnode vrefcnt(9) returns the use count of a vnode vrefcnt(9freebsd) returns the use count of a vnode VFS_VGET(9freebsd) convert an inode number to a vnode VFS_FHTOVP(9freebsd) turn an NFS filehandle into a vnode

Usage

Overview

See also

Mentioned on this page

Referred to by