[BACK]Return to acl_get.html CVS log [TXT][DIR] Up to [Development] / xfs-website.orig / manpages
File: [Development] / xfs-website.orig / manpages / acl_get.html (download) (as text)

Revision 1.1, Thu Jan 25 19:55:30 2001 UTC (16 years, 9 months ago) by xfs
Branch: MAIN
CVS Tags: HEAD 

Man pages update.

<html>
<head>
<meta name="Content-Style" content="text/css">
</head>
<body>
<a href="#NAME">NAME</a><br>
<a href="#C SYNOPSIS">C SYNOPSIS</a><br>
<a href="##include &lt;sys/acl.h&gt;">#include &lt;sys/acl.h&gt;</a><br>
<a href="#int acl_get (const char *path, int fd, struct acl *acl,">int acl_get (const char *path, int fd, struct acl *acl,</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#CAVEAT">CAVEAT</a><br>
<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
<a href="#&shy;EINVAL">&shy;EINVAL</a><br>
<a href="#SEE ALSO">SEE ALSO</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>acl_get - get an XFS access or default ACL</font></p>
<a name="C SYNOPSIS"></a><h2>C SYNOPSIS</h2><a name="#include &lt;sys/acl.h&gt;"></a><h2>#include &lt;sys/acl.h&gt;</h2><a name="int acl_get (const char *path, int fd, struct acl *acl,"></a><h2>int acl_get (const char *path, int fd, struct acl *acl,</h2>
<table width="99%" rules="none" frame="none" cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td valign="top" align="left" width="24%">
</td>
<td valign="top" align="left" width="75%">
<p><font size=3><B>struct acl *dacl);</B></font></p>
</td>
</tr>
</table>
<a name="DESCRIPTION"></a><h2>DESCRIPTION</h2><p style="margin-left: 18%"><font size=3>The</font> <font size=3><I>acl_get</I></font> <font size=3>system call allows a user to retrieve an access or default ACL for a file/directory given either a file descriptor or path name. The</font> <font size=3><I>path</I></font> <font size=3>argument and</font> <font size=3><I>fd</I></font> <font size=3>argument provide alternate ways to specify the same file. The</font> <font size=3><I>acl</I></font> <font size=3>argument refers to the access ACL and should be preallocated. The</font> <font size=3><I>dacl</I></font> <font size=3>argument refers to the default ACL and should be preallocated.</font></p>
<p style="margin-left: 18%"><font size=3>This system call is called from the POSIX ACL functions of<br>
acl_get_fd (3) and<br>
acl_get_file (3). Therefore, direct calling of this system call is not necessary or suggested.</font></p>
<a name="CAVEAT"></a><h2>CAVEAT</h2><p style="margin-left: 18%"><font size=3>This ACL system call can be considered a temporary prototype solution and may be altered for a more generic ACL solution in the future.</font></p>
<a name="DIAGNOSTICS"></a><h2>DIAGNOSTICS</h2><p style="margin-left: 18%"><font size=3><I>acl_get</I></font> <font size=3>will return 0 on success, and a negated error code on any failure.</font></p>
<a name="&shy;EINVAL"></a><h2>&shy;EINVAL</h2>
<table width="99%" rules="none" frame="none" cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td valign="top" align="left" width="36%">
</td>
<td valign="top" align="left" width="63%">
<p><font size=3>Invalid arguments such as</font> <font size=3><I>acl</I></font> <font size=3>and</font> <font size=3><I>dacl</I></font> <font size=3>both being NULL, or</font> <font size=3><I>fd</I></font> <font size=3>and</font> <font size=3><I>path</I></font> <font size=3>either both NULL or both not NULL.</font></p>
</td>
</tr>
</table>
<a name="SEE ALSO"></a><h2>SEE ALSO</h2><p style="margin-left: 18%"><font size=3>acl(5),<br>
acl_get_fd(3), acl_get_file(3),<br>
chacl(1).</font><br>
</p>
</body>
</html>