名 前
aio_return − 非 同 期 I/O 操 作 の 返 り 値 (return status) を 取 得 す る
書 式
#include <aio.h>
ssize_t aio_return(struct aiocb *aiocbp);
−lrt で リ ン ク す る 。
説 明
aio_return() 関 数 は aiocbp で 指 さ れ た 制 御 ブ ロ ッ ク に お け る 非 同 期 I/O リ ク エ ス ト の 最 終 的 な 返 り 値 を 返 す 。 (aiocb 構 造 体 の 説 明 は aio(7) を 参 照 ) こ の 関 数 は 、 aio_error(3) が EINPROGRESS 以 外 を 返 し た 後 で 、 与 え ら れ た リ ク エ ス ト に 対 し て 1 回 だ け 呼 ば れ る べ き で あ る 。
返 り 値
非 同 期 I/O 操 作 が 完 了 し た 場 合 、 こ の 関 数 は 、 同 期 呼 び 出 し read(2), write(2), fsync(2), fdatasync(2) が 返 す の と 同 じ 値 を 返 す 。 非 同 期 I/O 操 作 が 完 了 し て い な い 場 合 、 aio_return() の 返 り 値 と そ の 影 響 は 不 定 で あ る 。
エ ラ ー
|
EINVAL |
aiocbp が 、 返 り 値 が ま だ 取 得 さ れ て い な い 非 同 期 I/O リ ク エ ス ト の 制 御 ブ ロ ッ ク を 指 し て い な い 。 | ||
|
ENOSYS |
aio_return() は 実 装 さ れ て い な い 。 |
バ ー ジ ョ ン
The aio_return() 関 数 は glibc 2.1 以 降 で 利 用 で き る 。
属 性
マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 )
The aio_return() 関 数 は ス レ ッ ド セ ー フ で あ る 。
準 拠
POSIX.1−2001, POSIX.1−2008.
例
aio(7) を 参 照 。
関 連 項 目
aio_cancel(3), aio_error(3), aio_fsync(3), aio_read(3), aio_suspend(3), aio_write(3), lio_listio(3), aio(7)
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。