MirOS Manual: vinvalbuf(9)

VINVALBUF(9)                  BSD Kernel Manual                   VINVALBUF(9)

NAME

     vinvalbuf - flush and invalidate 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,
             struct proc *p, 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 the V_SAVEMETA flag is set, in-
     direct blocks will not be flushed.

     Its arguments are:

     vp            A pointer to the vnode whose buffers will be invalidated.

     flags         The supported flags are V_SAVE and V_SAVEMETA. V_SAVE indi-
                   cates that dirty buffers should be synced with the disk.
                   V_SAVEMETA indicates that indirect blocks should not be
                   flushed.

     cred          The user credentials that are used to VOP_FSYNC(9) buffers
                   if V_SAVE is set.

     p             The process responsible for this call.

     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.

RETURN VALUES

     A value of 0 is returned on success.

PSEUDOCODE

           vn_lock(devvp, LK_EXCLUSIVE | LK_RETRY, p);
           error = vinvalbuf(devvp, V_SAVE, cred, p, 0, 0);
           VOP_UNLOCK(devvp, 0, p);
           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), vnode(9)

AUTHORS

     This man page was originally written by Chad David <davidc@acns.ab.ca>
     for FreeBSD.

MirOS BSD #10-current            July 7, 2001                                1

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.