Content-type: text/html Man page of aio_cancel

aio_cancel

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

aio_cancel - Cancel one or more asynchronous I/O requests pending against the specified file descriptor (P1003.1b)  

SYNOPSIS

#include <aio.h>

int aio_cancel (
int fildes,
struct aiocb *aiocbp);  

PARAMETERS

fildes
The file descriptor against which outstanding asynchronous I/O operations are canceled.
*aiocbp
A pointer to the address of the aiocb structure for a particular request to be canceled. If the aiocbp argument is NULL, all queued outstanding asynchronous I/O requests against the file descriptor are canceled.
 

DESCRIPTION

The aio_cancel function cancels asynchronous I/O requests. Normal signal delivery occurs for asynchronous I/O operations that are successfully canceled. If a request cannot be canceled, then the normal asynchronous completion process takes place for those requests when they are completed.  

RETURN VALUES

On a successful call to the aio_cancel function, the requested operation is canceled, and AIO_CANCELED is returned. If at least one of the requested operations is not canceled because it is in progress, AIO_NOTCANCELED is returned. If all the operations completed prior to the cancel request, AIO_ALLDONE is returned.

On an unsuccessful call, a value of -1 is returned and errno is set to indicate that an error occurred. Note that the value of -1 is returned only if the call itself failed.  

ERRORS

The aio_cancel function fails under the following conditions:

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

RELATED INFORMATION

Functions: aio_group_completion_np(3), aio_read(3), aio_results_np(3), aio_write(3), aio_suspend(3). delim off


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:12 GMT, October 02, 2010