o Document vdropl(9) [1].

o Add an MLINK for vdropl().

Reviewed by:	des [1]
Obtained from:	wording from vgone(9)
This commit is contained in:
Maxim Konovalov 2007-04-01 09:48:59 +00:00
parent ca117b4022
commit 8ad9c32345
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=168203
2 changed files with 24 additions and 5 deletions

View file

@ -1182,7 +1182,8 @@ MLINKS+=vfs_getopt.9 vfs_getopts.9 \
vfs_getopt.9 vfs_filteropt.9
MLINKS+=VFS_LOCK_GIANT.9 VFS_UNLOCK_GIANT.9
MLINKS+=vgone.9 vgonel.9
MLINKS+=vhold.9 vdrop.9
MLINKS+=vhold.9 vdrop.9 \
vhold.9 vdropl.9
MLINKS+=vm_map_lock.9 vm_map_lock_downgrade.9 \
vm_map_lock.9 vm_map_lock_read.9 \
vm_map_lock.9 vm_map_lock_upgrade.9 \

View file

@ -26,11 +26,11 @@
.\"
.\" $FreeBSD$
.\"
.Dd November 21, 2001
.Dd April 1, 2007
.Dt VHOLD 9
.Os
.Sh NAME
.Nm vhold , vdrop
.Nm vhold , vdrop , vdropl
.Nd "acquire/release a hold on a vnode"
.Sh SYNOPSIS
.In sys/param.h
@ -39,6 +39,8 @@
.Fn vhold "struct vnode *vp"
.Ft void
.Fn vdrop "struct vnode *vp"
.Ft void
.Fn vdropl "struct vnode *vp"
.Sh DESCRIPTION
The
.Fn vhold
@ -50,13 +52,29 @@ it will be removed.
.Pp
The
.Fn vdrop
function decrements the
and
.Fn vdropl
functions decrement the
.Va v_holdcnt
of the vnode.
If the holdcount is less than or equal to zero prior to calling
.Fn vdrop ,
.Fn vdrop
or
.Fn vdropl ,
the system will panic.
If the vnode is no longer referenced, it will be freed.
.Pp
The difference between
.Fn vdrop
and
.Fn vdropl
is that
.Fn vdrop
locks the vnode interlock and then calls
.Fn vdropl
while
.Fn vdropl
expects the interlock to already be locked.
.Sh SEE ALSO
.Xr vbusy 9 ,
.Xr vfree 9