d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Stop documenting vgonel() after its converting to the static function:

Browse Source 
svn r147332 (by jeff): "Don't make vgonel() globally visible".
While here, specify the vnode locking scheme for vgone().

Discussed on:	freebsd-hackers@
Approved by:	kib (mentor)
MFC after:	10 days
This commit is contained in:
Sergey Kandaurov 2010-11-12 12:07:36 +00:00
parent dbc4240942
commit 396a7f5025
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=215176
4 changed files with 11 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
ObsoleteFiles.inc
View File

@ -14,6 +14,8 @@
# The file is partitioned: OLD_FILES first, then OLD_LIBS and OLD_DIRS last.
#
# 20101112: vgonel(9) has gone to private API a while ago
OLD_FILES+=usr/share/man/man9/vgonel.9.gz
# 20101112: removed gasp.info
OLD_FILES+=usr/share/info/gasp.info.gz
# 20101109: headers moved to machine/ to x86/

1
share/man/man9/Makefile
View File

@ -1318,7 +1318,6 @@ MLINKS+=vfs_getopt.9 vfs_copyopt.9 \
vfs_getopt.9 vfs_setopt_part.9 \
vfs_getopt.9 vfs_setopts.9
MLINKS+=VFS_LOCK_GIANT.9 VFS_UNLOCK_GIANT.9
MLINKS+=vgone.9 vgonel.9
MLINKS+=vhold.9 vdrop.9 \
vhold.9 vdropl.9 \
vhold.9 vholdl.9

1
share/man/man9/vflush.9
View File

@ -75,7 +75,6 @@ A value of 0 is returned if the flush is successful; otherwise,
will be returned.
.Sh SEE ALSO
.Xr vgone 9 ,
.Xr vgonel 9 ,
.Xr vrele 9
.Sh AUTHORS
This manual page was written by

26
share/man/man9/vgone.9
View File

@ -26,24 +26,21 @@
.\"
.\" $FreeBSD$
.\"
.Dd November 21, 2001
.Dd November 12, 2010
.Dt VGONE 9
.Os
.Sh NAME
.Nm vgone , vgonel
.Nm vgone
.Nd "prepare a vnode for reuse"
.Sh SYNOPSIS
.In sys/param.h
.In sys/vnode.h
.Ft void
.Fn vgone "struct vnode *vp"
.Ft void
.Fn vgonel "struct vnode *vp" "struct thread *td"
.Sh DESCRIPTION
The
.Fn vgone
and
.Fn vgonel
prepare a vnode for reuse by another file system.
function prepares the vnode to be destroyed.
The preparation includes the cleaning of all file system specific data and
the removal from its mount point vnode list.
.Pp
@ -55,17 +52,12 @@ flag is not set, it is moved to the head of the free list
as in most cases the vnode
is about to be reused, or its file system is being unmounted.
.Pp
The difference between
The
.Fn vgone
and
.Fn vgonel
is that
.Fn vgone
locks the vnode interlock and then calls
.Fn vgonel
while
.Fn vgonel
expects the interlock to already be locked.
function takes an exclusively locked vnode, and returns with the vnode
exclusively locked.
.Sh SEE ALSO
.Xr vnode 9
.Sh AUTHORS
This manual page was written by
.An Chad David Aq davidc@acns.ab.ca .