]>
Commit | Line | Data |
---|---|---|
fea681da MK |
1 | .\" Copyright (C) 2003 Free Software Foundation, Inc. |
2 | .\" This file is distributed according to the GNU General Public License. | |
3 | .\" See the file COPYING in the top level source directory for details. | |
4 | .\" | |
d12c1424 MK |
5 | .\" .de Sh \" Subsection |
6 | .\" .br | |
7 | .\" .if t .Sp | |
8 | .\" .ne 5 | |
9 | .\" .PP | |
10 | .\" \fB\\$1\fR | |
11 | .\" .PP | |
12 | .\" .. | |
13 | .\" .de Sp \" Vertical space (when we can't use .PP) | |
14 | .\" .if t .sp .5v | |
15 | .\" .if n .sp | |
16 | .\" .. | |
17 | .\" .de Ip \" List item | |
18 | .\" .br | |
19 | .\" .ie \\n(.$>=3 .ne \\$3 | |
20 | .\" .el .ne 3 | |
21 | .\" .IP "\\$1" \\$2 | |
22 | .\" .. | |
fea681da MK |
23 | .TH "IO_DESTROY" 2 "2003-02-21" "Linux 2.4" "Linux Programmer's Manual" |
24 | .SH NAME | |
d12c1424 | 25 | io_destroy \- destroy an asynchronous I/O context |
fea681da | 26 | .SH "SYNOPSIS" |
d12c1424 MK |
27 | .nf |
28 | .\" .ad l | |
29 | .\" .hy 0 | |
30 | .B #include <libaio.h> | |
e2b013ad | 31 | .\" #include <linux/aio.h> |
fea681da | 32 | .sp |
d12c1424 MK |
33 | .\" .HP 17 |
34 | .BI "int io_destroy(aio_context_t " ctx ); | |
35 | .\" .ad | |
36 | .\" .hy | |
37 | .fi | |
fea681da | 38 | .SH "DESCRIPTION" |
fea681da | 39 | .PP |
c13182ef MK |
40 | \fBio_destroy\fR() removes the asynchronous I/O context from the list of |
41 | I/O contexts and then destroys it. | |
42 | \fBio_destroy\fR() can also cancel any outstanding asynchronous I/O | |
fea681da | 43 | actions on \fIctx\fR and block on completion. |
fea681da | 44 | .SH "RETURN VALUE" |
fea681da | 45 | .PP |
d12c1424 MK |
46 | \fBio_destroy\fR() returns 0 on success; |
47 | on failure, it returns one of the errors listed under ERRORS. | |
48 | .SH "ERRORS" | |
fea681da | 49 | .SH "ERRORS" |
fea681da | 50 | .TP |
d12c1424 | 51 | .B EINVAL |
fea681da | 52 | The AIO context specified by \fIctx\fR is invalid. |
fea681da | 53 | .TP |
d12c1424 | 54 | .B EFAULT |
fea681da | 55 | The context pointed to is invalid. |
fea681da | 56 | .TP |
d12c1424 | 57 | .B ENOSYS |
e511ffb6 | 58 | \fBio_destroy\fR() is not implemented on this architecture. |
fea681da | 59 | .SH "CONFORMING TO" |
fea681da | 60 | .PP |
c13182ef | 61 | \fBio_destroy\fR() is Linux specific and should not be used in programs |
fea681da | 62 | that are intended to be portable. |
fea681da | 63 | .SH "VERSIONS" |
fea681da MK |
64 | .PP |
65 | The asynchronous I/O system calls first appeared in Linux 2.5, August 2002. | |
fea681da | 66 | .SH "SEE ALSO" |
fea681da | 67 | .PP |
c13182ef | 68 | \fBio_setup\fR(2), \fBio_submit\fR(2), \fBio_getevents\fR(2), |
75b48e9d | 69 | \fBio_cancel\fR(2). |
d12c1424 | 70 | .\" .SH "NOTES" |
c13182ef | 71 | .\" |
d12c1424 MK |
72 | .\" .PP |
73 | .\" The asynchronous I/O system calls were written by Benjamin LaHaise. | |
c13182ef | 74 | .\" |
d12c1424 MK |
75 | .\" .SH AUTHOR |
76 | .\" Kent Yoder. |