Skip to contentSkip to conversation

io_uring sendto

RFC PATCH In review Ammar Faizi 2 participants 4 messages Apr 15, 2023 io_uring

lore
Share & tools
lore
#0 lore raw

cover io_uring sendto

Hi Jens,

There are two patches in this series. The first patch adds io_uring_prep_sendto() function. The second patch addd the manpage and CHANGELOG.

---

Ammar Faizi (2):
liburing: Add io_uring_prep_sendto()
man: Add io_uring_prep_sendto()

 CHANGELOG                  |  1 +
 man/io_uring_prep_send.3   | 31 +++++++++++++++++++++++++++++++
 man/io_uring_prep_sendto.3 |  1 +
 src/include/liburing.h     | 25 +++++++++++++++++--------
 src/liburing-ffi.map       |  1 +
 5 files changed, 51 insertions(+), 8 deletions(-)
 create mode 120000 man/io_uring_prep_sendto.3

base-commit: 4fed79510a189cc7997f6d04855ebf7fb66cc323

Signature · 1 line
Ammar Faizi
#1 lore raw

RFC PATCH 1/2 liburing: Add `io_uring_prep_sendto()`

A sendto(2) request can be done using:

io_uring_prep_send() + io_uring_prep_send_set_addr()

Create a wrapper function, io_uring_prep_sendto().

---
 src/include/liburing.h | 25 +++++++++++++++++--------
 src/liburing-ffi.map   |  1 +
 2 files changed, 18 insertions(+), 8 deletions(-)
src/include/liburing.h +17 -8
index fbc65b60788a4d44..70c177431faf9f75 100644
@@ -758,6 +758,23 @@ IOURINGINLINE void io_uring_prep_send(struct io_uring_sqe *sqe, int sockfd,
 	sqe->msg_flags = (__u32) flags;
 }
 
+IOURINGINLINE void io_uring_prep_send_set_addr(struct io_uring_sqe *sqe,
+						const struct sockaddr *dest_addr,
+						__u16 addr_len)
+{
+	sqe->addr2 = (unsigned long)(const void *)dest_addr;
+	sqe->addr_len = addr_len;
+}
+
+IOURINGINLINE void io_uring_prep_sendto(struct io_uring_sqe *sqe, int sockfd,
+					const void *buf, size_t len, int flags,
+					const struct sockaddr *addr,
+					socklen_t addrlen)
+{
+	io_uring_prep_send(sqe, sockfd, buf, len, flags);
+	io_uring_prep_send_set_addr(sqe, addr, addrlen);
+}
+
 IOURINGINLINE void io_uring_prep_send_zc(struct io_uring_sqe *sqe, int sockfd,
 					 const void *buf, size_t len, int flags,
 					 unsigned zc_flags)
@@ -786,14 +803,6 @@ IOURINGINLINE void io_uring_prep_sendmsg_zc(struct io_uring_sqe *sqe, int fd,
 	sqe->opcode = IORING_OP_SENDMSG_ZC;
 }
 
-IOURINGINLINE void io_uring_prep_send_set_addr(struct io_uring_sqe *sqe,
-						const struct sockaddr *dest_addr,
-						__u16 addr_len)
-{
-	sqe->addr2 = (unsigned long)(const void *)dest_addr;
-	sqe->addr_len = addr_len;
-}
-
 IOURINGINLINE void io_uring_prep_recv(struct io_uring_sqe *sqe, int sockfd,
 				      void *buf, size_t len, int flags)
 {
src/liburing-ffi.map +1 -0
index c971bf8c858f3005..0a5e12ca764a2a1e 100644
@@ -170,6 +170,7 @@ LIBURING_2.4 {
 		io_uring_prep_msg_ring_cqe_flags;
 		io_uring_prep_msg_ring_fd;
 		io_uring_prep_msg_ring_fd_alloc;
+		io_uring_prep_sendto;
 	local:
 		*;
 };
Signature · 1 line
Ammar Faizi
#2 lore raw

RFC PATCH 2/2 man: Add `io_uring_prep_sendto()`

In reply to Ammar Faizi
---
 CHANGELOG                  |  1 +
 man/io_uring_prep_send.3   | 31 +++++++++++++++++++++++++++++++
 man/io_uring_prep_sendto.3 |  1 +
 3 files changed, 33 insertions(+)
 create mode 120000 man/io_uring_prep_sendto.3
CHANGELOG +1 -0
index 85e02a280d4a7c45..71ca3919e114d858 100644
@@ -14,6 +14,7 @@ liburing-2.4 release
   io_uring_prep_openat2_direct(), io_uring_prep_msg_ring_fd(), and
   io_uring_prep_socket_direct() factor in being called with
   IORING_FILE_INDEX_ALLOC for allocating a direct descriptor.
+- Add io_uring_prep_sendto() function.
 
 liburing-2.3 release
 
man/io_uring_prep_send.3 +31 -0
index 3bdc96751ebfb230..b555ec3a8548c449 100644
@@ -14,6 +14,14 @@ io_uring_prep_send \- prepare a send request
 .BI "                        const void *" buf ","
 .BI "                        size_t " len ","
 .BI "                        int " flags ");"
+.PP
+.BI "void io_uring_prep_sendto(struct io_uring_sqe *" sqe ","
+.BI "                          int " sockfd ","
+.BI "                          const void *" buf ","
+.BI "                          size_t " len ","
+.BI "                          int " flags ","
+.BI "                          const struct sockaddr *" addr ","
+.BI "                          socklen_t " addrlen ");"
 .fi
 .SH DESCRIPTION
 .PP
@@ -43,6 +51,28 @@ This function prepares an async
 .BR send (2)
 request. See that man page for details.
 
+The
+.BR io_uring_prep_sendto (3)
+function prepares a sendto request. The submission queue entry
+.I sqe
+is setup to use the file descriptor
+.I sockfd
+to start sending the data from
+.I buf
+of size
+.I len
+bytes and with modifier flags
+.IR flags .
+The destination address is specified by
+.I addr
+and
+.I addrlen
+and must be a valid address for the socket type.
+
+This function prepares an async
+.BR sendto (2)
+request. See that man page for details.
+
 .SH RETURN VALUE
 None
 .SH ERRORS
@@ -64,3 +94,4 @@ field.
 .BR io_uring_get_sqe (3),
 .BR io_uring_submit (3),
 .BR send (2)
+.BR sendto (2)
man/io_uring_prep_sendto.3 new file +1 -0
new file mode 120000
index 0000000000000000..ba85e68453fe6dcb
@@ -0,0 +1 @@
+io_uring_prep_send.3
\ No newline at end of file
Signature · 1 line
Ammar Faizi
maintainer
#3 lore raw
In reply to Ammar Faizi
Quoted 5 lines · Ammar Faizi

Hi Jens,

There are two patches in this series. The first patch adds io_uring_prep_sendto() function. The second patch addd the manpage and CHANGELOG.

Looks fine to me.

Signature · 1 line
Jens Axboe