Manpages

名 前

io_setup − 非 同 期 I/O コ ン テ キ ス ト を 作 成 す る

書 式

#include <linux/aio_abi.h> /* 必 要 な 型 の 定 義 */

int io_setup(unsigned nr_events, aio_context_t *ctx_idp); : こ の シ ス テ ム コ ー ル に は glibc の ラ ッ パ ー 関 数 は 存 在 し な い 。 「 注 意 」 の 節 を 参 照 。

説 明

io_setup() シ ス テ ム コ ー ル は 、 nr_events 個 の イ ベ ン ト を 同 時 に 実 行 に 適 し た 非 同 期 I/O (AIO) コ ン テ キ ス ト の 作 成 を 行 う 。 ctx_idp 引 き 数 は 、 す で に 存 在 す る AIO コ ン テ キ ス ト を 指 し て い て は な ら ず 、 io_setup() の 呼 び 出 し の 前 に 0 に 初 期 化 さ れ て い な け れ ば な ら な い 。 AIO コ ン テ キ ス ト の 作 成 に 成 功 す る と 、 *ctx_idp に 作 成 さ れ た AIO コ ン テ キ ス ト へ の ポ イ ン タ ー が セ ッ ト さ れ る 。

返 り 値

成 功 し た 場 合 、 io_setup() は 0 を 返 す 。 失 敗 時 の 返 り 値 に つ い て は 、 「 注 意 」 の 節 を 参 照 す る こ と 。

エ ラ ー

EAGAIN 指 定 さ れ た

nr_events が ユ ー ザ ー が 使 用 で き る イ ベ ン ト 数 の 上 限 を 越

え て い る 。 イ ベ ン ト 数 の 上 限 は /proc/sys/fs/aio−max−nr で 定 義 さ れ て い る 。

EFAULT

ctx_idp に 無 効 な ポ イ ン タ ー が 指 定 さ れ て い る 。

EINVAL

ctx_idp が 初 期 化 さ れ て い な い か 、 指 定 さ れ た nr_events が 内 部 の 制 限 値 を 越 え て い る 。 ま た 、 nr_events は 0 よ り 大 き い 値 に 設 定 す べ き で あ る 。

ENOMEM

必 要 な カ ー ネ ル リ ソ ー ス を 得 ら れ な い 。

ENOSYS

io_setup() が こ の ア ー キ テ ク チ ャ ー で は 実 装 さ れ て い な い 。

バ ー ジ ョ ン

非 同 期 I/O シ ス テ ム コ ー ル は Linux 2.5 で 初 め て 登 場 し た 。

準 拠

io_setup() は Linux 固 有 で あ り 、 移 植 を 想 定 し た プ ロ グ ラ ム で 使 用 す べ き で は な い 。

注 意

glibc は こ の シ ス テ ム コ ー ル の ラ ッ パ ー 関 数 を 提 供 し て い な い 。 syscall(2) を 使 っ て こ の シ ス テ ム コ ー ル を 起 動 す る こ と が で き る 。 し か し 、 た い て い は 、 こ の シ ス テ ム コ ー ル を 呼 び 出 し た い の で は な く 、
libaio
が 提 供 し て い る io_setup ラ ッ パ ー 関 数 を 呼 び 出 し た い 場 合 が ほ と ん ど で あ ろ う 。

libaio の ラ ッ パ ー 関 数 で は ctx_idp 引 き 数 に 別 の 型 (io_context_t *) が 使 わ れ る こ と に 注 意 す る こ と 。 ま た 、 libaio の ラ ッ パ ー 関 数 は 、 エ ラ ー の 通 知 が 通 常 の C ラ イ ブ ラ リ の 慣 習 に し た が っ て お ら ず 、 エ ラ ー の 場 合 に は 負 の エ ラ ー 番 号 (エ ラ ー の 節 に 列 挙 さ れ て い る 値 の 一 つ を 負 に し た も の ) が 返 り 値 と な る 点 に も 注 意 す る こ と 。 syscall(2) 経 由 で シ ス テ ム コ ー ル を 起 動 す る と 、 返 り 値 は 通 常 の エ ラ ー 通 知 の 慣 習 に し た が っ て も の と な り 、 エ ラ ー の 場 合 に は −1 が 返 り 、 errno に エ ラ ー を 示 す (正 の ) 値 が 設 定 さ れ る 。

関 連 項 目

io_cancel(2), io_destroy(2), io_getevents(2), io_submit(2), aio(7)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。