xref: /aosp_15_r20/external/liburing/man/io_uring_register_files.3 (revision 25da2bea747f3a93b4c30fd9708b0618ef55a0e6)
Copyright (C) 2021 Stefan Roesch <[email protected]>

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)