Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
AIO_RETURN(2)		      System Calls Manual		 AIO_RETURN(2)

NAME
       aio_return -- retrieve return status of asynchronous I/O	operation (RE-
       ALTIME)

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 asynchro-
       nous 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 <wes@softweyr.com>.

FreeBSD	13.2		       January 11, 2021			 AIO_RETURN(2)

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | STANDARDS | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=aio_return&sektion=2&manpath=FreeBSD+14.2-RELEASE+and+Ports>

home | help