fsync.2 does not mention error handling

[Pavel Machek <pavel@suse.cz>]

fsync() transfers ("flushes") all modified in-core data of (i.e.,
modified buffer cache pages for) the file referred to by the file
descriptor fd to the disk device (or other permanent storage device)
where that file resides.  The call blocks until the device reports
that the transfer has completed.  It also flushes metadata information
associated with the file (see stat(2)).

Calling fsync() does not necessarily ensure that the entry in the
directory containing the file has also reached disk.  For that an
explicit fsync() on a file descriptor for the directory is also
needed.

...
RETURN VALUE         top

On success, these system calls return zero.  On error, -1 is
returned, and errno is set appropriately.


--------------


I guess it should mention that any errors during fsync are only
mentioned to the first process calling it... which means that if you

write file
fsync file
fsync .

... and someone else does "fsync ." in the meantime, you may get
success when in fact directory entry of file is not written to the
disk.
									Pavel
-- 
(english) http://www.livejournal.com/~pavelmachek
(cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html