[PATCH] e2fsprogs: add supported file attributes to ext4.5 manpage

[PATCH] e2fsprogs: add supported file attributes to ext4.5 manpage

[Eric Sandeen]

The chattr(1) manpage now refers users to filesystem-specific
manpages for details on supported attributes, so add those to
ext4.5.

I've left out oddities like being able to set the compressed
or no-tail-packing flags, or setting data journaling on ext2.

That behavior seems like a bug, not a feature.

Signed-off-by: Eric Sandeen <sandeen@redhat.com>
---

Sorry, thought I had sent this earlier, but I guess I didn't.

diff --git a/misc/ext4.5.in b/misc/ext4.5.in
index ca197cb..19302a7 100644
--- a/misc/ext4.5.in
+++ b/misc/ext4.5.in
@@ -611,6 +611,37 @@ seriously cramp the system's style.)
 .B i_version
 Enable 64-bit inode version support. This option is off by default.
 
+.SH FILE ATTRIBUTES
+The ext2, ext3, and ext4 filesystems support setting the following file
+attributes on Linux systems using the
+.BR chattr (1)
+utility:
+.sp
+.BR a " - append only"
+.sp
+.BR A " - no atime updates"
+.sp
+.BR d " - no dump"
+.sp
+.BR D " - synchronous directory updates"
+.sp
+.BR i " - immutable"
+.sp
+.BR S " - synchronous updates"
+.sp
+.BR u " - undeletable"
+.sp
+In addition, the ext3 and ext4 filesystems support the following flag:
+.sp
+.BR j " - data journaling"
+.sp
+Finally, the ext4 filesystem also supports the following flag:
+.sp
+.BR e " - extents format"
+.sp
+For descriptions of these attribute flags, please refer to the
+.BR chattr (1)
+man page.
 .SH SEE ALSO
 .BR mke2fs (8),
 .BR mke2fs.conf (5),
@@ -618,4 +649,5 @@ Enable 64-bit inode version support. This option is off by default.
 .BR dumpe2fs (8),
 .BR tune2fs (8),
 .BR debugfs (8),
-.BR mount (8)
+.BR mount (8),
+.BR chattr (1)

Re: [PATCH] e2fsprogs: add supported file attributes to ext4.5 manpage

[Theodore Ts'o]

On Wed, Aug 20, 2014 at 01:02:50PM -0500, Eric Sandeen wrote:
> The chattr(1) manpage now refers users to filesystem-specific
> manpages for details on supported attributes, so add those to
> ext4.5.
> 
> I've left out oddities like being able to set the compressed
> or no-tail-packing flags, or setting data journaling on ext2.
> 
> That behavior seems like a bug, not a feature.
> 
> Signed-off-by: Eric Sandeen <sandeen@redhat.com>

Thanks, applied to the maint branch.

					- Ted