debian man page for file::sync

Sync(3pm)						User Contributed Perl Documentation						 Sync(3pm)

NAME
       File::Sync - Perl access to fsync() and sync() function calls

SYNOPSIS
	 use File::Sync qw(fsync sync);
	 sync();
	 fsync(*FILEHANDLE) or die "fsync: $!";
	 # and if fdatasync() is available on your system:
	 fdatasync($fh) or die "fdatasync: $!";

	 use File::Sync qw(fsync);
	 use FileHandle;
	 $fh = new FileHandle("> /tmp/foo")
	     or die "new FileHandle: $!";
	 ...
	 $fh->fsync() or die "fsync: $!";

DESCRIPTION
       The fsync() function takes a Perl file handle as its only argument, and passes its fileno() to the C function fsync().  It returns undef on
       failure, or true on success. fdatasync() is identical in return value, but it calls C fdatasync() instead of fsync(), synchronizing only
       the data in the file, not the metadata.

       The fsync_fd() function is used internally by fsync(); it takes a file descriptor as its only argument.

       The sync() function is identical to the C function sync().

       This module does not export any methods by default, but fsync() is made available as a method of the FileHandle class. Note carefully that
       as of 0.11, we no longer clobber anything in IO::Handle. You can replace any calls to IO::Handle::fsync() with IO::Handle::sync():
	 https://rt.cpan.org/Public/Bug/Display.html?id=50418

NOTES
       Doing fsync() if the stdio buffers aren't flushed (with $| or the autoflush method) is probably pointless.

       Calling sync() too often on a multi-user system is slightly antisocial.

AUTHOR
       Carey Evans <c.evans@clear.net.nz>

SEE ALSO
       perl(1), fsync(2), sync(2), perlvar(1)

perl v5.14.2							    2011-11-19								 Sync(3pm)