tail head cat sleep
QR code linking to this page
Main index Section 2
Go to:
日本語Options

Manual Pages  — AIO_RETURN

NAME

aio_return – retrieve return status of asynchronous I/O operation (REALTIME)

CONTENTS

LIBRARY

Standard C Library (libc, -lc)

SYNOPSIS

#include <aio.h>

ssize_t
aio_return(struct aiocb *iocb);

DESCRIPTION

The aio_return() system call returns the final status of the asynchronous I/O request associated with the structure pointed to by iocb.

The aio_return() system call should only be called once, to obtain the final status of an asynchronous I/O operation once it has completed ((aio_error) 2 returns something other than EINPROGRESS).

RETURN VALUES

If the asynchronous I/O request has completed, the status is returned as described in read(2), readv(2), write(2), writev(2), or fsync(2). Otherwise, aio_return() returns -1 and sets errno to indicate the error condition.

ERRORS

The aio_return() system call will fail if:
[EINVAL]
  The iocb argument does not reference a completed asynchronous I/O request.
[EINVAL]
  The I/O operation was submitted with lio_listio(), and the value of the aio_lio_opcode is invalid.

SEE ALSO

aio_cancel(2), aio_error(2), aio_suspend(2), aio_waitcomplete(2), aio_write(2), fsync(2), read(2), write(2), aio(4)

STANDARDS

The aio_return() system call is expected to conform to the IEEE Std 1003.1 ("POSIX.1") standard.

HISTORY

The aio_return() system call first appeared in FreeBSD 3.0 .

AUTHORS

This manual page was written by Wes Peters <Mt wes@softweyr.com>.
AIO_RETURN (2) January 11, 2021
tail head cat sleep
QR code linking to this page
Main index Section 2
Go to:
日本語Options

Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

“ Our grievance is not just against Unix itself, but against the cult of Unix zealots who defend and nurture it. They take the heat, disease, and pestilence as givens, and, as ancient shamans did, display their wounds, some self-inflicted, as proof of their power and wizardry. We aim, through bluntness and humor, to show them that they pray to a tin god, and that science, not religion, is the path to useful and friendly technology. ”
— The Unix Haters' handbook