lio_listio
Section: C Library Functions (3)
Updated: 2026-02-08
Index
JM Home Page
roff page
名前
lio_listio - リストの I/O リクエストを開始する
ライブラリ
リアルタイムライブラリ (librt,~-lrt)
書式
#include <aio.h>
int lio_listio(int n;
int mode,
struct aiocb *restrict const aiocb_list[restrict n],
int n, struct sigevent *restrict sevp);
説明
lio_listio() 関数は、配列 aiocb_list で指定された I/O 操作の
リストをそれぞれ開始する。
mode 引数には以下のいずれかの値を指定する。
- LIO_WAIT
-
全ての操作が完了するまで、呼び出しは停止 (block) する。
sevp 引数は無視される。
- LIO_NOWAIT
-
The I/O operations are queued for processing and the call returns
immediately. When all of the I/O operations complete, asynchronous
notification occurs, as specified by the sevp argument; see
sigevent(3type) for details. If sevp is NULL, no asynchronous
notification occurs.
The aiocb_list argument is an array of pointers to aiocb structures
that describe I/O operations. These operations are executed in an
unspecified order. The n argument specifies the size of the array
aiocb_list. Null pointers in aiocb_list are ignored.
aiocb_list の各制御ブロックでは、
aio_lio_opcode フィールドで開始する I/O 操作を指定する。
aio_lio_opcode には以下の値が指定できる。
- LIO_READ
-
読み出し操作を開始する。操作はキューに入れられ、
この制御ブロックを指定して aio_read(3) の呼び出しが行われる。
- LIO_WRITE
-
書き込み操作を開始する。操作はキューに入れられ、
この制御ブロックを指定して aio_write(3) の呼び出しが行われる。
- LIO_NOP
-
この制御ブロックを無視する。
各制御ブロックの残りのフィールドは、
aio_read(3) や aio_write(3) の場合と同じ意味を持つ。
各制御ブロックの aio_sigevent フィールドは、
個々の I/O 操作で通知方法を指定するのに使用される
(sigevent(7) 参照)。
返り値
mode が LIO_NOWAIT の場合、 lio_listio() は全ての操作が
正常にキューに入れられた場合に 0 を返す。
そうでない場合は、-1 が返り、 errno にエラーを示す値が設定される。
mode が LIO_WAIT の場合、 lio_listio() は全ての操作が
正常に完了した場合に 0 を返す。
そうでない場合は、-1 が返り、 errno にエラーを示す値が設定される。
lio_listio() の返り値から得られる情報は、関数呼び出し自体に関する
ものだけであり、個々の I/O 操作に関する情報は得られない。
個々の I/O 操作は失敗することがあるが、これにより他の I/O 操作が完了
しなくなるといったことはない。 aio_error(3) を使うと、
aiocb_list の個々の I/O 操作のステータスを知ることができる。
ある I/O 操作が完了すると、その終了ステータスはaio_return(3) を使う
ことで取得できる。個々の I/O 操作は aio_read(3) や aio_write(3)
に書かれている理由で失敗する場合がある。
エラー
lio_listio() 関数は以下の理由で失敗する。
- EAGAIN
-
リソースが足りない。
- EAGAIN
-
The number of I/O operations specified by n would cause the limit
AIO_MAX to be exceeded.
- EINTR
-
mode が LIO_WAIT で、全ての I/O 操作が完了する前にシグナルが捕捉された。 signal(7) 参照。 (非同期
I/O の完了通知に使用されるシグナルの場合もこれに該当する)。
- EINVAL
-
mode is invalid, or n exceeds the limit AIO_LISTIO_MAX.
- EIO
-
aiocb_list で指定された操作の中に失敗したものがあった。
アプリケーションは、 aio_return(3) を使用して、
個々の操作のステータスを確認することができる。
lio_listio がエラー EAGAIN, EINTR, EIO で失敗した場合、
aiocb_list で指定した操作のいくつかは開始されていることがある。
lio_listio が他の理由で失敗した場合には、
どの I/O 操作も開始されていない。
属性
この節で使用されている用語の説明については、 attributes(7) を参照。
| インターフェース | 属性 | 値
|
|
lio_listio()
| Thread safety | MT-Safe
|
標準規格
POSIX.1-2008.
歴史
glibc 2.1. POSIX.1-2001.
注意
使用前に制御ブロックを 0 で埋めるのは良い考えである。
I/O 操作の実行中は制御ブロックを変更してはならない。データの読み書き先
のバッファー領域に I/O 操作の実行中にアクセスしてはならない。さもないと、
どのような結果になるか分からない。また、関係するメモリー領域も有効な状態
のままにしておかなければならない。
同じ aiocb 構造体を指定して同時に複数の I/O 操作を行った場合、
どのような結果になるかは不定である。
関連項目
aio_cancel(3), aio_error(3), aio_fsync(3), aio_return(3),
aio_suspend(3), aio_write(3), aio(7)
Index
- 名前
-
- ライブラリ
-
- 書式
-
- 説明
-
- 返り値
-
- エラー
-
- 属性
-
- 標準規格
-
- 歴史
-
- 注意
-
- 関連項目
-
This document was created by
man2html,
using the manual pages.