Sha256: cb715c8ccfceb47ed1163c2a29a9fa2a6b8bc9b2bb02d2695baa1796bd7c7ef6

Contents?: true

Size: 1.33 KB

Versions: 8

Compression:

Stored size: 1.33 KB

Contents

.\" Copyright (C) 2021 Stefan Roesch <shr@fb.com>
.\"
.\" SPDX-License-Identifier: LGPL-2.0-or-later
.\"
.TH io_uring_register_buffers 3 "November 15, 2021" "liburing-2.1" "liburing Manual"
.SH NAME
io_uring_register_buffers - register buffers for fixed buffer operations
.fi
.SH SYNOPSIS
.nf
.BR "#include <liburing.h>"
.PP
.BI "int io_uring_register_buffers(struct io_uring *ring,"
.BI "                              const struct iovec *iovecs,
.BI "                              unsigned nr_iovecs)"
.PP
.SH DESCRIPTION
.PP
The io_uring_register_buffers() function registers
.I nr_iovecs
number of buffers defined by the array
.I iovecs
belonging to the
.I ring.

After the caller has registered the buffers, they can be used with one of the
fixed buffers functions.

Registered buffers is an optimization that is useful in conjunction with
.B O_DIRECT
reads and writes, where maps the specified range into the kernel once when
the buffer is registered, rather than doing a map and unmap for each IO
every time IO is performed to that region. Additionally, it also avoids
manipulating the page reference counts for each IO.

.SH RETURN VALUE
On success
.BR io_uring_register_buffers (3)
returns 0. On failure it returns -errno.
.SH SEE ALSO
.BR io_uring_get_sqe (3), io_uring_unregister_buffers (3), io_uring_prep_read_fixed (3), io_uring_prep_write_fixed (3)

Version data entries

8 entries across 8 versions & 1 rubygems

Version Path
polyphony-0.94 vendor/liburing/man/io_uring_register_buffers.3
polyphony-0.93 vendor/liburing/man/io_uring_register_buffers.3
polyphony-0.92 vendor/liburing/man/io_uring_register_buffers.3
polyphony-0.91 vendor/liburing/man/io_uring_register_buffers.3
polyphony-0.90 vendor/liburing/man/io_uring_register_buffers.3
polyphony-0.89 vendor/liburing/man/io_uring_register_buffers.3
polyphony-0.87 vendor/liburing/man/io_uring_register_buffers.3
polyphony-0.86 vendor/liburing/man/io_uring_register_buffers.3