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 | |||||