aio_cancel(2)							System Calls Manual						     aio_cancel(2)

NAME

       aio_cancel() - cancel an asynchronous I/O operation

SYNOPSIS

DESCRIPTION

       The  function attempts to cancel the asynchronous I/O request currently outstanding for the referenced by aiocbp or, if aiocbp is any asyn-
       chronous I/O operations currently outstanding for the file descriptor fildes.

       If an asynchronous I/O operation is successfully canceled as a result of its status is set to and any signal delivery  specified  for  that
       operation is performed.	Any outstanding requests that cannot be canceled as a result of the remain enqueued and are unaffected by the can-
       cellation request.

       Asynchronous I/O operations that are requested as a single logical operation are either completed or canceled atomically.  Once any portion
       of  the operation has started, it cannot be canceled.  Whether or not and when an asynchronous I/O operation can be canceled depends on the
       nature of the request.

       If aiocbp is not fildes is ignored.

       To use this function, link in the realtime library by specifying on the compiler or linker command line.

RETURN VALUE

       The function returns one of the following values:

	      The asynchronous I/O operation
			     enqueued for the referenced by aiocbp or all asynchronous I/O operations enqueued for the file referenced	by  fildes
			     have been successfully canceled.

	      The asynchronous I/O operation enqueued for the
			     referenced  by  aiocbp  or at least one of the asynchronous I/O operations enqueued for the file referenced by fildes
			     have not been canceled.  (The function must be used to determine the status of individual operations.)

	      The asynchronous I/O operation enqueued for the
			     referenced by aiocbp or all of the asynchronous I/O operations enqueued for the file referenced by  fildes  completed
			     before cancellation could be attempted.

	      Failure.	     The requested cancellation could not be initiated.  is set to indicate the error.

ERRORS

       If detects one of the following error conditions, is set to the indicated value:

	      [EBADF]	     The aiocbp argument is and the fildes argument is not a valid file descriptor.

	      [EINVAL]	     There was no asynchronous I/O operation enqueued for the referenced by aiocbp.

SEE ALSO

       aio_error(2), aio_fsync(2), aio_read(2), aio_return(2), aio_suspend(2), aio_write(2), lio_listio(2), aio(5).

STANDARDS CONFORMANCE

																     aio_cancel(2)