*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> aio_cancel (3)              



NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #include <aio.h>

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

LIBRARY    [Toc]    [Back]

       Asynchronous I/O Library (libaio, libaio_raw)

PARAMETERS    [Toc]    [Back]

       The file descriptor against which outstanding asynchronous
       I/O  operations are canceled.  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    [Toc]    [Back]

       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    [Toc]    [Back]

       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

ERRORS    [Toc]    [Back]

       The aio_cancel function fails under the  following  conditions:
 The fildes argument is not a valid file descriptor.

SEE ALSO    [Toc]    [Back]

       Functions:    aio_group_completion_np(3),     aio_read(3),
       aio_results_np(3), aio_write(3), aio_suspend(3)

       Guide to Realtime Programming

[ Back ]
 Similar pages
Name OS Title
unbufcall Tru64 STREAMS: Cancels a pending bufcall request
pthread_testcancel Tru64 Requests delivery of a pending cancellation request to the calling thread
aio_req_per_thread HP-UX desirable ratio between number of pending AIO requests and servicing threads
aio_return Tru64 Returns the status of an asynchronous I/O operation (P1003.1b)
aio_reap HP-UX wait for multiple asynchronous I/O requests
lio_listio Tru64 Initiates a list of asynchronous I/O requests
aio_write Tru64 Queues a single asynchronous write request (P1003.1b)
aio_error Tru64 Returns the error status of a specified asynchronous I/O operation (P1003.1b)
mq_notify Tru64 Attaches a request for asynchronous signal notification to a message queue (P1003.1b)
pxfisatty IRIX Determines if file descriptor corresponds to a valid file descriptor
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service