other versions
other sections
AIO_WRITE(3) | Linux Programmer's Manual | AIO_WRITE(3) |
名前¶
aio_write - 非同期で書き込む書式¶
#include <aio.h>説明¶
aio_write() 関数は、aiocbp が指すバッファに記載された I/O リクエストを キューに入れる。この関数は write(2) の非同期版である。 呼び出しwrite(fd, buf, count)
返り値¶
成功した場合、0 が返される。 エラーの場合、リクエストはキューに入れられず、 -1 が返されて、 errno が適切に設定される。 エラーは後でのみ検知された場合は、 エラーは aio_return(3) と aio_error(3) 経由で報告されることになる ( aio_return(3) は状態 -1 を返し、 aio_error(3) でエラー状態— errno で取得できる EBADF のようなエラー状態が返される)。エラー¶
- EAGAIN
- リソースが足りない。
- EBADF
- aio_fildes が書き込みのためにオープンされた有効なファイルディスクリプタではない。
- EFBIG
- ファイルは通常のファイルであり、少なくとも 1 バイトを書き込もうとしている。 しかし開始位置が、このファイルの最大オフセットと同じかそれを超えている。
- EINVAL
- aio_offset, aio_reqprio, aio_nbytes のうち 1 つ以上が無効である。
- ENOSYS
- aio_write() は実装されていない。
バージョン¶
The aio_write() 関数は glibc 2.1 以降で利用できる。準拠¶
POSIX.1-2001, POSIX.1-2008.注意¶
使用する前に制御ブロックを 0 にしておくのは、よい考えである。 この制御ブロックは、読み込み操作が進行している間は変更すべきでない。 読み込まれるバッファ領域は 操作の最中にアクセスすべきではない。 さもないと起こる結果が不定になる。 これに含まれるメモリ領域は、有効なままにしなければならない。関連項目¶
aio_cancel(3), aio_error(3), aio_fsync(3), aio_read(3), aio_return(3), aio_suspend(3), lio_listio(3), aio(7)この文書について¶
この man ページは Linux man-pages プロジェクトのリリース 3.41 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。2012-05-08 |