summaryrefslogtreecommitdiff
path: root/man/man3/acl_get_fd.3
diff options
context:
space:
mode:
authorNathan Scott <nathans@sgi.com>2002-02-25 22:13:12 +0000
committerNathan Scott <nathans@sgi.com>2002-02-25 22:13:12 +0000
commitc9f8bfe909a76d624ba8061d35a28141f43ed251 (patch)
tree539b229655accf088d42f989899842d06e279bc0 /man/man3/acl_get_fd.3
parent3b23e11526bee6d7d47d182a8d3d71c23a4a3c12 (diff)
downloadacl-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.397
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).