File Access Control Library Functions             aclstrip(3SEC)



NAME
     aclstrip - remove all ACLs from a file

SYNOPSIS
     cc [ flag... ] file... -lsec [ library... ]
     #include 

     int aclstrip(const char *path, uidt uid, gidt gid, modet mode);


DESCRIPTION
     The aclstrip() function removes all ACLs from  a  file  and
     replaces them with a trivial ACL based on the mode argument.
     After replacing the ACL, the owner and group of the file are
     set to the values specified by the uid and gid arguments.

RETURN VALUES
     Upon successful completion, aclstrip() returns 0. Otherwise
     it returns -1 and sets errno to indicate the error.

ERORS
     The aclstrip() function will fail if:

     EACES          Search permission is denied on  a  component
                     of the path prefix of path.


     EFAULT          The  path  argument  points  to  an  illegal
                     address.


     EINVAL          The uid or gid argument is out of range.


     EIO             A disk I/O error has occurred while  storing
                     or retrieving the ACL.


     ELOP           A loop exists in symbolic links  encountered
                     during the resolution of the path argument.


     ENAMETOLONG    The length of  the  path  argument   exceeds
                     {PATHMAX},   or  the  length of a path com-
                     ponent     exceeds     {NAMEMAX}      while
                     POSIXNOTRUNC is in effect.


     ENOENT          A component of path does not exist.






SunOS 5.11           Last change: 6 Oct 2005                    1






File Access Control Library Functions             aclstrip(3SEC)



     ENOTDIR         A component of the prefix of path is  not  a
                     directory.


     EPERM           The effective user ID  does  not  match  the
                     owner  of  the file and the process does not
                     have appropriate privileges.


     EROFS           The file system is mounted read-only.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     aclget(3SEC), acltrivial(3SEC), acl(5), attributes(5)


























SunOS 5.11           Last change: 6 Oct 2005                    2