Index for Section 2

Alphabetical listing for F

Bottom of page

fsync(2)
NAME
  fsync - Write changes in a file to permanent storage

SYNOPSIS
  #include <unistd.h>

  int fsync(
	  int fildes );

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  fsync(): XSH4.0, XSH4.2, XSH5.0

  Refer to the standards(5) reference page for more information about
  industry standards and associated tags.

PARAMETERS
  fildes  Specifies a valid open file descriptor.

DESCRIPTION
  The fsync() function causes system buffers containing a file's modified
  data and attributes to be written to permanent storage.  The fsync()
  function does not return until the operation has been completed. The
  fsync() function provides file integrity, ensuring that data and file
  attribute information in permanent storage is identical to data and file
  attribute information in the buffer.

NOTES
  The file identified by the fildes parameter must be open for writing when
  the fsync() function is issued or the call will fail.

RETURN VALUES
  Upon successful completion, the fsync() function returns a value of 0
  (zero). If the fsync() function fails, a value of -1 is returned and errno
  is set to indicate the error. If fsync() fails, outstanding I/O operations
  are not guaranteed to have been completed.

ERRORS
  If the fsync() function fails, errno may be set to one of the following
  values:

  [EBADF] The fildes parameter is not a valid file descriptor.

  [EINVAL]
	  The fildes parameter does not refer to a file on which this
	  operation is possible.

  If any queued I/O operations fail, the fsync() function returns error
  conditions defined for the read() and write() functions.

SEE ALSO
  Functions: aio_fsync(2), fdatasync(2), fcntl(2), open(2), read(2), sync(2),
  write(2)

  Standards: standards(5)

Index for Section 2

Alphabetical listing for F

Top of page