From ivoras@agricola.home.net  Sat Nov  5 02:21:57 2005
Return-Path: <ivoras@agricola.home.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 9F74616A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  5 Nov 2005 02:21:57 +0000 (GMT)
	(envelope-from ivoras@agricola.home.net)
Received: from agricola.home.net (sdgate2.cvjetno.sczg.hr [193.198.8.211])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 0272B43D46
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  5 Nov 2005 02:21:56 +0000 (GMT)
	(envelope-from ivoras@agricola.home.net)
Received: from agricola.home.net (localhost.home.net [127.0.0.1])
	by agricola.home.net (8.13.4/8.13.4) with ESMTP id jA52LvO3079856
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 5 Nov 2005 03:21:57 +0100 (CET)
	(envelope-from ivoras@agricola.home.net)
Received: (from ivoras@localhost)
	by agricola.home.net (8.13.4/8.13.3/Submit) id jA52LvgN079855;
	Sat, 5 Nov 2005 03:21:57 +0100 (CET)
	(envelope-from ivoras)
Message-Id: <200511050221.jA52LvgN079855@agricola.home.net>
Date: Sat, 5 Nov 2005 03:21:57 +0100 (CET)
From: Ivan Voras <ivoras@fer.hr>
Reply-To: Ivan Voras <ivoras@fer.hr>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: mount_ext2fs man page has no details on large file and journaling support
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         88512
>Category:       docs
>Synopsis:       [patch] mount_ext2fs(8) man page has no details on large file and journaling support
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Nov 05 02:30:16 GMT 2005
>Closed-Date:    
>Last-Modified:  Sun Jan 27 22:30:04 UTC 2008
>Originator:     Ivan Voras
>Release:        FreeBSD 6.0-RC1 i386
>Organization:
>Environment:
System: FreeBSD agricola 6.0-RC1 FreeBSD 6.0-RC1 #9: Wed Oct 12 23:21:24 CEST 2005 ivoras@agricola:/usr/obj/usr/src/sys/AGRICOLA i386


	
>Description:
	
mount_ext2fs(8) is not informative and doesn't mention issues with
large file and journaling support.
>How-To-Repeat:
	
man mount_ext2fs
>Fix:

	

--- mount_ext2fs.8_old  Mon Oct 31 20:43:17 2005
+++ mount_ext2fs.8      Mon Oct 31 20:56:45 2005
@@ -60,6 +60,21 @@
 .Xr mount 8
 man page for possible options and their meanings.
 .El
+.Sh BUGS
+Unlike the original Linux implementation, the "large_file"
+flag is not set automatically when first file larger than
+2GB is created. Instead,
+.Xr debugfs 8
+utility from the e2fsprogs port must be used to manually 
+set the flag with `feature large_file` command. Other than
+this, large files are fully supported.
+
+Support for journaling (ext3) is missing, and filesystems that
+have it enabled are treated as plain ext2 filesystems. 
+This means that
+.Xr e2fsck 8
+will have to be used to repair the journal when the filesystem
+is to be used in Linux.
 .Sh SEE ALSO
 .Xr mount 2 ,
 .Xr unmount 2 ,

>Release-Note:
>Audit-Trail:

From: Tom Rhodes <trhodes@FreeBSD.org>
To: bug-followup@FreeBSD.org
Cc: ivoras@fer.hr
Subject: Re: docs/88512: [patch] mount_ext2fs(8) man page has no details on
 large file and journaling support
Date: Mon, 21 Jan 2008 15:22:14 -0500

 Hi Ivan,
 
 > --- mount_ext2fs.8_old  Mon Oct 31 20:43:17 2005
 > +++ mount_ext2fs.8      Mon Oct 31 20:56:45 2005
 > @@ -60,6 +60,21 @@
 >  .Xr mount 8
 >  man page for possible options and their meanings.
 >  .El
 > +.Sh BUGS
 > +Unlike the original Linux implementation, the "large_file"
 > +flag is not set automatically when first file larger than
 > +2GB is created. Instead,
 > +.Xr debugfs 8
 > +utility from the e2fsprogs port must be used to manually
 > +set the flag with `feature large_file` command. Other than
 > +this, large files are fully supported.
 > +
 > +Support for journaling (ext3) is missing, and filesystems that
 > +have it enabled are treated as plain ext2 filesystems.
 > +This means that
 > +.Xr e2fsck 8
 > +will have to be used to repair the journal when the filesystem
 > +is to be used in Linux.
 >  .Sh SEE ALSO
 >  .Xr mount 2 ,
 >  .Xr unmount 2 ,
 
 I'm not sure if this belongs in ext2fs(5) as an implementation
 note, or in mount_ext2fs(8) as a compatibility section, or perhaps
 just in the mount_ext2fs(8) manual page without it's own section.
 But this really doesn't sound like a bug to me.  How about:
 
 
 Files up to 2GB are supported, larger file support may be
 gained by using the
 .Nm debugfs
 utility found in the e2fsprogs port.
 See the
 .Op feature
 option.
 .Pp
 Journaling support is not available and ext3 file systems will
 be treated as normal ext2 file systems.
 When journal recovery is needed, the
 .Nm e2fsck
 utility may be used.
 
 Sound good?  Thanks,
 
 -- 
 Tom Rhodes

From: "Dylan Cochran" <a134qaed@gmail.com>
To: bug-followup@FreeBSD.org
Cc: "Tom Rhodes" <trhodes@FreeBSD.org>, ivoras@fer.hr
Subject: Re: docs/88512: [patch] mount_ext2fs(8) man page has no details on
Date: Sun, 27 Jan 2008 16:52:09 -0500

 It's not a bug that FreeBSD only has a ext2fs driver, so it should be
 a sort of note for ext2fs(5), it supports ext2 filesystems only,
 however, if e2fsck is ran on an ext3 filesystem, it becomes nearly
 identical to an ext2 filesystem, and can be mounted. When the journal
 feature is in use, it must always be e2fsck'd before mounting, due to
 normal filesystem consistancy issues. There are corner cases where it
 can be dangerous to not follow that exact procedure, due to a wide
 range of ext2 filesystem driver implementations available for
 different kernels.
 
 It's become so common of an issue that I have an automatic 'run
 e2fsck' response whenever 'ext3' and 'freebsd' are mentioned in the
 same sentence.
>Unformatted:
