Blob Blame History Raw
commit 794b62f68063d3af74ab7e79a9d7049887ec3ece
Author: Eric Sandeen <sandeen@redhat.com>
Date:   Tue Sep 16 09:23:45 2014 +1000

    xfsprogs: add supported file attributes to xfs.5 manpage
    
    The chattr(1) manpage suffers from the same problems mount(1) had:
    many options listed, not kept up to date for various filesystems.
    
    I've submitted a manpage update for chattr(1) which says to refer to
    filesystem-specific manpages for supported attributes; this patch
    updates xfs(5) to list the attributes supported by xfs.
    
    Signed-off-by: Eric Sandeen <sandeen@redhat.com>
    Reviewed-by: Dave Chinner <dchinner@redhat.com>
    Signed-off-by: Dave Chinner <david@fromorbit.com>

diff --git a/man/man5/xfs.5 b/man/man5/xfs.5
index 5e47c4c..3214455 100644
--- a/man/man5/xfs.5
+++ b/man/man5/xfs.5
@@ -1,6 +1,6 @@
 .TH xfs 5
 .SH NAME
-xfs \- layout and mount options for the XFS filesystem
+xfs \- layout, mount options, and supported file attributes for the XFS filesystem
 .SH DESCRIPTION
 An XFS filesystem can reside on a regular disk partition or on a
 logical volume.
@@ -302,7 +302,27 @@ namespace is on stable storage. This is useful in HA setups
 where failover must not result in clients seeing
 inconsistent namespace presentation during or after a
 failover event.
+.SH FILE ATTRIBUTES
+The XFS filesystem supports 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 i " - immutable"
+.sp
+.BR S " - synchronous updates"
+.sp
+For descriptions of these attribute flags, please refer to the
+.BR chattr (1)
+man page.
 .SH SEE ALSO
+.BR chattr (1),
 .BR xfsctl (3),
 .BR mount (8),
 .BR mkfs.xfs (8),