DPNS_SETACL(3)

NAME

dpns_setacl - set DPNS directory/file access control lists

#include <sys/types.h>
#include "dpns_api.h"

int dpns_setacl (const char *path, int nentries, struct dpns_acl *acl)

dpns_setacl sets the Access Control List associated with a DPNS directory/file.

path specifies the logical pathname relative to the current DPNS: directory or the full DPNS pathname.
nentries: specifies the number of entries present in the buffer.
acl is a pointer to an array of dpns_acl structures provided by the: application.
struct dpns_acl {: unsigned char a_type;
int a_id;
unsigned char a_perm;
};
a_type is the ACL type: CNS_ACL_USER_OBJ, CNS_ACL_USER,: CNS_ACL_GROUP_OBJ, CNS_ACL_GROUP, CNS_ACL_MASK or CNS_ACL_OTHER. Types for default entries are obtained by OR'ing the flag CNS_ACL_DEFAULT with one of the above types.
a_id is the user or group numeric id.
a_perm is the access permission in numeric form obtained by OR'ing some: of the bits S_IROTH, S_IWOTH, S_IXOTH.
The effective user ID of the process must match the owner of the file or the caller must have ADMIN privilege in the Cupv database.

This routine returns 0 if the operation was successful or -1 if the operation failed. In the latter case, serrno is set appropriately.

EPERM The effective user ID does not match the owner of the file: and the caller does not have ADMIN privilege in the Cupv database.
ENOENT The named file/directory does not exist or is a null path: name.
EACCES Search permission is denied on a component of the path: prefix.
EFAULT path or acl is a NULL pointer.
ENOTDIR A component of path prefix is not a directory.
EINVAL nentries is not greater than zero or is greater than: CA_MAXACLENTRIES or the ACL entries are not valid.
ENOSPC The name server database is full.
ENAMETOOLONG The length of path exceeds CA_MAXPATHLEN or the length of: a path component exceeds CA_MAXNAMELEN.
SENOSHOST Host unknown.
SENOSSERV Service unknown.
SECOMERR Communication error.
ENSNACT Name server is not running or is being shutdown.

LCG Grid Deployment Team