lfc_getacl man page

LFC_GETACL(3) LFC Library Functions LFC_GETACL(3)

[1mNAME[0m
lfc_getacl - get LFC directory/file access control lists

[1mSYNOPSIS[0m
[1m#include <sys/types.h>[0m
[1m#include "lfc_api.h"[0m

[1mint lfc_getacl (const char *[4m[22mpath[24m[1m, int [4m[22mnentries[24m[1m, struct lfc_acl *[4m[22macl[24m[1m)[0m

[1mDESCRIPTION[0m
[1mlfc_getacl [22mgets the Access Control List associated with a LFC direc-
tory/file.

[4mpath[24m specifies the logical pathname relative to the current LFC
directory or the full LFC pathname.

[4mnentries[0m
specifies the number of entries that can fit in the buffer. If
[4mnentries[24m is zero, the [4macl[24m pointer can be NULL and the routine
just returns the actual number of entries.

[4macl[24m is a pointer to an array of lfc_acl structures allocated by the
application to receive the reply.

struct lfc_acl {
unsigned char a_type;
int a_id;
unsigned char a_perm;
};

[4ma_type[24m 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.

[4ma_id[24m is the user or group numeric id.

[4ma_perm[24m is the access permission in numeric form obtained by OR'ing some
of the bits S_IROTH, S_IWOTH, S_IXOTH.

[1mRETURN VALUE[0m
This routine returns the actual number of entries if the operation was
successful or -1 if the operation failed. In the latter case, [1mserrno [22mis
set appropriately.

[1mERRORS[0m
[1mENOENT [22mThe named file/directory does not exist or is a null path-
name.

[1mEACCES [22mSearch permission is denied on a component of the [4mpath[0m
prefix.

[1mEFAULT [4m[22mpath[24m is a NULL pointer or [4macl[24m is a NULL pointer and [4mnen-[0m
[4mtries[24m is greater than zero.

[1mENOTDIR [22mA component of [4mpath[24m prefix is not a directory.

[1mEINVAL [4m[22mnentries[24m is negative.

[1mENOSPC [4m[22mnentries[24m is less than the number of entries returned by
the server.

[1mENAMETOOLONG [22mThe length of [4mpath[24m exceeds [1mCA_MAXPATHLEN [22mor the length of
a [4mpath[24m component exceeds [1mCA_MAXNAMELEN[22m.

[1mSENOSHOST [22mHost unknown.

[1mSENOSSERV [22mService unknown.

[1mSECOMERR [22mCommunication error.

[1mENSNACT [22mName server is not running or is being shutdown.

[1mSEE ALSO[0m
[1mCastor_limits(4)[22m, [1mlfc_chdir(3)[22m, [1mlfc_chmod(3)[22m, [1mlfc-getacl(1)[0m

[1mAUTHOR[0m
[1mLCG Grid Deployment [22mTeam

LFC $Date: 2003/04/08 05:37:53 $ LFC_GETACL(3)

Info