From patchwork Tue Oct 27 17:50:43 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Eric Sandeen X-Patchwork-Id: 11861233 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 87EBF6A2 for ; Tue, 27 Oct 2020 17:50:47 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 73CFF24197 for ; Tue, 27 Oct 2020 17:50:47 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1817974AbgJ0Rup (ORCPT ); Tue, 27 Oct 2020 13:50:45 -0400 Received: from sandeen.net ([63.231.237.45]:50452 "EHLO sandeen.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1822605AbgJ0Ruo (ORCPT ); Tue, 27 Oct 2020 13:50:44 -0400 Received: from liberator.sandeen.net (liberator.sandeen.net [10.0.0.146]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by sandeen.net (Postfix) with ESMTPSA id 1A08D33502D; Tue, 27 Oct 2020 12:50:32 -0500 (CDT) From: Eric Sandeen To: "Darrick J. Wong" Cc: linux-xfs@vger.kernel.org References: <160375511371.879169.3659553317719857738.stgit@magnolia> <160375511989.879169.8816363379781873320.stgit@magnolia> Subject: [PATCH 1.5/5 V2] mkfs: clarify valid "inherit" option values Message-ID: <04d65a53-00f9-527d-2b4c-c66b1799d2d4@sandeen.net> Date: Tue, 27 Oct 2020 12:50:43 -0500 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0) Gecko/20100101 Thunderbird/78.4.0 MIME-Version: 1.0 In-Reply-To: Content-Language: en-US Precedence: bulk List-ID: X-Mailing-List: linux-xfs@vger.kernel.org Clarify which values are valid for the various *inherit= mkfs options. Signed-off-by: Eric Sandeen Reviewed-by: Darrick J. Wong --- V2: Keep the same "=value" as elsewhere in the manpage but still clarify what those values should be and what they do. diff --git a/man/man8/mkfs.xfs.8 b/man/man8/mkfs.xfs.8 index 0a785874..10ceea30 100644 --- a/man/man8/mkfs.xfs.8 +++ b/man/man8/mkfs.xfs.8 @@ -378,31 +378,38 @@ without stripe geometry alignment even if the underlying storage device provides this information. .TP .BI rtinherit= value -If set, all inodes created by +If +.I value +is set to 1, all inodes created by .B mkfs.xfs -will be created with the realtime flag set. +will be created with the realtime flag set. Default is 0. Directories will pass on this flag to newly created regular files and directories. .TP .BI projinherit= value All inodes created by .B mkfs.xfs -will be assigned this project quota id. +will be assigned the project quota id provided in +.I value. Directories will pass on the project id to newly created regular files and directories. .TP .BI extszinherit= value All inodes created by .B mkfs.xfs -will have this extent size hint applied. +will have this +.I value +extent size hint applied. The value must be provided in units of filesystem blocks. Directories will pass on this hint to newly created regular files and directories. .TP .BI daxinherit= value -If set, all inodes created by +If +.I value +is set to 1, all inodes created by .B mkfs.xfs -will be created with the DAX flag set. +will be created with the DAX flag set. Default is 0. Directories will pass on this flag to newly created regular files and directories. By default,