[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