FreeBSD 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)



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


      Standard C Library (libc, -lc)


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


      The aio_cancel() system call 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.


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


      An error return from aio_cancel() indicates:
      [EBADF]            The fildes argument is an invalid file descriptor.
      aio_error(2), aio_read(2), aio_return(2), aio_suspend(2), aio_write(2),


      The aio_cancel() system call is expected to conform to the IEEE Std
      1003.1 (“POSIX.1”) standard.


      The aio_cancel() system call first appeared in FreeBSD 3.0.  The first
      functional implementation of aio_cancel() appeared in FreeBSD 4.0.


      This manual page was originally written by Wes Peters 〈〉.
      Christopher M Sedore 〈〉 updated it when
      aio_cancel() was implemented for FreeBSD 4.0.


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.