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 9.\" the first lines of this file unmodified other than the possible 10.\" addition of one or more copyright notices. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice(s), this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY 16.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 17.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 18.\" DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) BE LIABLE FOR ANY 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$ 28.\" 29.Dd July 7, 2001 30.Dt VINVALBUF 9 31.Os 32.Sh NAME 33.Nm vinvalbuf 34.Nd "flushes and invalidates all buffers associated with a vnode" 35.Sh SYNOPSIS 36.In sys/param.h 37.In sys/vnode.h 38.Ft int 39.Fn vinvalbuf "struct vnode *vp" "int flags" "struct ucred *cred" "struct thread *td" "int slpflag" "int slptimeo" 40.Sh DESCRIPTION 41The 42.Fn vinvalbuf 43function invalidates all of the buffers associated with the given vnode. 44This includes buffers on the clean list and the dirty list. 45If the 46.Dv V_SAVE 47flag is specified then the buffers on the dirty list are synced prior to being 48released. 49If there is a VM Object associated with the vnode, it is removed. 50.Pp 51Its arguments are: 52.Bl -tag -width ".Fa spltimeo" 53.It Fa vp 54A pointer to the vnode whose buffers will be invalidated. 55.It Fa flags 56The only supported flag is 57.Dv V_SAVE 58and it indicates that dirty buffers should be synced with the disk. 59.It Fa cred 60The user credentials that are used to 61.Xr VOP_FSYNC 9 62buffers if 63.Dv V_SAVE 64is set. 65.It Fa td 66The thread responsible for this call. 67.It Fa slpflag 68The slp flag that will be used in the priority of any sleeps in the function. 69.It Fa slptimeo 70The timeout for any sleeps in the function. 71.El 72.Sh LOCKS 73The vnode is assumed to be locked prior to the call and remains locked upon return. 74.Pp 75.Va Giant 76must be held by prior to the call and remains locked upon return. 77.Sh RETURN VALUES 78A 0 value is returned on success. 79.Sh PSEUDOCODE 80.Bd -literal -offset indent 81vn_lock(devvp, LK_EXCLUSIVE | LK_RETRY, td); 82error = vinvalbuf(devvp, V_SAVE, cred, td, 0, 0); 83VOP_UNLOCK(devvp, 0, td); 84if (error) 85 return (error); 86.Ed 87.Sh ERRORS 88.Bl -tag -width Er 89.It Bq Er ENOSPC 90The file system is full. 91(With 92.Dv V_SAVE ) 93.It Bq Er EDQUOT 94Disc quota exceeded. 95(With 96.Dv V_SAVE ) 97.It Bq Er EWOULDBLOCK 98Sleep operation timed out. 99(See 100.Fa slptimeo ) 101.It Bq Er ERESTART 102A signal needs to be delivered and the system call should be restarted. 103(With 104.Dv PCATCH 105set in 106.Fa slpflag ) 107.It Bq Er EINTR 108The system has been interrupted by a signal. 109(With 110.Dv PCATCH 111set in 112.Fa slpflag ) 113.El 114.Sh SEE ALSO 115.Xr brelse 9 , 116.Xr bremfree 9 , 117.Xr tsleep 9 , 118.Xr VOP_FSYNC 9 119.Sh AUTHORS 120This manual page was written by 121.An Chad David Aq davidc@acns.ab.ca . 122