GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
AIO_CANCEL(2) FreeBSD System Calls Manual AIO_CANCEL(2)

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

Standard C Library (libc, -lc)

#include <aio.h>

int
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 specified, 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:
[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.

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

aio_error(2), aio_read(2), aio_return(2), aio_suspend(2), aio_write(2), aio(4)

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 <wes@softweyr.com>. Christopher M Sedore <cmsedore@maxwell.syr.edu> updated it when aio_cancel() was implemented for FreeBSD 4.0.
January 19, 2000 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 2 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.