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


Manual Reference Pages  -  AIO_CANCEL (2)

NAME

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

CONTENTS

Library
Synopsis
Description
Restrictions
Return Values
Errors
See Also
Standards
History
Authors

LIBRARY


.Lb libc

SYNOPSIS


.In aio.h int aio_cancel int fildes struct aiocb *iocb

DESCRIPTION

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.

RESTRICTIONS

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.

RETURN VALUES

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.

ERRORS

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

SEE ALSO

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

STANDARDS

The aio_cancel system call is expected to conform to the -p1003.1 standard.

HISTORY

The aio_cancel system call first appeared in
.Fx 3.0 . The first functional implementation of aio_cancel appeared in
.Fx 4.0 .

AUTHORS


.An -nosplit This manual page was originally written by
.An Wes Peters Aq wes@softweyr.com .
.An Christopher M Sedore Aq cmsedore@maxwell.syr.edu updated it when aio_cancel was implemented for
.Fx 4.0 .
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 manServer 1.07.