[BACK]Return to acl_from_text.html CVS log [TXT][DIR] Up to [Development] / xfs-website.orig / manpages
File: [Development] / xfs-website.orig / manpages / acl_from_text.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="#SYNOPSIS">SYNOPSIS</a><br>
<a href="##include &lt;sys/acl.h&gt;">#include &lt;sys/acl.h&gt;</a><br>
<a href="#acl_t acl_from_text(const char *argp);">acl_t acl_from_text(const char *argp);</a><br>
<a href="#char * acl_to_short_text(struct acl * aclp, ssize_t *len_p);">char * acl_to_short_text(struct acl * aclp, ssize_t *len_p);</a><br>
<a href="#char * acl_to_text(struct acl * aclp, ssize_t *len_p);">char * acl_to_text(struct acl * aclp, ssize_t *len_p);</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#RETURN VALUES">RETURN VALUES</a><br>
<a href="#ERRORS">ERRORS</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_from_text, acl_to_short_text, acl_to_text - convert a POSIX ACL string to a struct acl or a struct acl to a POSIX ACL string</font></p>
<a name="SYNOPSIS"></a><h2>SYNOPSIS</h2><a name="#include &lt;sys/acl.h&gt;"></a><h2>#include &lt;sys/acl.h&gt;</h2><a name="acl_t acl_from_text(const char *argp);"></a><h2>acl_t acl_from_text(const char *argp);</h2><a name="char * acl_to_short_text(struct acl * aclp, ssize_t *len_p);"></a><h2>char * acl_to_short_text(struct acl * aclp, ssize_t *len_p);</h2><a name="char * acl_to_text(struct acl * aclp, ssize_t *len_p);"></a><h2>char * acl_to_text(struct acl * aclp, ssize_t *len_p);</h2><a name="DESCRIPTION"></a><h2>DESCRIPTION</h2><p style="margin-left: 18%"><font size=3>These routines convert strings defined by the POSIX P1003.1e specifications (see</font> <font size=3><I>xfs_acl</I></font><font size=3>(1)) to/from</font> <font size=3><I>struct acl</I></font><font size=3>, which is the internal format for an Access Control List.</font></p>
<a name="RETURN VALUES"></a><h2>RETURN VALUES</h2><p style="margin-left: 18%"><font size=3><I>acl_from_text</I></font> <font size=3>returns a pointer to a</font> <font size=3><I>struct acl</I></font> <font size=3>allocated by the routine or a NULL pointer in the case of a failure. The acl should be freed when no longer needed by calling</font> <font size=3><I>acl_free</I></font><font size=3>(3).</font></p>
<p style="margin-left: 18%"><font size=3><I>acl_to_text</I></font> <font size=3>returns a pointer to a null terminated character string allocated by the routine which is a long form representation of the ACL, or a NULL pointer if an error occurred. This string should be freed when no longer needed by calling</font> <font size=3><I>acl_free</I></font><font size=3>(3). If the</font> <font size=3><I>len_p</I></font> <font size=3>argument is not NULL, then the length of the string is returned in</font> <font size=3><I>ssize_t</I></font> <font size=3>pointed to by</font> <font size=3><I>len_p</I></font><font size=3>.</font> <font size=3><I>acl_to_short_text</I></font> <font size=3>is identical to</font> <font size=3><I>acl_to_text</I></font><font size=3>, except that a short form representation of the ACL is returned.</font></p>
<a name="ERRORS"></a><h2>ERRORS</h2>
<table width="98%" rules="none" frame="none" cols="4" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="13%">
<p><font size=3><I>acl_from_text:</I></font></p>
</td>
<td valign="top" align="left" width="1%">
</td>
<td valign="top" align="left" width="66%">
</td>
</tr>
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="13%">
<p><font size=3>EINVAL</font></p>
<p><font size=3>ENOMEM</font></p>
</td>
<td valign="top" align="left" width="1%">
</td>
<td valign="top" align="left" width="66%">
<p><font size=3>input text is invalid</font></p>
<p><font size=3>could not allocate space for new acl</font></p>
</td>
</tr>
</table>
<p style="margin-left: 18%"><font size=3><I>acl_to_short_text:</I></font>
<table width="97%" rules="none" frame="none" cols="4" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</p>
</td>
<td valign="top" align="left" width="10%">
<p><font size=3>EINVAL</font></p>
<p><font size=3>ENOMEM</font></p>
<p><font size=3><I>acl_to_text:</I></font></p>
</td>
<td valign="top" align="left" width="3%">
</td>
<td valign="top" align="left" width="66%">
<p><font size=3>input acl is invalid</font></p>
<p><font size=3>could not allocate space for the return string</font></p>
</td>
</tr>
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="10%">
<p><font size=3>EINVAL</font></p>
<p><font size=3>ENOMEM</font></p>
</td>
<td valign="top" align="left" width="3%">
</td>
<td valign="top" align="left" width="66%">
<p><font size=3>input acl is invalid</font></p>
<p><font size=3>could not allocate space for the return string</font></p>
</td>
</tr>
</table>
<br>
</p>
</body>
</html>