From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server-vie001.gnuweeb.org X-Spam-Level: X-Spam-Status: No, score=-1.2 required=5.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,URIBL_DBL_BLOCKED_OPENDNS, URIBL_ZEN_BLOCKED_OPENDNS autolearn=ham autolearn_force=no version=3.4.6 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gnuweeb.org; s=new2025; t=1753577018; bh=etqAV++elJSj94Vs+g/cqagRXHDxS/kbllsDICy83Hc=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version:Content-Transfer-Encoding:Message-ID:Date:From: Reply-To:Subject:To:Cc:In-Reply-To:References:Resent-Date: Resent-From:Resent-To:Resent-Cc:User-Agent:Content-Type: Content-Transfer-Encoding; b=gIOHzopyfyxtSg0AwruuN7l2A9LuGWN/83QP90p3knEtbN4/164+c6bHKVx+8gv8M ELrAtjXmitWWCU5h0jH2WnrYdXTKx8Z/NOQUzSY05S3SHd5QOBA8GykHebkh3OeEav JZmKX9l3FAA/g/TLWcIyZR0ZFgGBjpn51DEbL0u01oOkahuzYs52TfeYkBcpPjnQ+H /8LuN1qqc3QGVaEqgp41VseYIaUXoaPAB43Pyd20PXrxausftbZdl/lDMPkgGN+XKe ZM/Qp2m32UvrZoipT3dVqhfFJndNXAgcV9xG9vIzStEyJTx2J7N5wzuBA1uh2v/uPn eTdf9HijC4xsA== Received: from integral2.. (unknown [182.253.126.144]) by server-vie001.gnuweeb.org (Postfix) with ESMTPSA id 74F3E3126E06; Sun, 27 Jul 2025 00:43:36 +0000 (UTC) From: Ammar Faizi To: Jens Axboe Cc: Ammar Faizi , Alviro Iskandar Setiawan , GNU/Weeb Mailing List , Christian Mazakas , io-uring Mailing List , Linux Kernel Mailing List Subject: [PATCH liburing 2/3] man: Add `IORING_ENTER_NO_IOWAIT` flag Date: Sun, 27 Jul 2025 07:43:15 +0700 Message-Id: <20250727004316.3351033-3-ammarfaizi2@gnuweeb.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20250727004316.3351033-1-ammarfaizi2@gnuweeb.org> References: <20250727004316.3351033-1-ammarfaizi2@gnuweeb.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit List-Id: Based on an explanation from the Linux kernel upstream commit: 07754bfd9aee ("io_uring: enable toggle of iowait usage when waiting on CQEs") Signed-off-by: Ammar Faizi --- man/io_uring_enter.2 | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/man/io_uring_enter.2 b/man/io_uring_enter.2 index 99c0ab222675..a054a7cdfbd4 100644 --- a/man/io_uring_enter.2 +++ b/man/io_uring_enter.2 @@ -134,7 +134,21 @@ but merely an offset into an area of wait regions previously registered with .BR io_uring_register (2) using the .B IORING_REGISTER_MEM_REGION -operation. Available since 6.13 +operation. + +Available since 6.13 + +.TP +.B IORING_ENTER_NO_IOWAIT +When this flag is set, the system call will not mark the waiting task as being +in iowait if it is sleeping waiting on events and there are pending requests. +This is useful if iowait isn't expected when waiting for events. It can also +prevent extra power usage by allowing the CPU to enter lower sleep states. +This flag is only available if the kernel supports the +.B IORING_FEAT_NO_IOWAIT +feature. + +Available since 6.15. .PP .PP -- Ammar Faizi