From: "Jose R. Santos" Subject: [PATCH 11/14] Update uninit block group documetation for some of the utilities. Date: Sun, 21 Oct 2007 21:04:08 -0500 Message-ID: <20071022020408.23849.3551.stgit@toolssf2> References: <20071022020308.23849.98773.stgit@toolssf2> Content-Type: text/plain; charset=utf-8; format=fixed Content-Transfer-Encoding: 8bit To: linux-ext4@vger.kernel.org Return-path: Received: from e35.co.us.ibm.com ([32.97.110.153]:45150 "EHLO e35.co.us.ibm.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751420AbXJVCHe (ORCPT ); Sun, 21 Oct 2007 22:07:34 -0400 Received: from d03relay04.boulder.ibm.com (d03relay04.boulder.ibm.com [9.17.195.106]) by e35.co.us.ibm.com (8.13.8/8.13.8) with ESMTP id l9M27Xs4022904 for ; Sun, 21 Oct 2007 22:07:33 -0400 Received: from d03av01.boulder.ibm.com (d03av01.boulder.ibm.com [9.17.195.167]) by d03relay04.boulder.ibm.com (8.13.8/8.13.8/NCO v8.5) with ESMTP id l9M27XKH081926 for ; Sun, 21 Oct 2007 20:07:33 -0600 Received: from d03av01.boulder.ibm.com (loopback [127.0.0.1]) by d03av01.boulder.ibm.com (8.12.11.20060308/8.13.3) with ESMTP id l9M27XP7009026 for ; Sun, 21 Oct 2007 20:07:33 -0600 Received: from [127.0.0.1] (toolssf2.ltc.austin.ibm.com [9.3.190.66]) by d03av01.boulder.ibm.com (8.12.11.20060308/8.12.11) with ESMTP id l9M27X8n009023 for ; Sun, 21 Oct 2007 20:07:33 -0600 In-Reply-To: <20071022020308.23849.98773.stgit@toolssf2> Sender: linux-ext4-owner@vger.kernel.org List-Id: linux-ext4.vger.kernel.org Update uninit block group documetation for some of the utilities. Upadates documentation man pages for mke2fs(8) and tune2fs(8) Signed-off-by: Jose R. Santos Signed-Off-By: Andreas Dilger -- misc/mke2fs.8.in | 9 ++++++++- misc/tune2fs.8.in | 12 ++++++++++-- 2 files changed, 18 insertions(+), 3 deletions(-) diff --git a/misc/mke2fs.8.in b/misc/mke2fs.8.in index a3dc4a1..171df5b 100644 --- a/misc/mke2fs.8.in +++ b/misc/mke2fs.8.in @@ -210,7 +210,7 @@ for the filesystem. (For administrators who are creating filesystems on RAID arrays, it is preferable to use the .I stride RAID parameter as part of the -.B \-R +.B \-E option rather than manipulating the number of blocks per group.) This option is generally used by developers who are developing test cases. @@ -406,6 +406,13 @@ Store file type information in directory entries. .TP .B has_journal Create an ext3 journal (as if using the +.TP +.B uninit_groups +Create a filesystem without initializing all of the groups. This speeds +up filesystem creation time noticably, and can also reduce +.BR e2fsck time +dramatically. This feature causes the filesystem to be read-only in +older kernels is not supported in most Linux kernels, use with caution. .B \-j option). @JDEV@.TP diff --git a/misc/tune2fs.8.in b/misc/tune2fs.8.in index 2e617db..5ab1bd0 100644 --- a/misc/tune2fs.8.in +++ b/misc/tune2fs.8.in @@ -392,10 +392,16 @@ option. .TP .B sparse_super Limit the number of backup superblocks to save space on large filesystems. +.TP +.B uninit_groups +Allow the kernel to initialize bitmaps and inode tables and keep a high +watermark for the unused inodes in a filesystem, to reduce +.BR e2fsck (8) +time. .RE .IP After setting or clearing -.B sparse_super +.BR sparse_super , " uninit_groups" , and .B filetype filesystem features, @@ -414,7 +420,9 @@ can be run to convert existing directories to the hashed B-tree format. Linux kernels before 2.0.39 and many 2.1 series kernels do not support the filesystems that use any of these features. Enabling certain filesystem features may prevent the filesystem from -being mounted by kernels which do not support those features. +being mounted by kernels which do not support those features. The +.B uninit_groups +feature is not yet supported by any released kernel. .TP .BI \-r " reserved-blocks-count" Set the number of reserved filesystem blocks.