From owner-svn-src-all@FreeBSD.ORG Tue Nov 23 11:39:11 2010 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id AFA77106566B; Tue, 23 Nov 2010 11:39:11 +0000 (UTC) (envelope-from pluknet@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 9CE168FC16; Tue, 23 Nov 2010 11:39:11 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id oANBdBwn028961; Tue, 23 Nov 2010 11:39:11 GMT (envelope-from pluknet@svn.freebsd.org) Received: (from pluknet@localhost) by svn.freebsd.org (8.14.3/8.14.3/Submit) id oANBdBYJ028956; Tue, 23 Nov 2010 11:39:11 GMT (envelope-from pluknet@svn.freebsd.org) Message-Id: <201011231139.oANBdBYJ028956@svn.freebsd.org> From: Sergey Kandaurov Date: Tue, 23 Nov 2010 11:39:11 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-8@freebsd.org X-SVN-Group: stable-8 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r215739 - in stable/8: . share/man/man9 X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 23 Nov 2010 11:39:11 -0000 Author: pluknet Date: Tue Nov 23 11:39:11 2010 New Revision: 215739 URL: http://svn.freebsd.org/changeset/base/215739 Log: MFC r215176: 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(). Approved by: avg (mentor), kib (mentor) Modified: stable/8/ObsoleteFiles.inc (contents, props changed) stable/8/share/man/man9/Makefile stable/8/share/man/man9/vflush.9 stable/8/share/man/man9/vgone.9 Directory Properties: stable/8/share/man/man9/ (props changed) Modified: stable/8/ObsoleteFiles.inc ============================================================================== --- stable/8/ObsoleteFiles.inc Tue Nov 23 11:31:12 2010 (r215738) +++ stable/8/ObsoleteFiles.inc Tue Nov 23 11:39:11 2010 (r215739) @@ -16,6 +16,8 @@ # 20101123: removed subblock.h from liblzma OLD_FILES+=usr/include/lzma/subblock.h +# 20101112: vgonel(9) has gone to private API a while ago +OLD_FILES+=usr/share/man/man9/vgonel.9.gz # 20101025: catch up with vm_page_sleep_if_busy rename OLD_FILES+=usr/share/man/man9/vm_page_sleep_busy.9.gz # 20100327: fusword.9 and susword.9 removed Modified: stable/8/share/man/man9/Makefile ============================================================================== --- stable/8/share/man/man9/Makefile Tue Nov 23 11:31:12 2010 (r215738) +++ stable/8/share/man/man9/Makefile Tue Nov 23 11:39:11 2010 (r215739) @@ -1303,7 +1303,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 vholdl.9 \ vhold.9 vdropl.9 Modified: stable/8/share/man/man9/vflush.9 ============================================================================== --- stable/8/share/man/man9/vflush.9 Tue Nov 23 11:31:12 2010 (r215738) +++ stable/8/share/man/man9/vflush.9 Tue Nov 23 11:39:11 2010 (r215739) @@ -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: stable/8/share/man/man9/vgone.9 ============================================================================== --- stable/8/share/man/man9/vgone.9 Tue Nov 23 11:31:12 2010 (r215738) +++ stable/8/share/man/man9/vgone.9 Tue Nov 23 11:39:11 2010 (r215739) @@ -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 .