NetBSD Problem Report #32100

From pcah8322@artax.karlin.mff.cuni.cz  Thu Nov 17 21:45:21 2005
Return-Path: <pcah8322@artax.karlin.mff.cuni.cz>
Received: from mail.casablanca.cz (mail.casablanca.cz [82.208.31.182])
	by narn.netbsd.org (Postfix) with ESMTP id B577663B90F
	for <gnats-bugs@gnats.NetBSD.org>; Thu, 17 Nov 2005 21:45:20 +0000 (UTC)
Message-Id: <200511172145.jAHLjAO5000498@beta.martani.n2.repy.czf>
Date: Thu, 17 Nov 2005 22:45:10 +0100 (CET)
From: Pavel Cahyna <pcah8322@artax.karlin.mff.cuni.cz>
Reply-To: pavel.cahyna@st.mff.cuni.cz
To: gnats-bugs@netbsd.org
Subject: confusing documentation about different versions of FFS
X-Send-Pr-Version: 3.95

>Number:         32100
>Category:       bin
>Synopsis:       confusing documentation about different versions of FFS
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    bin-bug-people
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Nov 17 21:46:00 +0000 2005
>Closed-Date:    Sat May 14 20:14:58 +0000 2011
>Last-Modified:  Sat May 14 20:14:58 +0000 2011
>Originator:     Pavel Cahyna
>Release:        NetBSD 3.0_BETA
>Organization:
>Environment:
System: NetBSD beta 3.0_BETA NetBSD 3.0_BETA (BETA) #4: Fri Oct 7 21:20:07 CEST 2005 root@beta:/usr/src/sys/arch/alpha/compile/BETA alpha
Architecture: alpha
Machine: alpha
>Description:
The fsck_ffs man page documents five levels of FFS filesystems in the
description of the -c option. The newfs man page documents a -O option
to choose filesystem format, which has three possibilities. One is
UFS2, the mapping between the remaining two and the five levels in
fsck_ffs is unclear. Also, it would be nice to say in which release
the respective formats appeared.
>How-To-Repeat:

>Fix:
dumpfs for a filesystem image created with newfs -O0 shows that the fs
level is 1, which is consistent with code inspection. So please:
- add this text after "The file system is in the new (dynamic table)
format." in fsck_ffs(8):

Such file systems are made by the -O 0 option to the newfs(8) command.

- add this text after "The file system supports 32-bit UIDs and GIDs,
...":

This format was introduced in 4.4BSD.

- add this text after "If maxcontig is greater than one, build the
free segment maps ...": 

This was the default before NetBSD 2.0 .

- add this text after "Rearrange the super block to the same layout as
UFS2;..." :

Such file systems are made by the -O 1 option to the newfs(8) command
in NetBSD 2.0 and newer versions and are compatible with NetBSD
1.6.<please fill in>. 

The UFS2 file system is level 5, but conversion to UFS2 from previous
versions is not possible.

- change the description of -O in newfs(8) to:

                 Select the filesystem-format (also called level)
                       0    4.3BSD (level 1); This option is primarily used to build
                            root file systems that can be understood by older
                            boot ROMs.
                       1    FFS (level 4); normal fast-filesystem (default).
                       2    UFS2 (level 5); enhanced fast-filesystem (suited for more
                            than 1 Terabyte capacity).
                 To convert between formats (levels) use the
                 fsck_ffs(8) utility. 
                 To create an LFS filesystem see newfs_lfs(8).

(this change also removes the claim about access control lists, which
NetBSD does not support.)

>Release-Note:

>Audit-Trail:

State-Changed-From-To: open->feedback
State-Changed-By: hubertf@netbsd.org
State-Changed-When: Mon, 27 Nov 2006 02:02:58 +0000
State-Changed-Why:
Can you please provide a unified diff for the text (or handle the change
yourself :-)?


 - Hubert


From: "David A. Holland" <dholland@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/32100 CVS commit: src/sbin
Date: Sat, 14 May 2011 19:46:10 +0000

 Module Name:	src
 Committed By:	dholland
 Date:		Sat May 14 19:46:10 UTC 2011

 Modified Files:
 	src/sbin/fsck_ffs: fsck_ffs.8
 	src/sbin/newfs: newfs.8

 Log Message:
 Improve documentation of FFS formats and format levels from PR 32100.
 Prompted also by recent discussion on tech-kern. Bump date.


 To generate a diff of this commit:
 cvs rdiff -u -r1.47 -r1.48 src/sbin/fsck_ffs/fsck_ffs.8
 cvs rdiff -u -r1.81 -r1.82 src/sbin/newfs/newfs.8

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: feedback->closed
State-Changed-By: dholland@NetBSD.org
State-Changed-When: Sat, 14 May 2011 20:14:58 +0000
State-Changed-Why:
fixed.


>Unformatted:

Home	PR Database Search