<html>
<head>
<meta name="Content-Style" content="text/css">
</head>
<body>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#chacl acl pathname...">chacl acl pathname...</a><br>
<a href="#chacl ­b acl dacl pathname...">chacl ­b acl dacl pathname...</a><br>
<a href="#chacl ­d dacl pathname...">chacl ­d dacl pathname...</a><br>
<a href="#chacl ­R pathname...">chacl ­R pathname...</a><br>
<a href="#chacl ­D pathname...">chacl ­D pathname...</a><br>
<a href="#chacl ­B pathname...">chacl ­B pathname...</a><br>
<a href="#chacl ­l pathname...">chacl ­l pathname...</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#EXAMPLES">EXAMPLES</a><br>
<a href="#chacl ­b `chacl ­l olddir | sed ­e 's/.*[//' ­e 's#/# #' ­e 's/]$//'` newdir">chacl ­b `chacl ­l olddir | sed ­e 's/.*[//' ­e 's#/# #' ­e 's/]$//'` newdir</a><br>
<a href="#CAUTIONS">CAUTIONS</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<a href="#CAVEATS">CAVEATS</a><br>
<!-- Creator : groff version 1.16.1 -->
<!-- CreationDate: Wed Jan 24 01:42:48 2001
-->
<!-- Total number of pages: 1 -->
<!-- Page: 1 -->
<!-- left margin: 220 -->
<!-- right margin: 750 -->
<a name="NAME"></a><h2>NAME</h2><p style="margin-left: 18%"><font size=3>chacl - change or list the access control list of a file or directory</font></p>
<a name="SYNOPSIS"></a><h2>SYNOPSIS</h2><a name="chacl acl pathname..."></a><h2>chacl acl pathname...</h2><a name="chacl ­b acl dacl pathname..."></a><h2>chacl ­b acl dacl pathname...</h2><a name="chacl ­d dacl pathname..."></a><h2>chacl ­d dacl pathname...</h2><a name="chacl ­R pathname..."></a><h2>chacl ­R pathname...</h2><a name="chacl ­D pathname..."></a><h2>chacl ­D pathname...</h2><a name="chacl ­B pathname..."></a><h2>chacl ­B pathname...</h2><a name="chacl ­l pathname..."></a><h2>chacl ­l pathname...</h2><a name="DESCRIPTION"></a><h2>DESCRIPTION</h2><p style="margin-left: 18%"><font size=3><I>chacl</I></font> <font size=3>changes or lists the Access Control List(s) for a file or directory. The</font> <font size=3><EM>­b</EM></font> <font size=3>flag indicates that there are two ACLs to change, the first is the file access ACL and the second the directory default ACL. The</font> <font size=3><EM>­d</EM></font> <font size=3>flag is used to set only the default ACL of a directory. The ACL(s) specified are applied to each file in the</font> <font size=3><EM>pathname</EM></font> <font size=3>arguments. The</font> <font size=3><EM>­R</EM></font> <font size=3>and</font> <font size=3><EM>­D</EM></font> <font size=3>flags are used to remove the file access ACL and directory default ACL respectively, the</font> <font size=3><EM>­B</EM></font> <font size=3>flag will remove all ACLs. The</font> <font size=3><EM>­l</EM></font> <font size=3>flag is used to list the access ACL and possibly the default ACL associated with the specified files or directories.</font></p>
<p style="margin-left: 18%"><font size=3>Each ACL is a string which is processed via</font> <font size=3><EM>acl_from_text</EM></font><font size=3>(3). These strings are made up of comma separated clauses each of which is of the form, tag:name:perm. Where</font> <font size=3><EM>tag</EM></font> <font size=3>can be</font>
<table width="99%" rules="none" frame="none" cols="3" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</p>
</td>
<td valign="top" align="left" width="18%">
<p><font size=3>"user" (or "u")</font></p>
<p><font size=3>"group" (or "g")</font></p>
<p><font size=3>"other" (or "o")</font></p>
<p><font size=3>"mask" (or "m")</font></p>
</td>
<td valign="top" align="left" width="63%">
<p><font size=3>indicating that the entry is a user ACL entry.</font></p>
<p><font size=3>indicating that the entry is a group ACL entry.</font></p>
<p><font size=3>indicating that the entry is an other ACL entry.</font></p>
<p><font size=3>indicating that the entry is a mask ACL entry.</font></p>
</td>
</tr>
</table>
</p>
<p style="margin-left: 18%"><font size=3><EM>name</EM></font> <font size=3>is a string which is the user or group name for the ACL entry. A null</font> <font size=3><EM>name</EM></font> <font size=3>in a user or group ACL entry indicates the file's owner or file's group.</font> <font size=3><EM>perm</EM></font> <font size=3>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", "­­­".</font></p>
<a name="EXAMPLES"></a><h2>EXAMPLES</h2><p style="margin-left: 18%"><font size=3>A minimum ACL:</font> <font size=3><B>chacl u::rwx,g::r­x,o::r­­ file<br>
</B>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.</font></p>
<p style="margin-left: 18%"><font size=3>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:</font> <font size=3><EM>chacl u::rwx,g::r­x,o::r­­,u:guest:r­­,m::r­x file1 file2</EM></font></p>
<p style="margin-left: 18%"><font size=3>To set the default and access ACLs on newdir to be the same as on oldir, you could type:</font></p>
<a name="chacl ­b `chacl ­l olddir | sed ­e 's/.*[//' ­e 's#/# #' ­e 's/]$//'` newdir"></a><h2>chacl ­b `chacl ­l olddir | sed ­e 's/.*[//' ­e 's#/# #' ­e 's/]$//'` newdir</h2><a name="CAUTIONS"></a><h2>CAUTIONS</h2><p style="margin-left: 18%"><font size=3><EM>chacl</EM></font> <font size=3>can replace the existing ACL. To add or delete entries, you must first do</font> <font size=3><EM>chacl ­l</EM></font> <font size=3>to get the existing ACL, and use the output to form the arguments to</font> <font size=3><EM>chacl</EM></font><font size=3>.</font></p>
<p style="margin-left: 18%"><font size=3>Changing the permission bits of a file will change the file access ACL settings (see</font> <font size=3><EM>chmod</EM></font><font size=3>(1)). Similarly file­creation mode masks can effect the access ACL settings of files created using directory default ACLs (see</font> <font size=3><EM>umask</EM></font><font size=3>(1)).</font></p>
<p style="margin-left: 18%"><font size=3>ACLs are filesystem extended attributes and are not typically archived or restored using conventional archiving utilities. See</font> <font size=3><EM>attr</EM></font><font size=3>(1) for more information about Extended Attributes and see</font> <font size=3><EM>xfsdump</EM></font><font size=3>(8) for a method to back them up.</font></p>
<a name="SEE ALSO"></a><h2>SEE ALSO</h2><p style="margin-left: 18%"><font size=3>acl_from_text(3), umask(1), xfsdump(8).</font></p>
<a name="CAVEATS"></a><h2>CAVEATS</h2><p style="margin-left: 18%"><font size=3>This command is likely to be deprecated when a standard file­system independent ACL library is available.</font><br>
</p>
</body>
</html>
![[BACK]](/icons/back.gif){kind=icon}
Return to chacl.html CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [Development] / xfs-website.orig / manpages