Copyright (C) 2021 Stefan Roesch <[email protected]>
SPDX-License-Identifier: LGPL-2.0-or-later
SPDX-License-Identifier: LGPL-2.0-or-later
io_uring_register_files 3 "November 15, 2021" "liburing-2.1" "liburing Manual"
NAME
io_uring_register_files - register file descriptors
SYNOPSIS
#include <liburing.h>"int io_uring_register_files(struct io_uring *" ring "," " const int *" files "," " unsigned " nr_files ");"
"int io_uring_register_files_sparse(struct io_uring *" ring "," " unsigned " nr_files ");"
DESCRIPTION
The io_uring_register_files (3) function registers nr_files number of file descriptors defined by the array files belonging to the ring for subsequent operations. The io_uring_register_files_sparse (3) function registers an empty file table of nr_files number of file descriptors. The sparse variant is available in kernels 5.19 and later. Registering a file table is a prerequisite for using any request that uses direct descriptors.
RETURN VALUE
On success
io_uring_register_files (3) and
io_uring_register_files_sparse (3) return 0. On failure they return
-errno . SEE ALSO
io_uring_get_sqe (3), io_uring_unregister_files (3)