fdatasync(2) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
FDATASYNC(2)              NetBSD System Calls Manual              FDATASYNC(2)


NAME

     fdatasync -- synchronize the data of a file


LIBRARY

     Standard C Library (libc, -lc)


SYNOPSIS

     #include <unistd.h>

     int
     fdatasync(int fd);


DESCRIPTION

     The fdatasync() function forces all modified data associated with the
     file descriptor fd to be flushed to stable storage.

     The functionality is as described for fsync(2), with the exception that
     file status information need not be synchronized, which may result in a
     performance gain, compared to fsync(2).  This behaviour is commonly known
     as synchronized I/O data integrity completion.


RETURN VALUES

     A value of 0 is returned on success.  Otherwise, a value -1 is returned
     and errno is set to indicate the error.


ERRORS

     The fdatasync() function will fail if:

     [EBADF]            The fd argument is not a valid file descriptor open
                        for writing.

     [EINVAL]           This implementation does not support synchronized I/O
                        for this file.

     [ENOSYS]           The fdatasync() function is not supported by this
                        implementation.

     In the event that any of the I/O operations to be performed fail,
     fdatasync() returns the error conditions defined for read(2) and
     write(2), and outstanding I/O operations are not guaranteed to have been
     completed.


SEE ALSO

     fsync(2), open(2), read(2), write(2)


STANDARDS

     The fdatasync() function conforms to IEEE Std 1003.1b-1993 (``POSIX.1'').

NetBSD 4.0                     October 25, 2003                     NetBSD 4.0