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)