io_uring_register_restrictions(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | COLOPHON

io_uring_re...estrictions(3) liburing Manual io_uring_re...estrictions(3)

NAME         top

       io_uring_register_restrictions - register restrictions with
       io_uring

SYNOPSIS         top

       #include <liburing.h>

       int io_uring_register_restrictions(struct io_uring *ring,
                                          struct io_uring_restriction *res,
                                          unsigned int nr_res);

DESCRIPTION         top

       The io_uring_register_restrictions(3) function registers
       restrictions with the io_uring instance specified by ring.  The
       res argument is a pointer to an array of struct
       io_uring_restriction of nr_res entries.

       Restrictions allow limiting which opcodes, register operations, or
       SQE flags are allowed on a ring. This can be used to sandbox
       io_uring usage.

       Restrictions can only be registered if the io_uring ring was
       started in a disabled state (with IORING_SETUP_R_DISABLED
       specified in the call to io_uring_setup(2)).  All restrictions
       must be registered in a single call before enabling the ring with
       io_uring_enable_rings(3).

       See io_uring_register(2) for a description of the
       IORING_REGISTER_RESTRICTIONS operation and the restriction
       structure.

RETURN VALUE         top

       Returns 0 on success. On error, a negative errno value is
       returned.

SEE ALSO         top

       io_uring_enable_rings(3), io_uring_register(2), io_uring_setup(2)

COLOPHON         top

       This page is part of the liburing (A library for io_uring)
       project.  Information about the project can be found at 
       ⟨https://github.com/axboe/liburing⟩.  If you have a bug report for
       this manual page, send it to io-uring@vger.kernel.org.  This page
       was obtained from the project's upstream Git repository
       ⟨https://github.com/axboe/liburing⟩ on 2026-05-24.  (At that time,
       the date of the most recent commit that was found in the
       repository was 2026-05-18.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

liburing-2.4                 January 18, 2025io_uring_re...estrictions(3)

Pages that refer to this page: io_uring_register_restrictions(3)io_uring_setup_flags(7)