fsync.2freebsd

Langue: en

Version: 266427 (debian - 07/07/09)

Section: 2 (Appels système)


BSD mandoc

NAME

fsync - synchronise changes to a file

LIBRARY

Lb libc

SYNOPSIS

In unistd.h Ft int Fn fsync int fd

DESCRIPTION

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

The Fn 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

Rv -std fsync

ERRORS

The Fn fsync fails if:
Bq Er EBADF
The Fa fd argument is not a valid descriptor.
Bq Er EINVAL
The Fa fd argument refers to a socket, not to a file.
Bq Er EIO
An I/O error occurred while reading from or writing to the file system.

SEE ALSO

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

HISTORY

The Fn fsync system call appeared in BSD 4.2