VOP_FSYNC

NAME

VOP_FDATASYNC, VOP_FSYNC — flush file system buffers for a file

SYNOPSIS

#include <sys/param.h>
#include <sys/vnode.h> int
VOP_FDATASYNC(struct vnode *vp, struct thread *td); int
VOP_FSYNC(struct vnode *vp, int waitfor, struct thread *td);

DESCRIPTION

VOP_FSYNC() ensures that a file can be recovered to its current state following a crash. That typically requires flushing the file's dirty buffers, its inode, and possibly other filesystem metadata to persistent media. VOP_FSYNC() is used to implement the sync(2) and fsync(2) system calls. Its arguments are:

vp

The vnode of the file.

waitfor

Whether the function should wait for I/O to complete. Possible values are:

MNT_WAIT

Synchronously wait for I/O to complete.

MNT_NOWAIT

Start all I/O, but do not wait for it.

MNT_LAZY

Push data not written by file system syncer.

td

The calling thread.

VOP_FDATASYNC() is similar, but it does not require that all of the file's metadata be flushed. It only requires that the file's data be recoverable after a crash. That implies that the data itself must be flushed to disk, as well as some metadata such as the file's size but not necessarily its attributes. VOP_FDATASYNC() should always wait for I/O to complete, as if called with MNT_WAIT. VOP_FDATASYNC() is used to implement fdatasync(2).

LOCKS

The vnode should be exclusively locked on entry, and stays locked on return.

RETURN VALUES

Zero is returned if the call is successful, otherwise an appropriate error code is returned.

ERRORS

[ENOSPC]

The file system is full.

[EDQUOT]

Quota exceeded.

SEE ALSO

vnode(9)

AUTHORS

This manual page was written by Doug Rabson.