vrefl(9)

vrefl9

Increment the use count for a vnode

Part of vref(9).

Usage

#include <sys/param.h>

#include <sys/vnode.h>

void

vref(struct vnode *vp);

void

vrefl(struct vnode *vp);

Overview

Increment the v_usecount field of a vnode.

vp

the vnode to increment

Each vnode maintains a reference count of how many parts of the system are using the vnode. This allows the system to detect when a vnode is no longer being used and can be safely recycled for a different file.

Any code in the system which is using a vnode (e.g. during the operation of some algorithm or to store in a data structure) should call vref() or vrefl().

vref() locks the vnode interlock while vrefl() expects the interlock to already be held.

Releases

24 releases since FreeBSD 11.1-RELEASE; the text changed 10 times.

  1. 11.1
  2. 11.2
  3. 11.3
  4. 11.4
  5. 12.0
  6. 12.1
  7. 12.2
  8. 12.3
  9. 12.4
  10. 13.0–13.2
  11. 13.3–16.0

Authors

This manual page was written by Doug Rabson.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.