Date: Fri, 12 Nov 2010 12:07:36 +0000 (UTC) From: Sergey Kandaurov <pluknet@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r215176 - in head: . share/man/man9 Message-ID: <201011121207.oACC7axR007832@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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@acns.ab.ca .
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201011121207.oACC7axR007832>