docs/88512: mount_ext2fs man page has no details on large file and journaling support

[Ivan Voras]

>Number:         88512
>Category:       docs
>Synopsis:       mount_ext2fs 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:
>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 at 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:
>Unformatted: