fsync (2)

Leading comments

 Copyright (c) 1983, 1993
	The Regents of the University of California.  All rights reserved.

 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions
 are met:
 1. Redistributions of source code must retain the above copyright
    notice, this list of conditions and the following disclaimer.
 2. Redistributions in binary form must reproduce the above copyright
    notice, this list of conditions and the following...

(The comments found at the beginning of the groff file "man2/fsync.2freebsd".)

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