ACL_GET man page on SmartOS

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

ACL_GET(3SEC)							 ACL_GET(3SEC)

NAME
       acl_get,	 facl_get, acl_set, facl_set - get or set a file's Access Con‐
       trol List (ACL)

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

       int *acl_get(const char *path, int flag, acl_t **aclp);

       int *facl_get(int fd, int flag, acl_t **aclp);

       int acl_set(const char *path, acl_t *aclp);

       int facl_set(int fd, acl_t *aclp);

DESCRIPTION
       The acl_get() and facl_get() functions retrieve an Access Control  List
       (ACL)  of  a file whose name is given by path or referenced by the open
       file descriptor fd. The flag argument specifies whether a  trivial  ACL
       should  be  retrieved.  When  the flag argument is ACL_NO_TRIVIAL, only
       ACLs that are not trivial will be retrieved. The ACL is returned in the
       aclp argument.

       The acl_set() and facl_set() functions are used for setting an ACL of a
       file whose name is given	 by  path  or  referenced  by  the  open  file
       descriptor fd. The aclp argument specifies the ACL to set.

       The  acl_get()  and acl_set() functions support multiple types of ACLs.
       When possible, the acl_set() function translates an ACL to  the	target
       file's  style  of ACL. Currently this is only possible when translating
       from a POSIX-draft ACL such as on UFS to a file	system	that  supports
       NFSv4 ACL semantics such as ZFS or NFSv4.

RETURN VALUES
       Upon  successful completion, acl_get() and facl_get() return 0 and aclp
       is non-NULL. The aclp argument can be NULL after successful  completion
       if the file had a trivial ACL and the flag argument was ACL_NO_TRIVIAL.
       Otherwise, -1 is returned and errno is set to indicate the error.

       Upon successful completion, acl_set() and facl_set() return 0.	Other‐
       wise, -1 is returned and errno is set to indicate the error.

ERRORS
       These functions will fail if:

       EACCES
		  The caller does not have access to a component of path.

       EIO
		  A disk I/O error has occured while retrieving the ACL.

       ENOENT
		  A component of the path does not exist.

       ENOSYS
		  The file system does not support ACLs.

       ENOTSUP
		  The ACL supplied could not be translated to an NFSv4 ACL.

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

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

SEE ALSO
       chmod(1), acl(2), acl(5), attributes(5)

				  Oct 6, 2005			 ACL_GET(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