Module nix::sys::aio

POSIX Asynchronous I/O

The POSIX AIO interface is used for asynchronous I/O on files and disk-like devices. It supports read, write, and fsync operations. Completion notifications can optionally be delivered via signals, via the aio_suspend function, or via polling. Some platforms support other completion notifications, such as kevent.

Multiple operations may be submitted in a batch with lio_listio, though the standard does not guarantee that they will be executed atomically.

Outstanding operations may be cancelled with cancel or aio_cancel_all, though the operating system may not support this for all filesystems and devices.

Structs

AioCb	AIO Control Block.
LioCb	LIO Control Block.

Enums

AioCancelStat	Return values for AioCb::cancel and aio_cancel_all
AioFsyncMode	Mode for AioCb::fsync. Controls whether only data or both data and metadata are synced.
Buffer	Owns (uniquely or shared) a memory buffer to keep it from Droping while the kernel has a pointer to it.
LioMode	Mode for lio_listio
LioOpcode	When used with lio_listio, determines whether a given aiocb should be used for a read operation, a write operation, or ignored. Has no effect for any other aio functions.

Functions

aio_cancel_all	Cancels outstanding AIO requests for a given file descriptor.
aio_suspend	Suspends the calling process until at least one of the specified AioCbs has completed, a signal is delivered, or the timeout has passed.