acltotext(3sec) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

acltotext(3sec)

File Access Control Library Functions                          acltotext(3SEC)



NAME
       acltotext,  aclfromtext  -  convert  internal representation to or from
       external representation

SYNOPSIS
       cc [ flag... ] file... -lsec [ library... ]
       #include <sys/acl.h>

       char *acltotext(aclent_t *aclbufp, int aclcnt);


       aclent_t *aclfromtext(char *acltextp, int *aclcnt);

DESCRIPTION
       The  acltotext()  function  converts  an  internal  ACL  representation
       pointed  to  by  aclbufp into an external ACL representation. The space
       for the external text string is obtained using malloc(3C).  The  caller
       is responsible for freeing the space upon completion..


       The  aclfromtext()  function  converts  an  external ACL representation
       pointed to by acltextp into an internal ACL representation.  The  space
       for the list of ACL entries is obtained using malloc(3C). The caller is
       responsible for freeing the space upon completion. The aclcnt  argument
       indicates the number of ACL entries found.


       An external ACL representation is defined as follows:


       <acl_entry>[,<acl_entry>]...


       Each <acl_entry> contains one ACL entry. The external representation of
       an ACL entry contains two or three colon-separated  fields.  The  first
       field  contains  the  ACL  entry  tag type. The entry type keywords are
       defined as:

       user             This ACL entry with no UID specified in the ACL  entry
                        ID  field specifies the access granted to the owner of
                        the object. Otherwise, this ACL  entry  specifies  the
                        access granted to a specific user-name or user-id num‐
                        ber.


       group            This ACL entry with no GID specified in the ACL  entry
                        ID  field  specifies  the access granted to the owning
                        group of the object. Otherwise, this ACL entry  speci‐
                        fies  the  access  granted to a specific group-name or
                        group-id number.


       other            This ACL entry specifies the  access  granted  to  any
                        user or group that does not match any other ACL entry.


       mask             This ACL entry specifies the maximum access granted to
                        user or group entries.


       default:user     This ACL entry with no uid specified in the ACL  entry
                        ID  field  specifies the default access granted to the
                        owner of the object. Otherwise, this ACL entry  speci‐
                        fies  the  default  access granted to a specific user-
                        name or user-ID number.


       default:group    This ACL entry with no gid specified in the ACL  entry
                        ID  field  specifies the default access granted to the
                        owning group of the object. Otherwise, this ACL  entry
                        specifies  the  default  access  granted to a specific
                        group-name or group-ID number.


       default:other    This ACL entry specifies the default access for  other
                        entry.


       default:mask     This  ACL  entry specifies the default access for mask
                        entry.



       The second field contains the ACL entry ID, as follows:

       uid      This field specifies a user-name, or user-ID if  there  is  no
                user-name associated with the user-ID number.


       gid      This  field specifies a group-name, or group-ID if there is no
                group-name associated with the group-ID number.


       empty    This field is used by the user and group ACL entry types.



       The third field contains the following  symbolic  discretionary  access
       permissions:

       r       read permission


       w       write permission


       x       execute/search permission


       −       no access


RETURN VALUES
       Upon  successful completion, the acltotext() function returns a pointer
       to a text string. Otherwise, it returns NULL.


       Upon  successful  completion,  the  aclfromtext()  function  returns  a
       pointer to a list of ACL entries. Otherwise, it returns NULL.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelUnsafe


SEE ALSO
       acl(2), malloc(3C), attributes(7)



Oracle Solaris 11.4               10 Dec 2001                  acltotext(3SEC)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3