[PATCH] Fix 'implicit declaration' warning and update vgone(9)
Kostik Belousov
kostikbel at gmail.com
Wed Oct 27 14:41:59 UTC 2010
On Wed, Oct 27, 2010 at 05:26:13PM +0400, Sergey Kandaurov wrote:
> On 27 October 2010 15:33, Sergey Kandaurov <pluknet at gmail.com> wrote:
> > On 27 October 2010 10:23, Lars Hartmann <lars at chaotika.org> wrote:
> >> The vgonel function isnt declarated in any header, the vgonel prototype
> >> in vgone(9) isnt correct - found by Ben Kaduk <kaduk at mit.edu>
> >
> > Hi.
> >
> > I'm afraid it's just an overlooked man page after many VFS changes in 5.x.
> > As vgonel() is a static (i.e. private and not visible from outside) function
> > IMO it should be removed from vgone(9) man page.
> >
>
> Something like this I'd like to check in. Comments?
>
> Index: ObsoleteFiles.inc
> ===================================================================
> --- ObsoleteFiles.inc (revision 214414)
> +++ ObsoleteFiles.inc (working copy)
> @@ -14,6 +14,8 @@
> # The file is partitioned: OLD_FILES first, then OLD_LIBS and OLD_DIRS last.
> #
>
> +# 20101027: vgonel(9) has gone to private API a while ago
> +OLD_FILES+=usr/share/man/man9/vgonel.9.gz
> # 20101020: catch up with vm_page_sleep_if_busy rename
> OLD_FILES+=usr/share/man/man9/vm_page_sleep_busy.9.gz
> # 20101011: removed subblock.h from liblzma
> Index: share/man/man9/Makefile
> ===================================================================
> --- share/man/man9/Makefile (revision 214413)
> +++ share/man/man9/Makefile (working copy)
> @@ -1317,7 +1317,6 @@
> 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
> Index: share/man/man9/vgone.9
> ===================================================================
> --- share/man/man9/vgone.9 (revision 214413)
> +++ share/man/man9/vgone.9 (working copy)
> @@ -26,24 +26,21 @@
> .\"
> .\" $FreeBSD$
> .\"
> -.Dd November 21, 2001
> +.Dd October 27, 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 a vnode for reuse by another file system.
I think it is more correct now "prepares the vnode to be destroyed"
instead.
> The preparation includes the cleaning of all file system specific data and
> the removal from its mount point vnode list.
> .Pp
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 196 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/freebsd-hackers/attachments/20101027/6a2c57a2/attachment.pgp
More information about the freebsd-hackers
mailing list