1.\"
2.\" Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice(s), this list of conditions and the following disclaimer as
--- 10 unchanged lines hidden (view full) ---
19.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
20.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
21.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
22.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
25.\" DAMAGE.
26.\"
27.\" $FreeBSD: head/share/man/man9/vgone.9 87182 2001-12-02 02:13:35Z alfred $
28.\"
29.Dd November 21, 2001
30.Dt VGONE 9
31.Os
32.Sh NAME
33.Nm vgone
34.Nm vgonel
35.Nd "prepare a vnode for reuse"
36.Sh SYNOPSIS
37.In sys/param.h
38.In sys/vnode.h
39.Ft void
40.Fn vgone "struct vnode *vp"
41.Ft void
42.Fn vgonel "struct vnod *vp" "struct thread *td"
43.Sh DESCRIPTION
44.Fn vgone
45and
46.Fn vgonel
47prepare a vnode for reuse by another filesystem.
48The preparation includes the cleaning of all filesystem specific data and
49the removal from its mount point vnode list.
50.Pp
51If the vnode has a usecount of zero, and its
52.Dv VDOOMED
53flag is not set it is moved to the head of the free list as in most cases the vnode
54is about to be reused, or its filesystem being unmounted.
55.Pp
56The difference between
57.Fn vgone
58and
59.Fn vgonel
60is that
61.Fn vgone
62locks the vnode interlock and then calls
63.Fn vgonel
64while
65.Fn vgonel
66expects the interlock to already be locked.
67.Sh SEE ALSO
68.Xr vclean 9
69.Sh AUTHORS
70This man page was written by
71.An Chad David Aq davidc@acns.ab.ca .
2.\" Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice(s), this list of conditions and the following disclaimer as
--- 10 unchanged lines hidden (view full) ---
19.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
20.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
21.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
22.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
25.\" DAMAGE.
26.\"
27.\" $FreeBSD: head/share/man/man9/vgone.9 87182 2001-12-02 02:13:35Z alfred $
28.\"
29.Dd November 21, 2001
30.Dt VGONE 9
31.Os
32.Sh NAME
33.Nm vgone
34.Nm vgonel
35.Nd "prepare a vnode for reuse"
36.Sh SYNOPSIS
37.In sys/param.h
38.In sys/vnode.h
39.Ft void
40.Fn vgone "struct vnode *vp"
41.Ft void
42.Fn vgonel "struct vnod *vp" "struct thread *td"
43.Sh DESCRIPTION
44.Fn vgone
45and
46.Fn vgonel
47prepare a vnode for reuse by another filesystem.
48The preparation includes the cleaning of all filesystem specific data and
49the removal from its mount point vnode list.
50.Pp
51If the vnode has a usecount of zero, and its
52.Dv VDOOMED
53flag is not set it is moved to the head of the free list as in most cases the vnode
54is about to be reused, or its filesystem being unmounted.
55.Pp
56The difference between
57.Fn vgone
58and
59.Fn vgonel
60is that
61.Fn vgone
62locks the vnode interlock and then calls
63.Fn vgonel
64while
65.Fn vgonel
66expects the interlock to already be locked.
67.Sh SEE ALSO
68.Xr vclean 9
69.Sh AUTHORS
70This man page was written by
71.An Chad David Aq davidc@acns.ab.ca .