diff options
authorJeff Moyer <>2019-01-25 17:38:51 -0500
committerJens Axboe <>2019-01-26 06:40:48 -0700
commit9688b4a00f14d1c519d52ad94763ce9af8e72614 (patch)
parent2a8e5b105c6ec560bf65cae2d94ba3acce7a7915 (diff)
man: fixup description of fixed files I/O
The man page suggests that IOSQE_FIXED_FILE must be specified for all sqes when the io_uring instance has files registered. This is not the case, so clear that up. Also fix a typo (few->new) while we're in there. Signed-off-by: Jeff Moyer <> Signed-off-by: Jens Axboe <>
2 files changed, 12 insertions, 13 deletions
diff --git a/man/io_uring_enter.2 b/man/io_uring_enter.2
index dc81fc4..7a3498d 100644
--- a/man/io_uring_enter.2
+++ b/man/io_uring_enter.2
@@ -146,13 +146,13 @@ The
.I flags
field is a bit mask. Currently, the only supported flag is
-This flag must be specified for io_uring instances that registered
-files using the
-.BR io_uring_register(2)
-system call. When specified,
+When this flag is specified,
.I fd
-contains an index into the files array registered with the io_uring
+is an index into the files array registered with the io_uring instance (see the
+section of the
+.BR io_uring_register(2)
+man page).
.I ioprio
specifies the I/O priority. See
diff --git a/man/io_uring_register.2 b/man/io_uring_register.2
index 3ae3098..1f8d5d3 100644
--- a/man/io_uring_register.2
+++ b/man/io_uring_register.2
@@ -103,20 +103,19 @@ contains a pointer to an array of
.I nr_args
file descriptors (signed 32 bit integers).
-When used, the application must set
+To make use of the registered files, the
-in the
+flag must be set in the
.I flags
member of the
-.I struct io_uring_sqe.
+.I struct io_uring_sqe,
+and the
.I fd
-is set to the index of the buffer in the array supplied to
+member is set to the index of the file in the file descriptor array.
Files are automatically unregistered when the io_uring instance is
torn down. An application need only unregister if it wishes to
-register a few set of fds.
+register a new set of fds.
This operation requires no argument, and