NAME

fsync − synchronize a file’s in-core state with that on disk

SYNOPSIS

fsync(fd)
int fd;

DESCRIPTION

Fsync causes all modified data for and modified attributes of fd to be moved to a permanent storage device, so that the changes will be guaranteed to survive hardware failures resulting in system crashes.  This normally results in all in-core modified copies of buffers for the file to be written to a disk. 

Fsync should be used by programs which require a file to be in a known state; for example in building a simple transaction facility. 

RETURN VALUE

A 0 value is returned on successful completion.  A −1 value indicates an error. 

ERRORS

The fsync fails if:

[EBADF] Fd is not a valid descriptor. 

[EINVAL] Fd refers to a socket, not to a file. 

SEE ALSO

sync(2), sync(8), update(8)

BUGS

The current implementation of this call is expensive for large files. 

Sun System Release 0.3  —  25 April 1983