aio_fsyncのヘルプ・マニュアル
日本語 英語
aio_fsync --help
man aio_fsync
AIO_FSYNC(3) Linux Programmer’s Manual AIO_FSYNC(3)
名前
aio_fsync - 非同期ファイルを同期させる
書式
#include
int aio_fsync(int op, struct aiocb *aiocbp);
-lrt でリンクする。
説明
aio_fsync() 関数は、 aiocbp->aio_fildes で関連付けられているまだ完了し
ていない全ての非同期 I/O 操作を同期させる。
より正確に言うと、 op が O_SYNC の場合、現在キューに入れられている全 て
の I/O 操作は、 fsync(2) が呼ばれたかのように完了されるだろう。また op
が O_DSYNC の場合、この呼び出しは fdatasync(2) の非同期版となる。この関
数 はリクエストを行うだけである点に注意すること — この呼び出しは I/O の
完了を待たない。
aiocbp で指される構造体のフィールドのうち、この呼び出しで aio_fildes 以
外に使用されるのは aio_sigevent フィールド (struct sigevent) のみである
。このフィールドは、完了時の非同期通知に使用したいタイプを示す。その 他
のフィールドは無視される。
返り値
成功した場合 (同期リクエストをキューに入れるのに成功した場合)、この関数
は 0 を返す。エラーの場合、-1 が返され、 errno が適切に設定される。
エラー
EAGAIN リソースが足りない。
EBADF aio_fildes が書き込みのためにオープンされた有効なファイルディ ス
クリプタではない。
EINVAL こ のファイルに対する同期 I/O がサポートされていない。または op
が O_SYNC でも O_DSYNC でもない。
準拠
POSIX.1-2001.
関連項目
aio_cancel(3), aio_error(3), aio_read(3), aio_return(3), aio_sus-
pend(3), aio_write(3)
2003-11-14 AIO_FSYNC(3)
AIO_FSYNC(3) Linux Programmer’s Manual AIO_FSYNC(3)
NAME
aio_fsync - asynchronous file synchronization
SYNOPSIS
#include
int aio_fsync(int op, struct aiocb *aiocbp);
Link with -lrt.
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 opera-
tions 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 comple-
tion.
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_sus-
pend(3), aio_write(3)
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
2003-11-14 AIO_FSYNC(3)