xref: /dflybsd-src/share/man/man9/vrele.9 (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
1*86d7f5d3SJohn Marino.\" Copyright (c) 1996 Doug Rabson
2*86d7f5d3SJohn Marino.\"
3*86d7f5d3SJohn Marino.\" All rights reserved.
4*86d7f5d3SJohn Marino.\"
5*86d7f5d3SJohn Marino.\" This program is free software.
6*86d7f5d3SJohn Marino.\"
7*86d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
8*86d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
9*86d7f5d3SJohn Marino.\" are met:
10*86d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
11*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
12*86d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
13*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in the
14*86d7f5d3SJohn Marino.\"    documentation and/or other materials provided with the distribution.
15*86d7f5d3SJohn Marino.\"
16*86d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
17*86d7f5d3SJohn Marino.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18*86d7f5d3SJohn Marino.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19*86d7f5d3SJohn Marino.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
20*86d7f5d3SJohn Marino.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21*86d7f5d3SJohn Marino.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22*86d7f5d3SJohn Marino.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23*86d7f5d3SJohn Marino.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24*86d7f5d3SJohn Marino.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25*86d7f5d3SJohn Marino.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26*86d7f5d3SJohn Marino.\"
27*86d7f5d3SJohn Marino.\" $FreeBSD: src/share/man/man9/vrele.9,v 1.6.2.2 2001/12/17 11:30:19 ru Exp $
28*86d7f5d3SJohn Marino.\"
29*86d7f5d3SJohn Marino.Dd May 5, 2007
30*86d7f5d3SJohn Marino.Dt VRELE 9
31*86d7f5d3SJohn Marino.Os
32*86d7f5d3SJohn Marino.Sh NAME
33*86d7f5d3SJohn Marino.Nm vrele
34*86d7f5d3SJohn Marino.Nd Release a previously obtained primary reference for a vnode
35*86d7f5d3SJohn Marino.Sh SYNOPSIS
36*86d7f5d3SJohn Marino.In sys/param.h
37*86d7f5d3SJohn Marino.In sys/vnode.h
38*86d7f5d3SJohn Marino.Ft void
39*86d7f5d3SJohn Marino.Fn vrele "struct vnode *vp"
40*86d7f5d3SJohn Marino.Sh DESCRIPTION
41*86d7f5d3SJohn MarinoThe caller is holding a primary reference to the vnode and wishes to
42*86d7f5d3SJohn Marinorelease it.
43*86d7f5d3SJohn Marino.Bl -tag -width ".Fa vp"
44*86d7f5d3SJohn Marino.It Fa vp
45*86d7f5d3SJohn MarinoThe vnode being released.
46*86d7f5d3SJohn Marino.El
47*86d7f5d3SJohn Marino.Pp
48*86d7f5d3SJohn MarinoAny code in the system which obtains a primary reference to a vnode via
49*86d7f5d3SJohn Marino.Xr vref 9
50*86d7f5d3SJohn Marinotypically releases that reference with
51*86d7f5d3SJohn Marino.Fn vrele
52*86d7f5d3SJohn Marinowhen it is finished with the vnode.
53*86d7f5d3SJohn MarinoUpon release of the last primary
54*86d7f5d3SJohn Marinoreference, the vnode will be deactivated and either moved to the free
55*86d7f5d3SJohn Marinolist for later reuse or marked as being cache.
56*86d7f5d3SJohn MarinoThe vnode can be reactivated at any time prior to the system reusing it.
57*86d7f5d3SJohn Marino.Sh SEE ALSO
58*86d7f5d3SJohn Marino.Xr vdrop 9 ,
59*86d7f5d3SJohn Marino.Xr vget 9 ,
60*86d7f5d3SJohn Marino.Xr vhold 9 ,
61*86d7f5d3SJohn Marino.Xr vnode 9 ,
62*86d7f5d3SJohn Marino.Xr vn_lock 9 ,
63*86d7f5d3SJohn Marino.Xr vn_unlock 9 ,
64*86d7f5d3SJohn Marino.Xr vput 9 ,
65*86d7f5d3SJohn Marino.Xr vref 9
66*86d7f5d3SJohn Marino.Sh AUTHORS
67*86d7f5d3SJohn MarinoThis manual page was written by
68*86d7f5d3SJohn Marino.An Doug Rabson .
69