|IO_DESTROY(2)||Linux Programmer's Manual||IO_DESTROY(2)|
NAMEio_destroy - destroy an asynchronous I/O context
#include <linux/aio_abi.h> /* Defines needed types */
int io_destroy(aio_context_t ctx_id);
Note: There is no glibc wrapper for this system call; see NOTES.
DESCRIPTIONThe io_destroy() system call will attempt to cancel all outstanding asynchronous I/O operations against ctx_id, will block on the completion of all operations that could not be canceled, and will destroy the ctx_id.
RETURN VALUEOn success, io_destroy() returns 0. For the failure return, see NOTES.
- The context pointed to is invalid.
- The AIO context specified by ctx_id is invalid.
- io_destroy() is not implemented on this architecture.
VERSIONSThe asynchronous I/O system calls first appeared in Linux 2.5.
CONFORMING TOio_destroy() is Linux-specific and should not be used in programs that are intended to be portable.
NOTESGlibc does not provide a wrapper function for this system call. You could invoke it using syscall(2). But instead, you probably want to use the io_destroy() wrapper function provided by libaio.
SEE ALSOio_cancel(2), io_getevents(2), io_setup(2), io_submit(2), aio(7)
COLOPHONThis page is part of release 3.53 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/.