Differential D31627 Diff 94017 lib/libc/sys/lio_listio.2

Changeset View

Standalone View

lib/libc/sys/lio_listio.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 December 7, 2019			.Dd August 22, 2021
	.Dt LIO_LISTIO 2			.Dt LIO_LISTIO 2
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm lio_listio			.Nm lio_listio
	.Nd "list directed I/O (REALTIME)"			.Nd "list directed I/O (REALTIME)"
	.Sh LIBRARY			.Sh LIBRARY
	.Lb libc			.Lb libc
	.Sh SYNOPSIS			.Sh SYNOPSIS
	Show All 25 Lines
	field of each			field of each
	.Vt aiocb			.Vt aiocb
	specifies the operation to be performed.			specifies the operation to be performed.
	The following operations are supported:			The following operations are supported:
	.Bl -tag -width ".Dv LIO_WRITE"			.Bl -tag -width ".Dv LIO_WRITE"
	.It Dv LIO_READ			.It Dv LIO_READ
	Read data as if by a call to			Read data as if by a call to
	.Xr aio_read 2 .			.Xr aio_read 2 .
				.It Dv LIO_READV
				Read data as if by a call to
				.Xr aio_readv 2 .
	.It Dv LIO_NOP			.It Dv LIO_NOP
	No operation.			No operation.
	.It Dv LIO_WRITE			.It Dv LIO_WRITE
	Write data as if by a call to			Write data as if by a call to
	.Xr aio_write 2 .			.Xr aio_write 2 .
				.It Dv LIO_WRITEV
				Write data as if by a call to
				.Xr aio_writev 2 .
	.El			.El
	.Pp			.Pp
	If the			If the
	.Fa mode			.Fa mode
	argument is			argument is
	.Dv LIO_WAIT ,			.Dv LIO_WAIT ,
	.Fn lio_listio			.Fn lio_listio
	does not return until all the requested operations have been completed.			does not return until all the requested operations have been completed.
	▲ Show 20 Lines • Show All 118 Lines • ▼ Show 20 Lines
	some of the requests may have been initiated.			some of the requests may have been initiated.
	The caller should check the error status of each			The caller should check the error status of each
	.Vt aiocb			.Vt aiocb
	structure individually by calling			structure individually by calling
	.Xr aio_error 2 .			.Xr aio_error 2 .
	.Sh SEE ALSO			.Sh SEE ALSO
	.Xr aio_error 2 ,			.Xr aio_error 2 ,
	.Xr aio_read 2 ,			.Xr aio_read 2 ,
				.Xr aio_readv 2 ,
	.Xr aio_write 2 ,			.Xr aio_write 2 ,
				.Xr aio_writev 2 ,
	.Xr read 2 ,			.Xr read 2 ,
	.Xr write 2 ,			.Xr write 2 ,
	.Xr sigevent 3 ,			.Xr sigevent 3 ,
	.Xr siginfo 3 ,			.Xr siginfo 3 ,
	.Xr aio 4			.Xr aio 4
	.Sh STANDARDS			.Sh STANDARDS
	The			The
	.Fn lio_listio			.Fn lio_listio
	function is expected to conform to			function is expected to conform to
	.St -p1003.1-2001 .			.St -p1003.1-2001 .
				The
				.Dv LIO_READV
				and
				.Dv LIO_WRITEV
				operations are
				kibUnsubmitted Done Inline Actions s/FreeeBSD/.Fx/ kib: s/FreeeBSD/.Fx/
				.Fx extensions, and should not be used in portable code.
	.Sh HISTORY			.Sh HISTORY
	The			The
	.Fn lio_listio			.Fn lio_listio
	system call first appeared in			system call first appeared in
	.Fx 3.0 .			.Fx 3.0 .