Changeset View
Changeset View
Standalone View
Standalone View
lib/libc/sys/aio_error.2
Show All 18 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd June 2, 1999 | .Dd December 15, 2020 | ||||
.Dt AIO_ERROR 2 | .Dt AIO_ERROR 2 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm aio_error | .Nm aio_error | ||||
.Nd retrieve error status of asynchronous I/O operation (REALTIME) | .Nd retrieve error status of asynchronous I/O operation (REALTIME) | ||||
.Sh LIBRARY | .Sh LIBRARY | ||||
.Lb libc | .Lb libc | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
Show All 11 Lines | |||||
.Fn aio_error | .Fn aio_error | ||||
returns 0. | returns 0. | ||||
If the request has not yet completed, | If the request has not yet completed, | ||||
.Er EINPROGRESS | .Er EINPROGRESS | ||||
is returned. | is returned. | ||||
If the request has completed unsuccessfully the error | If the request has completed unsuccessfully the error | ||||
status is returned as described in | status is returned as described in | ||||
.Xr read 2 , | .Xr read 2 , | ||||
.Xr readv 2 , | |||||
.Xr write 2 , | .Xr write 2 , | ||||
.Xr writev 2 , | |||||
or | or | ||||
.Xr fsync 2 . | .Xr fsync 2 . | ||||
On failure, | On failure, | ||||
.Fn aio_error | .Fn aio_error | ||||
returns | returns | ||||
.Dv -1 | .Dv -1 | ||||
and sets | and sets | ||||
.Dv errno | .Dv errno | ||||
to indicate the error condition. | to indicate the error condition. | ||||
.Sh ERRORS | .Sh ERRORS | ||||
The | The | ||||
.Fn aio_error | .Fn aio_error | ||||
system call will fail if: | system call will fail if: | ||||
.Bl -tag -width Er | .Bl -tag -width Er | ||||
.It Bq Er EINVAL | .It Bq Er EINVAL | ||||
The | The | ||||
.Fa iocb | .Fa iocb | ||||
argument | argument | ||||
does not reference an outstanding asynchronous I/O request. | does not reference an outstanding asynchronous I/O request. | ||||
.El | .El | ||||
.Sh SEE ALSO | .Sh SEE ALSO | ||||
.Xr aio_cancel 2 , | .Xr aio_cancel 2 , | ||||
.Xr aio_read 2 , | .Xr aio_read 2 , | ||||
.Xr aio_readv 2 , | |||||
.Xr aio_return 2 , | .Xr aio_return 2 , | ||||
.Xr aio_suspend 2 , | .Xr aio_suspend 2 , | ||||
.Xr aio_write 2 , | .Xr aio_write 2 , | ||||
.Xr aio_writev 2 , | |||||
.Xr fsync 2 , | .Xr fsync 2 , | ||||
.Xr read 2 , | .Xr read 2 , | ||||
.Xr write 2 , | .Xr write 2 , | ||||
.Xr aio 4 | .Xr aio 4 | ||||
.Sh STANDARDS | .Sh STANDARDS | ||||
The | The | ||||
.Fn aio_error | .Fn aio_error | ||||
system call | system call | ||||
Show All 12 Lines |