From: Darrick J. Wong Date: Wed, 24 Feb 2021 22:38:46 +0000 (-0500) Subject: man: document XFS_XFLAG_APPEND behavior for directories X-Git-Tag: v5.11.0-rc1~1 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=5f58bffa2a288002d42211616f68f04d506b06f9;p=thirdparty%2Fxfsprogs-dev.git 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 Reviewed-by: Eric Sandeen Signed-off-by: Eric Sandeen --- diff --git a/man/man2/ioctl_xfs_fsgetxattr.2 b/man/man2/ioctl_xfs_fsgetxattr.2 index e2cbfca38..2c626a7e3 100644 --- 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