diff options
author | Nathan Scott <nathans@sgi.com> | 2002-02-25 22:13:12 +0000 |
---|---|---|
committer | Nathan Scott <nathans@sgi.com> | 2002-02-25 22:13:12 +0000 |
commit | c9f8bfe909a76d624ba8061d35a28141f43ed251 (patch) | |
tree | 539b229655accf088d42f989899842d06e279bc0 /man/man3/acl_get_fd.3 | |
parent | 3b23e11526bee6d7d47d182a8d3d71c23a4a3c12 (diff) | |
download | acl-c9f8bfe909a76d624ba8061d35a28141f43ed251.tar.gz |
Merge of xfs-cmds-2.4.18:slinx:111141a by nathans.
deleted, we now switch over to a new version of ACL userspace derived
closely from Andreas' code.
Diffstat (limited to 'man/man3/acl_get_fd.3')
-rw-r--r-- | man/man3/acl_get_fd.3 | 97 |
1 files changed, 0 insertions, 97 deletions
diff --git a/man/man3/acl_get_fd.3 b/man/man3/acl_get_fd.3 index 457e7c8..e69de29 100644 --- a/man/man3/acl_get_fd.3 +++ b/man/man3/acl_get_fd.3 @@ -1,97 +0,0 @@ -.TH ACL_GET_FD 3 -.SH NAME -acl_get_fd, acl_set_fd \- get or set the ACL associated with an open file -.SH SYNOPSIS -.B #include <sys/acl.h> -.PP -.B struct acl * acl_get_fd(int fd); -.br -.B int acl_set_fd(int fd, struct acl *aclp); -.SH DESCRIPTION -.I acl_get_fd -returns a pointer to an allocated \f2struct acl\fP associated with the -open file referred to by \f2fd\fP. -If -.B _POSIX_MAC -is in effect, then the process must have MAC read access to the object. -If no access ACL is associated with the \f2fd\fP, then the resultant ACL -is dependent on the ACL compatibility mode (see -.BR acl_set_compat (8) -). If \f2ACL_COMPAT_IRIXGET\f1 is -set then an ACL with a count of ACL_NOT_PRESENT is returned. Otherwise, -when no compatibility mode has been set, a mininum 3 ACE ACL based on the -file's mode is returned. -.PP -.I acl_set_fd -sets the ACL for the open file referred to by \f2fd\fP from the \f2struct acl\fP -pointed to by \f2aclp\fP. -The effective UID of the process must match the owner of the object or the -process must have appropriate privilege to set the access ACL on the -object. If -.B _POSIX_CAP -is in effect, then the appropriate capability must include CAP_FOWNER. -In addition, if -.B _POSIX_MAC -is in effect, then the process must have MAC write access to the object. -\f2acl_set_fd\fP -function will succeed only if the ACL -is valid as defined by the -\f2acl_valid\fP(3) -function. -.SH RETURN VALUES -.I acl_get_fd -returns a pointer to an allocated \f2struct acl\fP if successful, NULL otherwise. -The storage should be freed with a call to \f2acl_free\fP with the returned -pointer as an argument when it is no longer needed. -.PP -.I acl_set_fd -returns 0 if successful, -1 otherwise. -.SH ERRORS -.I acl_get_fd: -.TP 16 -EACCESS -Access to the object is denied. -.TP 16 -EBADF -\f2fd\fP is not a valid file descriptor. -.TP 16 -ENOMEM -allocation of the \f2struct acl\fP failed. -.TP 16 -ENOSYS -ACL support is not configured in kernel. -.TP 16 -EOPNOTSUPP (ENOTSUP) -ACL support is not available for given filesystem. -.PP -.I acl_set_fd: -.TP 16 -EACCESS -Access to the object is denied. -.TP 16 -EBADF -\f2fd\fP is not a valid file descriptor. -.TP 16 -EINVAL -The ACL is not valid or too large (too many entries). -.TP 16 -ENOSPC -The file system is full or some other resource needed for the ACL storage -is not available. -.TP 16 -ENOSYS -ACL support is not configured in kernel. -.TP 16 -EOPNOTSUPP (ENOTSUP) -ACL support is not available for given filesystem. -.TP 16 -EPERM -The process does not have appropriate privilege to -perform the operation to set the ACL. -.TP 16 -EROFS -This function requires modification of a file system which is currently -read-only. -.SH SEE ALSO -.BR acl_get_file (8), -.BR acl_set_compat (8). |