acltotext man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

ACLTOTEXT(3SEC)						       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(5) for descriptions of the following attributes:

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       ├────────────────────┼─────────────────┤
       │Interface Stability │ Evolving	      │
       ├────────────────────┼─────────────────┤
       │MT-Level	    │ Unsafe	      │
       └────────────────────┴─────────────────┘

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

				 Dec 10, 2001		       ACLTOTEXT(3SEC)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net