From patchwork Tue Jul 26 12:14:57 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dylan Yudaken X-Patchwork-Id: 12929222 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2767BC43334 for ; Tue, 26 Jul 2022 12:15:17 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233025AbiGZMPQ (ORCPT ); Tue, 26 Jul 2022 08:15:16 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55176 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233224AbiGZMPP (ORCPT ); Tue, 26 Jul 2022 08:15:15 -0400 Received: from mx0a-00082601.pphosted.com (mx0a-00082601.pphosted.com [67.231.145.42]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 412ED9FDF for ; Tue, 26 Jul 2022 05:15:13 -0700 (PDT) Received: from pps.filterd (m0044012.ppops.net [127.0.0.1]) by mx0a-00082601.pphosted.com (8.17.1.5/8.17.1.5) with ESMTP id 26Q0ofp5003549 for ; Tue, 26 Jul 2022 05:15:13 -0700 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fb.com; h=from : to : cc : subject : date : message-id : mime-version : content-transfer-encoding : content-type; s=facebook; bh=riPgs84PBkpD5dxmmDAJnH34tM6Yb+KAJr7BMBdlDaU=; b=cQKc3LebGMq8hKtzh4MCzhRCZgCsObgAppxKXZeylA0NgHUwOK4YTma1wWYKwbweDvZy auG4aktzJsX+bJjTGNz0dBkD8EZjKmy8Xt2UtaRMT5L9tftvODcfSeb742GW0OOwP3jk d/5SJyUWeNmk163pX2i9OHt4kcyHegl9T9U= Received: from mail.thefacebook.com ([163.114.132.120]) by mx0a-00082601.pphosted.com (PPS) with ESMTPS id 3hj1usm8wx-2 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=NOT) for ; Tue, 26 Jul 2022 05:15:13 -0700 Received: from twshared39111.03.ash8.facebook.com (2620:10d:c085:208::f) by mail.thefacebook.com (2620:10d:c085:11d::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.28; Tue, 26 Jul 2022 05:15:11 -0700 Received: by devbig038.lla2.facebook.com (Postfix, from userid 572232) id 0234E397A78A; Tue, 26 Jul 2022 05:15:08 -0700 (PDT) From: Dylan Yudaken To: , CC: , , Dylan Yudaken Subject: [PATCH liburing 0/5] multishot recvmsg docs and example Date: Tue, 26 Jul 2022 05:14:57 -0700 Message-ID: <20220726121502.1958288-1-dylany@fb.com> X-Mailer: git-send-email 2.30.2 MIME-Version: 1.0 X-FB-Internal: Safe X-Proofpoint-GUID: 5ntc71WlmXNVq9z4NrByQxHwEvGkwWt4 X-Proofpoint-ORIG-GUID: 5ntc71WlmXNVq9z4NrByQxHwEvGkwWt4 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.205,Aquarius:18.0.883,Hydra:6.0.517,FMLib:17.11.122.1 definitions=2022-07-26_04,2022-07-26_01,2022-06-22_01 Precedence: bulk List-ID: X-Mailing-List: io-uring@vger.kernel.org Some multishot recvmsg patches for liburing: Patches 1-3 cleanup the API a little while we're doing this. Patch 4 adds docs for the new API Patch 5 adds an example UDP echo server that uses the API Dylan Yudaken (5): more consistent multishot recvmsg API parameter names order like functions together in liburing.h change io_uring_recvmsg_payload_length return type add documentation for multishot recvmsg add an example for a UDP server .gitignore | 1 + examples/Makefile | 1 + examples/io_uring-udp.c | 388 ++++++++++++++++++++++++++ man/io_uring_prep_recvmsg.3 | 30 ++ man/io_uring_prep_recvmsg_multishot.3 | 1 + man/io_uring_recvmsg_cmsg_firsthdr.3 | 1 + man/io_uring_recvmsg_cmsg_nexthdr.3 | 1 + man/io_uring_recvmsg_name.3 | 1 + man/io_uring_recvmsg_out.3 | 78 ++++++ man/io_uring_recvmsg_payload.3 | 1 + man/io_uring_recvmsg_payload_length.3 | 1 + man/io_uring_recvmsg_validate.3 | 1 + src/include/liburing.h | 48 ++-- 13 files changed, 529 insertions(+), 24 deletions(-) create mode 100644 examples/io_uring-udp.c create mode 120000 man/io_uring_prep_recvmsg_multishot.3 create mode 120000 man/io_uring_recvmsg_cmsg_firsthdr.3 create mode 120000 man/io_uring_recvmsg_cmsg_nexthdr.3 create mode 120000 man/io_uring_recvmsg_name.3 create mode 100644 man/io_uring_recvmsg_out.3 create mode 120000 man/io_uring_recvmsg_payload.3 create mode 120000 man/io_uring_recvmsg_payload_length.3 create mode 120000 man/io_uring_recvmsg_validate.3 base-commit: 30a20795d7e4f300c606c6a2aa0a4c9492882d1d