From 422e32555df9e64c0a785eb49cbfecfcb8f1f229 Mon Sep 17 00:00:00 2001 From: ilikdoge Date: Sun, 16 Oct 2022 18:36:14 -0700 Subject: [PATCH] man/io_uring_enter.2: Add IORING_OP_SOCKET to the list of opcodes Signed-off-by: David Zeng --- man/io_uring_enter.2 | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/man/io_uring_enter.2 b/man/io_uring_enter.2 index 1d08ac8a..8077da0c 100644 --- a/man/io_uring_enter.2 +++ b/man/io_uring_enter.2 @@ -1059,6 +1059,40 @@ value being passed in. This request type can be used to either just wake or interrupt anyone waiting for completions on the target ring, or it can be used to pass messages via the two fields. Available since 5.18. +.TP +.B IORING_OP_SOCKET +Issue the equivalent of a +.BR socket(2) +system call. +.I fd +must contain the communication domain, +.I off +must contain the communication type, +.I len +must contain the protocol, and +.I rw_flags +is currently unused and must be set to zero. See also +.BR socket(2) +for the general description of the related system call. Available since 5.19. + +If the +.I file_index +field is set to a positive number, the file won't be installed into the +normal file table as usual but will be placed into the fixed file table at index +.I file_index - 1. +In this case, instead of returning a file descriptor, the result will contain +either 0 on success or an error. If the index points to a valid empty slot, the +installation is guaranteed to not fail. If there is already a file in the slot, +it will be replaced, similar to +.B IORING_OP_FILES_UPDATE. +Please note that only io_uring has access to such files and no other syscall +can use them. See +.B IOSQE_FIXED_FILE +and +.B IORING_REGISTER_FILES. + +Available since 5.19. + .TP .B IORING_OP_SEND_ZC Issue the zerocopy equivalent of a