.\" Copyright (C) 2021 Stefan Roesch <shr@fb.com>
.\"
.\" SPDX-License-Identifier: LGPL-2.0-or-later
.\"
.TH io_uring_register_files 3 "November 15, 2021" "liburing-2.1" "liburing Manual"
.SH NAME
io_uring_register_files - register file descriptors
.fi
.SH SYNOPSIS
.nf
.BR "#include <liburing.h>"
.PP
.BI "int io_uring_register_files(struct io_uring *" ring ","
.BI " const int *" files ","
.BI " unsigned " nr_files ");"
.PP
.SH DESCRIPTION
.PP
The io_uring_register_files() function registers
.I nr_files
number of file descriptors defined by the array
.I files
belonging to the
.I ring
for subsequent operations.
After the caller has registered the buffers, they can be used with the
submission queue polling operations.
.SH RETURN VALUE
On success
.BR io_uring_register_files (3)
returns 0. On failure it returns -errno.
.SH SEE ALSO
.BR io_uring_get_sqe (3), io_uring_unregister_files (3)