Print this page 
12288 getfacl and setfacl could stand improvement
Split Close
Expand all
Collapse all
          --- old/usr/src/man/man3sec/acltotext.3sec
          +++ new/usr/src/man/man3sec/acltotext.3sec
   1    1  '\" te
   2    2  .\" Copyright (c) 2001, Sun Microsystems, Inc.
   3    3  .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4    4  .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5    5  .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6    6  .TH ACLTOTEXT 3SEC "Dec 10, 2001"
   7    7  .SH NAME
   8    8  acltotext, aclfromtext \- convert internal representation to or from external
   9    9  representation
  10   10  .SH SYNOPSIS
  11      -.LP
  12   11  .nf
  13   12  \fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lsec\fR [ \fIlibrary\fR... ]
  14   13  #include <sys/acl.h>
  15   14  
  16   15  \fBchar *\fR\fBacltotext\fR(\fBaclent_t *\fR\fIaclbufp\fR, \fBint\fR \fIaclcnt\fR);
  17   16  .fi
  18   17  
  19   18  .LP
  20   19  .nf
  21   20  \fBaclent_t *\fR\fBaclfromtext\fR(\fBchar *\fR\fIacltextp\fR, \fBint *\fR\fIaclcnt\fR);
  22   21  .fi
  23   22  
  24   23  .SH DESCRIPTION
  25      -.sp
  26      -.LP
  27   24  The \fBacltotext()\fR function converts an internal \fBACL\fR representation
  28   25  pointed to by \fIaclbufp\fR into an external \fBACL\fR representation. The
  29   26  space for the external text string is obtained using \fBmalloc\fR(3C). The
  30      -caller is responsible for freeing the space upon completion..
       27 +caller is responsible for freeing the space upon completion.
  31   28  .sp
  32   29  .LP
  33   30  The \fBaclfromtext()\fR function converts an external \fBACL\fR representation
  34   31  pointed to by \fIacltextp\fR into an internal \fBACL\fR representation.  The
  35   32  space for the list of \fBACL\fR entries is obtained using \fBmalloc\fR(3C). The
  36   33  caller is responsible for freeing the space upon completion. The \fIaclcnt\fR
  37   34  argument indicates the number of \fBACL\fR entries found.
  38   35  .sp
  39   36  .LP
  40   37  An external \fBACL\fR representation is defined as follows:
↓ open down ↓ 158 lines elided ↑ open up ↑ 
 199  196  .sp
 200  197  .ne 2
 201  198  .na
 202  199  \fB\fB\(mi\fR \fR
 203  200  .ad
 204  201  .RS 9n
 205  202  no access
 206  203  .RE
 207  204  
 208  205  .SH RETURN VALUES
 209      -.sp
 210      -.LP
 211  206  Upon successful completion, the \fBacltotext()\fR function returns a pointer to
 212  207  a text string. Otherwise, it returns \fBNULL\fR.
 213  208  .sp
 214  209  .LP
 215  210  Upon successful completion, the \fBaclfromtext()\fR function returns a pointer
 216  211  to a list of \fBACL\fR entries. Otherwise, it returns \fBNULL\fR.
 217  212  .SH ATTRIBUTES
 218      -.sp
 219      -.LP
 220  213  See \fBattributes\fR(5) for descriptions of the following attributes:
 221  214  .sp
 222  215  
 223  216  .sp
 224  217  .TS
 225  218  box;
 226  219  c | c
 227  220  l | l .
 228  221  ATTRIBUTE TYPE  ATTRIBUTE VALUE
 229  222  _
 230  223  Interface Stability     Evolving
 231  224  _
 232  225  MT-Level        Unsafe
 233  226  .TE
 234  227  
 235  228  .SH SEE ALSO
 236      -.sp
 237      -.LP
 238  229  \fBacl\fR(2), \fBmalloc\fR(3C), \fBattributes\fR(5)
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX