Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
VINVALBUF(9)		 BSD 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
			should be restarted.  (With PCATCH set in slpflag)

     [EINTR]		The system has been interrupted	by a signal.  (With
			PCATCH set in slpflag)

SEE ALSO
     tsleep(9),	VOP_FSYNC(9)

AUTHORS
     This manual page was written by Chad David	<davidc@acns.ab.ca>.

BSD			       October 20, 2008				   BSD

NAME | SYNOPSIS | DESCRIPTION | LOCKS | RETURN VALUES | PSEUDOCODE | ERRORS | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=vinvalbuf&sektion=9&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help