Rahul Sharma (Editor)

Richacls

Updated on
Edit
Like
Comment
Share on FacebookTweet on TwitterShare on LinkedInShare on Reddit

Richacls is a Linux implementation of the NFSv4 ACLs which has been extended by file masks to more easily fit the standard POSIX file permission model. Nowadays, they offer the most complex permission model for ext4 file system in Linux operating system. They are even more complex than POSIX ACLs, which means it is not possible to convert back from Richacls to POSIX ACLs without losing information. One of the most important advantages is that they distinguish between write and append permission, between delete and delete child permissions, and make ACL management access discretionary (as opposed to only being only root and the file owner). They are also designed to support Windows interoperability.

Contents

Richacls use ext4 extended file attributes (xattrs) to store ACLs. Entries in ACL are called ACE (Access Control List Entry).

Support in the Linux kernel

There is still no support for Richacls in recent version of official Linux kernel (vanilla sources). Thus in order to get richacl work it is necessary to do one of the following:

  • apply an additional kernel patch and compile own kernel. The patch is available at project homepage;
  • use some Linux distribution which has included this patch. For example, OpenSUSE version 11.3 through 12.3.
  • To verify whether your system has compatibility for Richacls, in most cases you can simply type the following command to system console:

    Enabling Richacls

    Once you have running Richacls support on your system, you can enable them up on certain file system. Following example shows how to enable Richacls on root filesystem.

    The verification can be done in such way:

    and the output should show Richacls enabled:

    /dev/sda1 on / type ext4 (rw,richacl)

    Richacls can be also enabled permanently by adding richacl parameter to certain mount entry in /etc/fstab.

    Richacl manipulation tools

    For manipulation with Richacl entries there is utility called richacl, which is also available at project homepage. This tool can perform several basic operations for specific file or directory such as:

  • show ACL
  • set ACL
  • modify individual ACEs
  • remove ACL
  • show current permissions of certain user or group
  • Format of Richacl ACEs

    Format of each ACL entry (ACE) corresponds to <who>:<permission mask>:<flags>:<type>.

    Where values of <who> can be:

  • certain user ID or group ID
  • owner@
  • group@
  • everyone@
  • Values with @ symbol are used to defining permissions for owner, owning group and others.

    To define value of <permission mask>, there are 16 permission bits (according to NFSv4 resp. NFSv4.1 specification) but five of them are not implemented. The meaning of each bit is described in the following table.

    The value of <flags> can consist of following:

    Value of <type> are ALLOW or DENY. NFSv4 specification uses also AUDIT and ALARM ACE type, but these are accepted and stored, but not implemented in Richacls.

    DENY ACE type has higher priority.

    Sample usage

    Example above defines such permission policy, that each user in group powerusers can read, write and append files in /srv/files/exchange/ and subdirectories.

    Moreover, users in powerusers group can delete their own files and directories (and their content).

    Except this, users of group storageadmins can manipulate with data arbitrarily. They can also modify ACLs.

    Other users have no access to given directory at all.

    This permission model is unrealizable by using POSIX ACLs, even with sticky bit, because of necessary inheritance.

    References

    Richacls Wikipedia