From: Eric Sandeen <sandeen@redhat.com>
Date: Thu, 26 Jun 2014 20:38:33 +0000 (-0500)
Subject: btrfs-progs: add supported attr flags to btrfs(5)
X-Git-Tag: upstream/4.16.1~2778
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=70e3a85e9e6384f8876a4c1af5910a682786adbb;p=platform%2Fupstream%2Fbtrfs-progs.git

btrfs-progs: add supported attr flags to btrfs(5)

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 btrfs(5) to list the attributes supported
by btrfs.

Signed-off-by: Eric Sandeen <sandeen@redhat.com>
[added some asciidoc markups, adjusted formatting]
Signed-off-by: David Sterba <dsterba@suse.cz>
---

diff --git a/Documentation/btrfs-mount.txt b/Documentation/btrfs-mount.txt
index 4433a78..53f88c9 100644
--- a/Documentation/btrfs-mount.txt
+++ b/Documentation/btrfs-mount.txt
@@ -3,7 +3,7 @@ btrfs-mount(5)
 
 NAME
 ----
-btrfs-mount - mount options for the btrfs filesystem
+btrfs-mount - mount options and supported file attributes for the btrfs filesystem
 
 DESCRIPTION
 -----------
@@ -179,8 +179,33 @@ MOUNT OPTIONS
 *user_subvol_rm_allowed*::
 	Allow subvolumes to be deleted by a non-root user. Use with caution.
 
+FILE ATTRIBUTES
+---------------
+The btrfs filesystem supports setting the following file
+attributes the `chattr`(1) utility
+
+*a* -- append only
+
+*A* -- no atime updates
+
+*c* -- compressed
+
+*C* -- no copy on write
+
+*d* -- no dump
+
+*D* -- synchronous directory updates
+
+*i* -- immutable
+
+*S* -- synchronous updates
+
+For descriptions of these attribute flags, please refer to the
+`chattr`(1) man page.
+
 SEE ALSO
 --------
+`chattr`(1),
 `mkfs.btrfs`(8),
 `mount`(8),
 `btrfs`(8)