svn commit: r215176 - in head: . share/man/man9
Sergey Kandaurov
pluknet at FreeBSD.org
Fri Nov 12 12:07:36 UTC 2010
Author: pluknet
Date: Fri Nov 12 12:07:36 2010
New Revision: 215176
URL: http://svn.freebsd.org/changeset/base/215176
Log:
Stop documenting vgonel() after its converting to the static function:
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
Modified:
head/ObsoleteFiles.inc
head/share/man/man9/Makefile
head/share/man/man9/vflush.9
head/share/man/man9/vgone.9
Modified: head/ObsoleteFiles.inc
==============================================================================
--- head/ObsoleteFiles.inc Fri Nov 12 11:59:59 2010 (r215175)
+++ head/ObsoleteFiles.inc Fri Nov 12 12:07:36 2010 (r215176)
@@ -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/
Modified: head/share/man/man9/Makefile
==============================================================================
--- head/share/man/man9/Makefile Fri Nov 12 11:59:59 2010 (r215175)
+++ head/share/man/man9/Makefile Fri Nov 12 12:07:36 2010 (r215176)
@@ -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
Modified: head/share/man/man9/vflush.9
==============================================================================
--- head/share/man/man9/vflush.9 Fri Nov 12 11:59:59 2010 (r215175)
+++ head/share/man/man9/vflush.9 Fri Nov 12 12:07:36 2010 (r215176)
@@ -75,7 +75,6 @@ A value of 0 is returned if the flush is
will be returned.
.Sh SEE ALSO
.Xr vgone 9 ,
-.Xr vgonel 9 ,
.Xr vrele 9
.Sh AUTHORS
This manual page was written by
Modified: head/share/man/man9/vgone.9
==============================================================================
--- head/share/man/man9/vgone.9 Fri Nov 12 11:59:59 2010 (r215175)
+++ head/share/man/man9/vgone.9 Fri Nov 12 12:07:36 2010 (r215176)
@@ -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
as in most cases the vnode
is about to be reused, or its file system is being unmounted.
.Pp
-The difference between
-.Fn vgone
-and
-.Fn vgonel
-is that
+The
.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 at acns.ab.ca .
More information about the svn-src-all
mailing list