.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
.\" USA.
.\"
-.\" Japanese Version Copyright (c) 2004 Yuichi SATO
-.\" all rights reserved.
-.\" Translated Thu Jul 01 02:44:30 JST 2004
-.\" by Yuichi SATO <ysato444@yahoo.co.jp>
+.\"*******************************************************************
.\"
-.TH AIO_CANCEL 3 2003-11-14 "" "Linux Programmer's Manual"
-.\"O .SH NAME
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH AIO_CANCEL 3 2011\-10\-04 "" "Linux Programmer's Manual"
.SH 名前
-.\"O aio_cancel \- cancel an outstanding asynchronous I/O request
aio_cancel \- 完了していない非同期 I/O リクエストをキャンセルする
-.\"O .SH SYNOPSIS
.SH 書式
-.B "#include <aio.h>"
+\fB#include <aio.h>\fP
.sp
-.BI "int aio_cancel(int " fd ", struct aiocb *" aiocbp );
+\fBint aio_cancel(int \fP\fIfd\fP\fB, struct aiocb *\fP\fIaiocbp\fP\fB);\fP
.sp
-.\"O Link with \fI\-lrt\fP.
\fI\-lrt\fP でリンクする。
-.\"O .SH DESCRIPTION
.SH 説明
-.\"O The
-.\"O .BR aio_cancel ()
-.\"O function attempts to cancel outstanding asynchronous I/O requests
-.\"O for the file descriptor
-.\"O .IR fd .
-.BR aio_cancel ()
-関数は、ファイルディスクリプタ
-.I fd
-についての完了していない非同期 I/O リクエストをキャンセルしようとする。
-.\"O If
-.\"O .I aiocbp
-.\"O is NULL, all such requests are canceled.
-.\"O Otherwise, only the request
-.\"O described by the control block pointed to by
-.\"O .I aiocbp
-.\"O is canceled.
-.I aiocbp
-が NULL の場合、そのような全てのリクエストがキャンセルされる。
-.I aiocbp
-が NULL でない場合、
-.I aiocbp
-で指された制御ブロックで記述されたリクエストのみがキャンセルされる。
+\fBaio_cancel\fP() 関数は、ファイルディスクリプタ \fIfd\fP についての完了していない
+非同期 I/O リクエストをキャンセルしようとする。 \fIaiocbp\fP が NULL の場合、そ
+のような全てのリクエストがキャンセルされる。 \fIaiocbp\fP が NULL でない場合、
+\fIaiocbp\fP で指された制御ブロックで記述されたリクエストのみがキャンセルされる。
+(\fIaiocb\fP 構造体の説明は \fBaio\fP(7) を参照)
.LP
-.\"O Normal asynchronous notification occurs for canceled requests.
キャンセルされたリクエストに対して、通常の非同期通知が起こる。
-.\"O The request return status is set to \-1, and the request error status
-.\"O is set to
-.\"O .BR ECANCELED .
-リクエストの返り値は \-1 に設定され、
-リクエストのエラー状態は
-.B ECANCELED
-に設定される。
-.\"O The control block of requests that cannot be canceled is not changed.
-キャンセルできなかったリクエストの制御ブロックは変更されない。
+リクエストの返り値 (\fBaio_return\fP(3)) は \-1 に設定され、
+リクエストのエラー状態 (\fBaio_error\fP(3)) は \fBECANCELED\fP に設定される。
+キャンセルできないリクエストの制御ブロックは変更されない。
.LP
-.\"O If
-.\"O .I aiocbp
-.\"O is not NULL, and
-.\"O .I fd
-.\"O differs from the file descriptor with which the asynchronous operation
-.\"O was initiated, unspecified results occur.
-.I aiocbp
-が NULL でなく、かつ
-.I fd
-が非同期操作が開始されたファイルディスクリプタと異なる場合、
-生じる結果は不定である。
+\fIaiocbp\fP が NULL でなく、かつ \fIfd\fP が非同期操作が開始されたファイルディスクリプタと異なる場合、 生じる結果は不定である。
.LP
-.\"O Which operations are cancellable is implementation-defined.
+.\" FreeBSD: not those on raw disk devices.
どの操作をキャンセルできるかは、実装定義である。
-.\"O .\" FreeBSD: not those on raw disk devices.
-.\" FreeBSD: raw ディスクデバイスへのリクエストはキャンセルできない。
-.\"O .SH "RETURN VALUE"
.SH 返り値
-.\"O This function returns
-.\"O .B AIO_CANCELED
-.\"O if all requests were successfully
-.\"O canceled.
-.\"O It returns
-.\"O .B AIO_NOTCANCELED
-.\"O when at least one of the
-.\"O requests specified was not canceled because it was in progress.
-全てのリクエストのキャンセルが成功した場合、この関数は
-.B AIO_CANCELED
-を返す。
-指定されたリクエストのうち少なくとも 1 つが進行中であるために
-キャンセルできなかった場合は、
-.B AIO_NOTCANCELED
-が返される。
-.\"O In this case one may check the status of individual requests using
-.\"O .BR aio_error (3).
-この場合は、
-.BR aio_error (3)
-を使って個々のリクエストの状態をチェックすることができる。
-.\"O This function returns
-.\"O .B AIO_ALLDONE
-.\"O when all requests had
-.\"O been completed already before this call.
-呼び出される前に全てのリクエストが完了していた場合、
-この関数は
-.B AIO_ALLDONE
-を返す。
-.\"O When some error occurs, \-1 is returned, and
-.\"O .I errno
-.\"O is set appropriately.
-何らかのエラーが起こった場合は、\-1 が返されて、
-.I errno
-が適切に設定される。
-.\"O .SH ERRORS
+全てのリクエストのキャンセルが成功した場合、この関数は \fBAIO_CANCELED\fP を返す。 指定されたリクエストのうち少なくとも 1
+つが進行中であるために キャンセルできなかった場合は、 \fBAIO_NOTCANCELED\fP が返される。 この場合は、 \fBaio_error\fP(3)
+を使って個々のリクエストの状態をチェックすることができる。 呼び出される前に全てのリクエストが完了していた場合、 この関数は
+\fBAIO_ALLDONE\fP を返す。 何らかのエラーが起こった場合は、\-1 が返されて、 \fIerrno\fP が適切に設定される。
.SH エラー
-.TP
-.B EBADF
-.\"O .I fd
-.\"O is not a valid file descriptor.
-.I fd
-が有効なファイルディスクリプタでない。
-.\"O .SH "CONFORMING TO"
+.TP
+\fBEBADF\fP
+\fIfd\fP が有効なファイルディスクリプタでない。
+.SH バージョン
+\fBaio_cancel\fP() 関数は glibc 2.1 以降で利用できる。
.SH 準拠
-POSIX.1-2001.
-.\"O .SH "SEE ALSO"
+POSIX.1\-2001, POSIX.1\-2008.
+.SH 例
+\fBaio\fP(7) を参照。
.SH 関連項目
-.BR aio_error (3),
-.BR aio_fsync (3),
-.BR aio_read (3),
-.BR aio_return (3),
-.BR aio_suspend (3),
-.BR aio_write (3)
+\fBaio_error\fP(3), \fBaio_fsync\fP(3), \fBaio_read\fP(3), \fBaio_return\fP(3),
+\fBaio_suspend\fP(3), \fBaio_write\fP(3), \fBlio_listio\fP(3), \fBaio\fP(7)
OSDN Git Service
