From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from relay.sgi.com (relay2.corp.sgi.com [137.38.102.29]) by oss.sgi.com (Postfix) with ESMTP id BFF307F3F for ; Thu, 19 Jun 2014 00:34:14 -0500 (CDT) Received: from cuda.sgi.com (cuda2.sgi.com [192.48.176.25]) by relay2.corp.sgi.com (Postfix) with ESMTP id BA4E9304039 for ; Wed, 18 Jun 2014 22:34:14 -0700 (PDT) Received: from ipmail07.adl2.internode.on.net (ipmail07.adl2.internode.on.net [150.101.137.131]) by cuda.sgi.com with ESMTP id 5EP8b0WzotWEtuNU for ; Wed, 18 Jun 2014 22:34:13 -0700 (PDT) Received: from disappointment.disaster.area ([192.168.1.110] helo=disappointment) by dastard with esmtp (Exim 4.80) (envelope-from ) id 1WxUyz-0001gj-5e for xfs@oss.sgi.com; Thu, 19 Jun 2014 15:33:57 +1000 Received: from dave by disappointment with local (Exim 4.82_1-5b7a7c0-XX) (envelope-from ) id 1WxUyz-0004xI-4b for xfs@oss.sgi.com; Thu, 19 Jun 2014 15:33:57 +1000 From: Dave Chinner Subject: [PATCH 2/2] mkfs: add "-m" options to the man page Date: Thu, 19 Jun 2014 15:33:52 +1000 Message-Id: <1403156032-18525-3-git-send-email-david@fromorbit.com> In-Reply-To: <1403156032-18525-1-git-send-email-david@fromorbit.com> References: <1403156032-18525-1-git-send-email-david@fromorbit.com> List-Id: XFS Filesystem from SGI List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: xfs-bounces@oss.sgi.com Sender: xfs-bounces@oss.sgi.com To: xfs@oss.sgi.com From: Dave Chinner Because they are missing. Reported-by: Matthias Schniedermeyer Signed-off-by: Dave Chinner --- man/man8/mkfs.xfs.8 | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/man/man8/mkfs.xfs.8 b/man/man8/mkfs.xfs.8 index 8184e10..4ba07bf 100644 --- a/man/man8/mkfs.xfs.8 +++ b/man/man8/mkfs.xfs.8 @@ -7,6 +7,9 @@ mkfs.xfs \- construct an XFS filesystem .B \-b .I block_size ] [ +.B \-m +.I global_metadata_options +] [ .B \-d .I data_section_options ] [ @@ -125,6 +128,50 @@ The default value is 4096 bytes (4 KiB), the minimum is 512, and the maximum is 65536 (64 KiB). XFS on Linux currently only supports pagesize or smaller blocks. .TP +.BI \-m " global_metadata_options" +These options specify metadata format options that either apply to the entire +filesystem or aren't easily characterised by a specific functionality group. The +valid +.I global_metadata_options +are: +.RS 1.2i +.TP +.BI crc= value +This is used to create a filesystem which maintains and checks CRC information +in all metadata objects on disk. The value is either 0 to disable the feature, +or 1 to enable the use of CRCs. +.IP +CRCs enable enhanced error detection due to +hardware issues, whilst the format changes also improves crash recovery +algorithms and the ability of various tools to validate and repair metadata +corruptions when they are found. +The CRC algorithm used is CRC32c, so the overhead is dependent on CPU +architecture as some CPUs have hardware acceleration of this algorithm. +Typically the overhead of calculating and checking the CRCs is not noticable in +normal operation. +.IP +By default, +.B mkfs.xfs +will not enable metadata CRCs. +.TP +.BI finobt= value +This option enables the use of a separate free inode btree index in each +allocation group. The value is either 0 to disable the feature, or 1 to create +a free inode btree in each allocation group. +.IP +The free inode btree mirrors the existing allocated inode btree index which +indexes both used and free inodes. The free inode btree does not index used +inodes, allowing faster, more consistent inode allocation performance as +filesystems age. +.IP +By default, +.B mkfs.xfs +will not create free inode btrees. This feature is also currently only available +for filesystems created with the +.B \-m crc=1 +option set. +.RE +.TP .BI \-d " data_section_options" These options specify the location, size, and other parameters of the data section of the filesystem. The valid -- 2.0.0 _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs