1 files changed, 86 insertions, 0 deletions
diff --git a/man3/aio_fsync.3 b/man3/aio_fsync.3
new file mode 100644
index 000000000..82a186d79
--- /dev/null
+++ b/man3/aio_fsync.3
@@ -0,0 +1,86 @@
+.\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl)
+.\"
+.\" This is free documentation; you can redistribute it and/or
+.\" modify it under the terms of the GNU General Public License as
+.\" published by the Free Software Foundation; either version 2 of
+.\" the License, or (at your option) any later version.
+.\"
+.\" The GNU General Public License's references to "object code"
+.\" and "executables" are to be interpreted as the output of any
+.\" document formatting or typesetting system, including
+.\" intermediate and printed output.
+.\"
+.\" This manual is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public
+.\" License along with this manual; if not, write to the Free
+.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
+.\" USA.
+.\"
+.TH AIO_FSYNC 3 2003-11-14  "" "Linux Programmer's Manual"
+.SH NAME
+aio_fsync \- asynchronous file synchronization
+.SH SYNOPSIS
+.sp
+.B "#include <aio.h>"
+.sp
+.BI "int aio_fsync(int " op ", struct aiocb *" aiocbp );
+.sp
+.SH DESCRIPTION
+The
+.B aio_fsync
+function does a sync on all outstanding asynchronous I/O operations
+associated with
+.IR aiocbp->aio_fildes .
+.LP
+More precisely, if
+.I op
+is O_SYNC, then all currently queued I/O operations shall be
+completed as if by a call of
+.BR fsync (2),
+and if
+.I op
+is O_DSYNC, this call is the asynchronous analog of
+.BR fdatasync (2).
+Note that this is a request only - this call does not wait
+for I/O completion.
+.LP
+Apart from
+.I aio_fildes
+the only field in the structure pointed to by
+.I aiocbp
+that is used by this call is the
+.I aio_sigevent
+field (a struct sigevent) that indicates the desired type of
+asynchronous notification at completion.
+All other fields are ignored.
+.SH "RETURN VALUE"
+On success (the sync request was successfully queued)
+this function returns 0. On error \-1 is returned, and
+.I errno
+is set appropriately.
+.SH ERRORS
+.TP
+.B EAGAIN
+Out of resources.
+.TP
+.B EBADF
+.I aio_fildes
+is not a valid file descriptor open for writing.
+.TP
+.B EINVAL
+No synchronized I/O for this file is supported, or
+.I op
+is not O_SYNC or O_DSYNC.
+.SH "CONFORMING TO"
+POSIX 1003.1-2003
+.SH "SEE ALSO"
+.BR aio_cancel (3),
+.BR aio_error (3),
+.BR aio_read (3),
+.BR aio_return (3),
+.BR aio_suspend (3),
+.BR aio_write (3)