FreeBSD 4.6.2 manual page repository

FreeBSD is a free computer operating system based on BSD UNIX originally. Many IT companies, like DeployIS is using it to provide an up-to-date, stable operating system.

aio_cancel - cancel an outstanding asynchronous I/O operation (REALTIME)

 

NAME

      aio_cancel - cancel an outstanding asynchronous I/O operation (REALTIME)
 

LIBRARY

      Standard C Library (libc, -lc)
 

SYNOPSIS

      #include <aio.h>
 
      int
      aio_cancel(int fildes, struct aiocb * iocb);
 

DESCRIPTION

      The aio_cancel() function cancels the outstanding asynchronous I/O
      request for the file descriptor specified in fildes.  If iocb is speci‐
      fied, only that specific asynchronous I/O request is cancelled.
 
      Normal asynchronous notification occurs for cancelled requests.  Requests
      complete with an error result of ECANCELED.
 

RESTRICTIONS

      The aio_cancel() function does not cancel asynchronous I/O requests for
      raw disk devices.  The aio_cancel() function will always return
      AIO_NOTCANCELED for file descriptors associated with raw disk devices.
      The aio_cancel() function returns -1 to indicate an error, or one of the
      following:
 
      [AIO_CANCELED]
                    All outstanding requests meeting the criteria specified
                    were cancelled.
 
      [AIO_NOTCANCELED]
                    Some requests were not cancelled, status for the requests
                    should be checked with aio_error(2).
 
      [AIO_ALLDONE]
                    All of the requests meeting the criteria have finished.
      aio_error(2), aio_read(2), aio_return(2), aio_suspend(2), aio_write(2)
 

ERRORS

      An error return from aio_cancel() indicates:
 
      [EBADF]            fildes is an invalid file descriptor.
 

STANDARDS

      The aio_cancel() function is expected to conform to the IEEE Std 1003.2
      (“POSIX.2”) standard.
 

HISTORY

      The aio_cancel() function first appeared in FreeBSD 3.0.  The first func‐
      tional implementation of aio_cancel() appeared in FreeBSD 4.0.
 

AUTHORS

      This manual page was originally written by Wes Peters 〈wes@softweyr.com〉.
      Christopher M Sedore 〈cmsedore@maxwell.syr.edu〉 updated it when
      aio_cancel() was implemented for FreeBSD 4.0.
 

Sections

Based on BSD UNIX
FreeBSD is an advanced operating system for x86 compatible (including Pentium and Athlon), amd64 compatible (including Opteron, Athlon64, and EM64T), UltraSPARC, IA-64, PC-98 and ARM architectures. It is derived from BSD, the version of UNIX developed at the University of California, Berkeley. It is developed and maintained by a large team of individuals. Additional platforms are in various stages of development.
 

Warning: mysql_close() expects parameter 1 to be resource, object given in /home/unixmanpages/sites_v1/index.php on line 360