FreeBSD manual
download PDF document: vinvalbuf.9.pdf
VINVALBUF(9) FreeBSD Kernel Developer's Manual VINVALBUF(9)
NAME
vinvalbuf - flushes and invalidates all buffers associated with a vnode
SYNOPSIS
#include <sys/param.h>
#include <sys/vnode.h>
int
vinvalbuf(struct vnode *vp, int flags, struct ucred *cred, int slpflag,
int slptimeo);
DESCRIPTION
The vinvalbuf() function invalidates all of the buffers associated with
the given vnode. This includes buffers on the clean list and the dirty
list. If the V_SAVE flag is specified then the buffers on the dirty list
are synced prior to being released. If there is a VM Object associated
with the vnode, it is removed.
Its arguments are:
vp A pointer to the vnode whose buffers will be invalidated.
flags The only supported flag is V_SAVE and it indicates that dirty
buffers should be synced with the disk.
cred The user credentials that are used to VOP_FSYNC(9) buffers if
V_SAVE is set.
slpflag The slp flag that will be used in the priority of any sleeps in
the function.
slptimeo The timeout for any sleeps in the function.
LOCKS
The vnode is assumed to be locked prior to the call and remains locked
upon return.
Giant must be held by prior to the call and remains locked upon return.
RETURN VALUES
A 0 value is returned on success.
PSEUDOCODE
vn_lock(devvp, LK_EXCLUSIVE | LK_RETRY);
error = vinvalbuf(devvp, V_SAVE, cred, 0, 0);
VOP_UNLOCK(devvp, 0);
if (error)
return (error);
ERRORS
[ENOSPC] The file system is full. (With V_SAVE)
[EDQUOT] Disc quota exceeded. (With V_SAVE)
[EWOULDBLOCK] Sleep operation timed out. (See slptimeo)
[ERESTART] A signal needs to be delivered and the system call
AUTHORS
This manual page was written by Chad David <davidc@acns.ab.ca>.
FreeBSD 14.0-RELEASE-p6 October 20, 2008 FreeBSD 14.0-RELEASE-p6