open/openat2: update man page to include IORING_FILE_INDEX_ALLOC Signed-off-by: Jens Axboe <axboe@kernel.dk>
diff --git a/man/io_uring_prep_openat.3 b/man/io_uring_prep_openat.3 index 8094619..b0f0946 100644 --- a/man/io_uring_prep_openat.3 +++ b/man/io_uring_prep_openat.3
@@ -67,6 +67,18 @@ field, which is not a problem for liburing helpers, but users of the raw io_uring interface need to zero SQEs to avoid unexpected behavior. +If +.B IORING_FILE_INDEX_ALLOC +is used as the +.I file_index +for a direct open, then io_uring will allocate a free direct descriptor in +the existing table. The allocated descriptor is returned in the CQE +.I res +field just like it would be for a non-direct open request. If no more entries +are available in the direct descriptor table, +.B -ENFILE +is returned instead. + This function prepares an async .BR openat (2) request. See that man page for details.
diff --git a/man/io_uring_prep_openat2.3 b/man/io_uring_prep_openat2.3 index 4898e30..96682d8 100644 --- a/man/io_uring_prep_openat2.3 +++ b/man/io_uring_prep_openat2.3
@@ -67,6 +67,17 @@ .I file_index field, which is not a problem for liburing helpers, but users of the raw io_uring interface need to zero SQEs to avoid unexpected behavior. +If +.B IORING_FILE_INDEX_ALLOC +is used as the +.I file_index +for a direct open, then io_uring will allocate a free direct descriptor in +the existing table. The allocated descriptor is returned in the CQE +.I res +field just like it would be for a non-direct open request. If no more entries +are available in the direct descriptor table, +.B -ENFILE +is returned instead. This function prepares an async .BR openat2 (2)