man: document XFS_XFLAG_APPEND behavior for directories

For directories, the APPEND flag means that files cannot be unlinked
from the directory.  Files can be linked in or created, just not
unlinked.  Document this behavior, since it's been in the VFS for years
though not explicitly mentioned.  This patch is in preparation for
trying to hoist the fsgetxattr ioctl documentation to the man-pages
project.

Signed-off-by: Darrick J. Wong <djwong@kernel.org>
Reviewed-by: Eric Sandeen <sandeen@redhat.com>
Signed-off-by: Eric Sandeen <sandeen@sandeen.net>

diff --git a/man/man2/ioctl_xfs_fsgetxattr.2 b/man/man2/ioctl_xfs_fsgetxattr.2
index e2cbfca38ae6f6136475fccbafea272ba5a498a3..2c626a7e37424af8b291ce255bec44e023d1beac 100644 (file)
--- a/man/man2/ioctl_xfs_fsgetxattr.2
+++ b/man/man2/ioctl_xfs_fsgetxattr.2
@@ -104,6 +104,7 @@ will be returned.
 .B XFS_XFLAG_APPEND
 The file is append-only - it can only be opened in append mode for
 writing.
+For directories, this means that files cannot be unlinked from this directory.
 Only the superuser or a process possessing the CAP_LINUX_IMMUTABLE
 capability can set or clear this flag.
 .TP