Name
aio_fsync — asynchronous file synchronization
Synopsis
#include <aio.h>
int
aio_fsync( |
int |
op, |
| |
struct aiocb * |
aiocbp); |
DESCRIPTION
The aio_fsync() function
does a sync on all outstanding asynchronous I/O operations
associated with aiocbp->aio_fildes.
More precisely, if op is O_SYNC, then all
currently queued I/O operations shall be completed as if by a
call of fsync(2), and if op is O_DSYNC, this call is the
asynchronous analog of fdatasync(2). Note that
this is a request only — this call does not wait for
I/O completion.
Apart from aio_fildes the only field in
the structure pointed to by aiocbp that is used by this
call is the aio_sigevent field (a struct
sigevent) that indicates the desired type of asynchronous
notification at completion. All other fields are ignored.
RETURN VALUE
On success (the sync request was successfully queued) this
function returns 0. On error −1 is returned, and
errno is set appropriately.
ERRORS
- EAGAIN
-
Out of resources.
- EBADF
-
aio_fildes
is not a valid file descriptor open for writing.
- EINVAL
-
No synchronized I/O for this file is supported, or
op is not
O_SYNC or O_DSYNC.
CONFORMING TO
POSIX.1-2001
SEE ALSO
aio_cancel(3), aio_error(3), aio_read(3), aio_return(3), aio_suspend(3), aio_write(3)
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.
|
