CHACL(1)		     Access Control Lists		      CHACL(1)

NAME
       chacl - change the access control list of a file or directory

SYNOPSIS
       chacl acl pathname...
       chacl -b acl dacl pathname...
       chacl -d dacl pathname...
       chacl -R pathname...
       chacl -D pathname...
       chacl -B pathname...
       chacl -l pathname...
       chacl -r pathname...

DESCRIPTION
       chacl is an IRIX-compatibility command, and is maintained for those
       users who are familiar with its use from either XFS or IRIX.  Refer to
       the SEE ALSO section below for a description of tools which conform
       more closely to the (withdrawn draft) POSIX 1003.1e standard which
       describes Access Control Lists (ACLs).

       chacl changes the ACL(s) for a file or directory.  The ACL(s) specified
       are applied to each file in the pathname arguments.

       Each ACL is a string which is interpreted using the acl_from_text(3)
       routine.	 These strings are made up of comma separated clauses each of
       which is of the form, tag:name:perm.  Where tag can be:

       "user" (or "u")
	      indicating that the entry is a "user" ACL entry.

       "group" (or "g")
	      indicating that the entry is a "group" ACL entry.

       "other" (or "o")
	      indicating that the entry is an "other" ACL entry.

       "mask" (or "m")
	      indicating that the entry is a "mask" ACL entry.

       name is a string which is the user or group name for the ACL entry.  A
       null name in a user or group ACL entry indicates the file's owner or
       file's group.  perm is the string "rwx" where each of the entries may
       be replaced by a "-" indicating no access of that type, e.g. "r-x",
       "--x", "---".

OPTIONS
       -b     Indicates that there are two ACLs to change, the first is the
	      file access ACL and the second the directory default ACL.

       -d     Used to set only the default ACL of a directory.

       -R     Removes the file access ACL only.

       -D     Removes directory default ACL only.

       -B     Remove all ACLs.

       -l     Lists the access ACL and possibly the default ACL associated
	      with the specified files or directories.	This option was added
	      during the Linux port of XFS, and is not IRIX compatible.

       -r     Set the access ACL recursively for each subtree rooted at
	      pathname(s).  This option was also added during the Linux port
	      of XFS, and is not compatible with IRIX.

EXAMPLES
       A minimum ACL:

	 chacl u::rwx,g::r-x,o::r-- file

       The file ACL is set so that the file's owner has "rwx", the file's
       group has read and execute, and others have read only access to the
       file.

       An ACL that is not a minimum ACL, that is, one that specifies a user or
       group other than the file's owner or owner's group, must contain a mask
       entry:

	 chacl u::rwx,g::r-x,o::r--,u:bob:r--,m::r-x file1 file2

       To set the default and access ACLs on newdir to be the same as on
       olddir, you could type:

	 chacl -b `chacl -l olddir | \
	     sed -e 's/.*\[//' -e 's#/# #' -e 's/]$//'` newdir


CAUTIONS
       chacl can replace the existing ACL.  To add or delete entries, you must
       first do chacl -l to get the existing ACL, and use the output to form
       the arguments to chacl.

       Changing the permission bits of a file will change the file access ACL
       settings (see chmod(1)).	 However, file creation mode masks (see
       umask(1)) will not affect the access ACL settings of files created
       using directory default ACLs.

       ACLs are filesystem extended attributes and hence are not typically
       archived or restored using the conventional archiving utilities.	 See
       attr(5) for more information about extended attributes and see
       xfsdump(8) for a method of backing them up under XFS.

SEE ALSO
       getfacl(1), setfacl(1), chmod(1), umask(1), acl_from_text(3), acl(5),
       xfsdump(8)

September 2001		      ACL File Utilities		      CHACL(1)