From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 2BDD83C10A3 for ; Mon, 17 Aug 2026 08:28:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786955334; cv=none; b=GIAerR3CDkeT5Bfa2IpS9mHZGB/gSouimwN7MwThKuGZptK/s3IQER+fPe2TJe+OAUoRAWEpkGoRdsWFVOcDTVAOyBDiEJ1+JMAtMSHyMN7J+owYiLS9niOmUEJpSO954fRBElWwLLuujXTcLnFnIKAt2Y7UqwWUuRiJWAsKjFo= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786955334; c=relaxed/simple; bh=cp3nZ0dviJMUm7oPxAT7N8tm9/evvCgXVFxyOFnW868=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=aMZQsQGk9pC1CHApgIjs7zBZpqzEPhjD0dnxOdRwvrKy494CuT19EGpOLa3ZLsODUfyN9u8Ny7OAcy4fSKU5VVxT7iH9zh8khwVY3bmVUtxkLZptVLQXmO5SSwDMI7Gy0JGa1OAF1r82gGndEdCgHM3R14Fzfdg/xw7EwI+H7Uo= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=fail (p=none dis=none) header.from=lst.de; spf=none smtp.mailfrom=bombadil.srs.infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=0jzjIbew; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=fail (p=none dis=none) header.from=lst.de Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=bombadil.srs.infradead.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="0jzjIbew" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=slOin60mLr5SiRc3+4WGV4MCQwrUzfjh/msuv6cGL/Y=; b=0jzjIbewGvHIMa2o9xemcDjcVo GMmwE4xADO6PDHPHsfFWSUmfbgskbq8daI0AATL+Tum/TcmHYPM4fD6IADLcBQBO4nXYeOP9X5RQi cJwr3C4KVM3jGSGExZh7zKdkkAAoeiYyiZ7zVCjauAC4haNdM4BQF0tjvP2hylVyg4tyZNKdxsNni 0VIx0AiQJyLwGH8dPiYvkw0/7obJNBOZB9vkjTTXauuF9vxH0UWsHnoJ6R+/PUSn8Ks/CqfhvJyop Nu4UOO5N+7wRt39lvOjgMFaGbLBvpME/KoEsIFIuuqy+0PgMafulV811uLge4L5TpsjfKYxIy7dlI 7oMUMP5Q==; Received: from 2a02-8389-2301-9f00-d9b3-9099-237f-e1a3.cable.dynamic.v6.surfer.at ([2a02:8389:2301:9f00:d9b3:9099:237f:e1a3] helo=localhost) by bombadil.infradead.org with esmtpsa (Exim 4.99.1 #2 (Red Hat Linux)) id 1wvsiC-00000005h0u-1i0a; Mon, 17 Aug 2026 08:28:52 +0000 From: Christoph Hellwig To: Jens Axboe Cc: Damien Le Moal , io-uring@vger.kernel.org Subject: [PATCH 4/5] man: add io_uring_prep_cmd_zone_reset_all.3 man page Date: Mon, 17 Aug 2026 10:28:31 +0200 Message-ID: <20260817082837.762276-5-hch@lst.de> X-Mailer: git-send-email 2.53.0 In-Reply-To: <20260817082837.762276-1-hch@lst.de> References: <20260817082837.762276-1-hch@lst.de> Precedence: bulk X-Mailing-List: io-uring@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-SRS-Rewrite: SMTP reverse-path rewritten from by bombadil.infradead.org. See http://www.infradead.org/rpr.html Add documentation for the new zone reset all io_uring cmd. Signed-off-by: Christoph Hellwig Reviewed-by: Damien Le Moal --- man/io_uring_prep_cmd_zone_reset_all.3 | 54 ++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 man/io_uring_prep_cmd_zone_reset_all.3 diff --git a/man/io_uring_prep_cmd_zone_reset_all.3 b/man/io_uring_prep_cmd_zone_reset_all.3 new file mode 100644 index 000000000000..9512fa6bbe73 --- /dev/null +++ b/man/io_uring_prep_cmd_zone_reset_all.3 @@ -0,0 +1,54 @@ +.\" Copyright (C) 2026 Christoph Hellwig +.\" +.\" SPDX-License-Identifier: LGPL-2.0-or-later +.\" +.TH io_uring_prep_cmd_zone_reset_all 3 "Aug 11, 2026" "liburing-2.16" "liburing Manual" +.SH NAME +io_uring_prep_cmd_zone_reset_all \- prepare a zone_reset_all command +.SH SYNOPSIS +.nf +.B #include +.PP +.BI "void io_uring_prep_cmd_zone_reset_all(struct io_uring_sqe *" sqe ", int " fd ");" +.fi +.SH DESCRIPTION +The +.BR io_uring_prep_cmd_zone_reset_all (3) +function prepares a zone_reset_all command request. The submission queue entry +.I sqe +is setup to reset all sequential write required zones on the block device +pointed to by +.IR fd . + +This command does not synchronize against concurrent file operations, including +but not limited to reads, write, ioctls and other uring_cmds and only performs +a best effort invalidation of the page cache for the device. The user has +to make sure that no other in-flight requests are modifying or reading the +range(s). If that is the case, it might result in stale page cache and data +inconsistencies. + +Available since Linux 7.TBD. + +.SH RETURN VALUE +None +.SH ERRORS +The CQE +.I res +field will contain the result of the operation. On success, this field will be +set to +.B 0 . +On error, a negative error value is returned. Note that where synchronous +system calls will return +.B -1 +on failure and set +.I errno +to the actual error value, io_uring never uses +.IR errno . +Instead it returns the negated +.I errno +directly in the CQE +.I res +field. +.SH SEE ALSO +.BR io_uring_get_sqe (3), +.BR io_uring_submit (3), -- 2.53.0