NAME    [Toc]    [Back]

     fsync -- synchronise changes to a file

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <unistd.h>

     int
     fsync(int fd);

DESCRIPTION    [Toc]    [Back]

     The fsync() system call causes all modified data and attributes of fd to
     be moved to a permanent storage device.  This normally results in all incore
 modified copies of buffers for the associated file to be written to
     a disk.

     The fsync() system call should be used by programs that require a file to
     be in a known state, for example, in building a simple transaction facility.

RETURN VALUES    [Toc]    [Back]

     The fsync() function returns the value 0 if successful; otherwise the
     value -1 is returned and the global variable errno is set to indicate the
     error.

ERRORS    [Toc]    [Back]

     The fsync() fails if:

     [EBADF]		The fd argument is not a valid descriptor.

     [EINVAL]		The fd argument refers to a socket, not to a file.

     [EIO]		An I/O error occurred while reading from or writing to
			the file system.

SEE ALSO    [Toc]    [Back]

     sync(2), syncer(4), sync(8)

HISTORY    [Toc]    [Back]

     The fsync() system call appeared in 4.2BSD.


FreeBSD 5.2.1			 June 4, 1993			 FreeBSD 5.2.1