fs: rename current get acl method
authorChristian Brauner <brauner@kernel.org>
Thu, 22 Sep 2022 15:17:00 +0000 (17:17 +0200)
committerChristian Brauner (Microsoft) <brauner@kernel.org>
Thu, 20 Oct 2022 08:13:27 +0000 (10:13 +0200)
commitcac2f8b8d8b50ef32b3e34f6dcbbf08937e4f616
tree040a034efa1384a0f1f4034d4b36586638eaa921
parent138060ba92b3b0d77c8e6818d0f33398b23ea42e
fs: rename current get acl method

The current way of setting and getting posix acls through the generic
xattr interface is error prone and type unsafe. The vfs needs to
interpret and fixup posix acls before storing or reporting it to
userspace. Various hacks exist to make this work. The code is hard to
understand and difficult to maintain in it's current form. Instead of
making this work by hacking posix acls through xattr handlers we are
building a dedicated posix acl api around the get and set inode
operations. This removes a lot of hackiness and makes the codepaths
easier to maintain. A lot of background can be found in [1].

The current inode operation for getting posix acls takes an inode
argument but various filesystems (e.g., 9p, cifs, overlayfs) need access
to the dentry. In contrast to the ->set_acl() inode operation we cannot
simply extend ->get_acl() to take a dentry argument. The ->get_acl()
inode operation is called from:

acl_permission_check()
-> check_acl()
   -> get_acl()

which is part of generic_permission() which in turn is part of
inode_permission(). Both generic_permission() and inode_permission() are
called in the ->permission() handler of various filesystems (e.g.,
overlayfs). So simply passing a dentry argument to ->get_acl() would
amount to also having to pass a dentry argument to ->permission(). We
should avoid this unnecessary change.

So instead of extending the existing inode operation rename it from
->get_acl() to ->get_inode_acl() and add a ->get_acl() method later that
passes a dentry argument and which filesystems that need access to the
dentry can implement instead of ->get_inode_acl(). Filesystems like cifs
which allow setting and getting posix acls but not using them for
permission checking during lookup can simply not implement
->get_inode_acl().

This is intended to be a non-functional change.

Link: https://lore.kernel.org/all/20220801145520.1532837-1-brauner@kernel.org
Suggested-by/Inspired-by: Christoph Hellwig <hch@lst.de>
Reviewed-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Christian Brauner (Microsoft) <brauner@kernel.org>
47 files changed:
Documentation/filesystems/locking.rst
Documentation/filesystems/porting.rst
Documentation/filesystems/vfs.rst
fs/9p/vfs_inode_dotl.c
fs/bad_inode.c
fs/btrfs/inode.c
fs/ceph/dir.c
fs/ceph/inode.c
fs/erofs/inode.c
fs/erofs/namei.c
fs/ext2/file.c
fs/ext2/namei.c
fs/ext4/file.c
fs/ext4/ialloc.c
fs/ext4/namei.c
fs/f2fs/file.c
fs/f2fs/namei.c
fs/fuse/dir.c
fs/gfs2/inode.c
fs/jffs2/dir.c
fs/jffs2/file.c
fs/jfs/file.c
fs/jfs/namei.c
fs/ksmbd/smb2pdu.c
fs/ksmbd/smbacl.c
fs/ksmbd/vfs.c
fs/namei.c
fs/nfs/nfs3acl.c
fs/nfs/nfs3proc.c
fs/nfsd/nfs2acl.c
fs/nfsd/nfs3acl.c
fs/nfsd/nfs4acl.c
fs/ntfs3/file.c
fs/ntfs3/namei.c
fs/ocfs2/file.c
fs/ocfs2/namei.c
fs/orangefs/inode.c
fs/orangefs/namei.c
fs/overlayfs/dir.c
fs/overlayfs/inode.c
fs/posix_acl.c
fs/reiserfs/file.c
fs/reiserfs/namei.c
fs/reiserfs/xattr_acl.c
fs/xfs/xfs_iops.c
include/linux/fs.h
include/linux/posix_acl.h