Re: [PATCH] man: document XFS_XFLAG_APPEND behavior for directories

[Eric Sandeen <sandeen@redhat.com>]

On 2/24/21 4:29 PM, Darrick J. Wong wrote:
> From: Darrick J. Wong <djwong@kernel.org>
> 
> 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.

sounds good.

> 
> Signed-off-by: Darrick J. Wong <djwong@kernel.org>

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

> ---
>  man/man2/ioctl_xfs_fsgetxattr.2 |    1 +
>  1 file changed, 1 insertion(+)
> 
> diff --git a/man/man2/ioctl_xfs_fsgetxattr.2 b/man/man2/ioctl_xfs_fsgetxattr.2
> index e2cbfca3..2c626a7e 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
>