io_destroyのヘルプ・マニュアル
日本語 英語
io_destroy --help
man io_destroy
IO_DESTROY(2) Linux Programmer’s Manual IO_DESTROY(2)
名前
io_destroy - 非同期 I/O コンテキストの消去
書式
#include
int io_destroy(aio_context_t ctx);
-laio とリンクする。
説明
io_destroy() は、I/O コンテキストのリストから指定された非同期 I/O コン
テキストを削除した後、そのコンテキストを消去する。 io_destroy() は、ctx
上に未処理の非同期 I/O 命令及び完了キューのブロックの取り消しも行うこと
ができる。
返り値
成功した場合、 io_destroy() は 0 を返す。失敗時の返り値については、「注
意」の節を参照すること。
エラー
EFAULT データ構造の中に無効なデータを指しているものがある。
EINVAL ctx で指定された AIO コンテキストが無効である。
ENOSYS io_destroy() はこのアーキテクチャでは実装されていない。
バージョン
非同期 I/O システム・コールは 2002年8月に Linux 2.5 で初めて登場した。
準拠
io_destroy() は Linux 固有であり、移植を想定したプログラムで使用すべき
ではない。
注意
glibc はこのシステムコール用のラッパー関数を提供していない。
libaio で io_destroy() 用に提供されているラッパー関数は、エラーの通知が
通常の C ライブラリの慣習にしたがっておらず、エラーの場合には負のエラー
番号 (エラーの節に列挙されている値の一つを負にしたもの) が返り値とな る
。 syscall(2) 経由でシステムコールを起動すると、返り値は通常のエラー通
知の慣習にしたがってものとなり、エラーの場合には -1 が返り、 errno にエ
ラーを示す (正の) 値が設定される。
関連項目
io_cancel(2), io_getevents(2), io_setup(2), io_submit(2)
Linux 2008-06-18 IO_DESTROY(2)
IO_DESTROY(2) Linux Programmer’s Manual IO_DESTROY(2)
NAME
io_destroy - destroy an asynchronous I/O context
SYNOPSIS
#include
int io_destroy(aio_context_t ctx);
Link with -laio.
DESCRIPTION
io_destroy() removes the asynchronous I/O context from the list of I/O
contexts and then destroys it. io_destroy() can also cancel any out-
standing asynchronous I/O actions on ctx and block on completion.
RETURN VALUE
On success, io_destroy() returns 0. For the failure return, see NOTES.
ERRORS
EFAULT The context pointed to is invalid.
EINVAL The AIO context specified by ctx is invalid.
ENOSYS io_destroy() is not implemented on this architecture.
VERSIONS
The asynchronous I/O system calls first appeared in Linux 2.5, August
2002.
CONFORMING TO
io_destroy() is Linux-specific and should not be used in programs that
are intended to be portable.
NOTES
Glibc does not provide a wrapper function for this system call.
The wrapper provided in libaio for io_destroy() does not follow the
usual C library conventions for indicating error: on error it returns a
negated error number (the negative of one of the values listed in
ERRORS). If the system call is invoked via syscall(2), then the return
value follows the usual conventions for indicating an error: -1, with
errno set to a (positive) value that indicates the error.
SEE ALSO
io_cancel(2), io_getevents(2), io_setup(2), io_submit(2)
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/.
Linux 2008-06-18 IO_DESTROY(2)