From mboxrd@z Thu Jan 1 00:00:00 1970 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 2A2A5C6FA83 for ; Thu, 8 Sep 2022 23:09:02 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229547AbiIHXJA (ORCPT ); Thu, 8 Sep 2022 19:09:00 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37140 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229449AbiIHXI4 (ORCPT ); Thu, 8 Sep 2022 19:08:56 -0400 Received: from ale.deltatee.com (ale.deltatee.com [204.191.154.188]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D57C18F95D for ; Thu, 8 Sep 2022 16:08:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=deltatee.com; s=20200525; h=Subject:MIME-Version:References:In-Reply-To: Message-Id:Date:Cc:To:From:content-disposition; bh=lguvncpYIn1T+Y6gxuDW7BR2TNW1QaHuuhfTnIOq8nc=; b=h+3tHj9ZSOK6gQZt85z8j+52Pr k2Ra/58+/G6bYTgNtz/T1uZvZcETa9L97jPj4EyTBU/fwsXPM4OzSxoM6SCx5OChCKCP4yqYXkJRZ AlMbjeGIoKUk02xeMOSZlfNgWjVqxQuuqQPFuJ3ogHvkjiRBXdX6wpx96WhJKwdFAgItYNi7k7sO5 91I/yRdj99F6kwT38ZqwSC4kYQCoFZiTwAS98tRMOsbctj5Gyfl0IbThR35qALjFmtaA44FolYM78 w9hu4raE0PlJKo+fzaFy+lXOQ9yM3+AiFLlcR9rvUN89BNmKxkiHcsad3yO4/UVgKkEECAeV0KoWG QqjpFDXQ==; Received: from cgy1-donard.priv.deltatee.com ([172.16.1.31]) by ale.deltatee.com with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1oWQde-001qIV-Rt; Thu, 08 Sep 2022 17:08:52 -0600 Received: from gunthorp by cgy1-donard.priv.deltatee.com with local (Exim 4.94.2) (envelope-from ) id 1oWQde-0001Vd-51; Thu, 08 Sep 2022 17:08:50 -0600 From: Logan Gunthorpe To: linux-raid@vger.kernel.org, Jes Sorensen Cc: Guoqing Jiang , Xiao Ni , Mariusz Tkaczyk , Coly Li , Chaitanya Kulkarni , Jonmichael Hands , Stephen Bates , Martin Oliveira , David Sloan , Logan Gunthorpe Date: Thu, 8 Sep 2022 17:08:47 -0600 Message-Id: <20220908230847.5749-3-logang@deltatee.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20220908230847.5749-1-logang@deltatee.com> References: <20220908230847.5749-1-logang@deltatee.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-SA-Exim-Connect-IP: 172.16.1.31 X-SA-Exim-Rcpt-To: linux-raid@vger.kernel.org, jes@trained-monkey.org, guoqing.jiang@linux.dev, xni@redhat.com, mariusz.tkaczyk@linux.intel.com, colyli@suse.de, chaitanyak@nvidia.com, jm@chia.net, sbates@raithlin.com, Martin.Oliveira@eideticom.com, David.Sloan@eideticom.com, logang@deltatee.com X-SA-Exim-Mail-From: gunthorp@deltatee.com Subject: [PATCH mdadm v2 2/2] manpage: Add --discard option to manpage X-SA-Exim-Version: 4.2.1 (built Sat, 13 Feb 2021 17:57:42 +0000) X-SA-Exim-Scanned: Yes (on ale.deltatee.com) Precedence: bulk List-ID: X-Mailing-List: linux-raid@vger.kernel.org Document the new --discard option in the manpage. Signed-off-by: Logan Gunthorpe --- mdadm.8.in | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/mdadm.8.in b/mdadm.8.in index f273622641da..93a0a32dd314 100644 --- a/mdadm.8.in +++ b/mdadm.8.in @@ -836,6 +836,21 @@ array is resynced at creation. From Linux version 3.0, .B \-\-assume\-clean can be used with that command to avoid the automatic resync. +.TP +.BR \-\-discard +When creating an array, send block discard (aka trim or deallocate) +requests to all the block devices. In most cases this should zero all +the disks. If any discard fails, or if zeros are not read back from the +disk, then the operation will be aborted. +.IP +If all discards succeed, and there are no missing disks specified, +then the array should not need to be synchronized after it is created +(as all disks are zero). The operation will thus proceed as if +.B \-\-assume\-clean +was specified. +.IP +This is only meaningful with --create. + .TP .BR \-\-backup\-file= This is needed when -- 2.30.2