docs/88512: [patch] mount_ext2fs(8) man page has no details on large file and journaling support

[Tom Rhodes]

The following reply was made to PR docs/88512; it has been noted by GNATS.

From: Tom Rhodes <trhodes at FreeBSD.org>
To: bug-followup at FreeBSD.org
Cc: ivoras at 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