1 .\" Copyright (C) 2003 Free Software Foundation, Inc.
3 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
4 .\" This file is distributed according to the GNU General Public License.
7 .TH IO_DESTROY 2 2017-09-15 "Linux" "Linux Programmer's Manual"
9 io_destroy \- destroy an asynchronous I/O context
12 .BR "#include <linux/aio_abi.h>" " /* Defines needed types */"
14 .BI "int io_destroy(aio_context_t " ctx_id );
18 There is no glibc wrapper for this system call; see NOTES.
24 will attempt to cancel all outstanding asynchronous I/O operations against
26 will block on the completion of all operations
27 that could not be canceled, and will destroy the
33 For the failure return, see NOTES.
37 The context pointed to is invalid.
40 The AIO context specified by \fIctx_id\fP is invalid.
44 is not implemented on this architecture.
47 The asynchronous I/O system calls first appeared in Linux 2.5.
51 is Linux-specific and should not be used in programs
52 that are intended to be portable.
54 Glibc does not provide a wrapper function for this system call.
55 You could invoke it using
57 But instead, you probably want to use the
59 wrapper function provided by
60 .\" http://git.fedorahosted.org/git/?p=libaio.git
65 wrapper function uses a different type
67 .\" But glibc is confused, since <libaio.h> uses 'io_context_t' to declare
74 wrapper does not follow the usual C library conventions for indicating errors:
75 on error it returns a negated error number
76 (the negative of one of the values listed in ERRORS).
77 If the system call is invoked via
79 then the return value follows the usual conventions for
80 indicating an error: \-1, with
82 set to a (positive) value that indicates the error.