NAME
iodestroy - destroy an asynchronous I/O context SYNOPSIS
#include
/* Defines needed types */ int iodestroy(aiocontextt ctxid); Note: There is no glibc wrapper for this system call; see NOTES. DESCRIPTION The iodestroy() system call will attempt to cancel all outstanding asynchronous I/O operations against ctxid, will block on the comple‐ tion of all operations that could not be canceled, and will destroy the ctxid. RETURN VALUE On success, iodestroy() returns 0. For the failure return, see NOTES. ERRORS EFAULT The context pointed to is invalid. EINVAL The AIO context specified by ctxid is invalid. ENOSYS iodestroy() is not implemented on this architecture. VERSIONS The asynchronous I/O system calls first appeared in Linux 2.5. CONFORMING TO iodestroy() 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. You could invoke it using syscall(2). But instead, you probably want to use the iodestroy() wrapper function provided by libaio. Note that the libaio wrapper function uses a different type (iocon‐ textt) for the ctxid argument. Note also that the libaio wrapper does not follow the usual C library conventions for indicating errors: 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 iocancel(2), iogetevents(2), iosetup(2), iosubmit(2), aio(7) COLOPHON
This 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/.
Linux 2013-04-08 IODESTROY(2)