1DPNS-GETACL(1)                DPNS User Commands                DPNS-GETACL(1)
2
3
4

NAME

6       dpns-getacl - get DPNS directory/file access control lists
7

SYNOPSIS

9       dpns-getacl [-a] [-d] path...
10

DESCRIPTION

12       dpns-getacl  gets the Access Control List associated with a DPNS direc‐
13       tory/file.  For each path, it   displays  the  file  name,  owner,  the
14       group, and the Access Control List (ACL) if present. If a directory has
15       a default ACL, dpns-getacl also displays the default ACL. Regular files
16       cannot have default ACLs.
17
18       The output looks like:
19
20            # file: filename
21            # owner: username
22            # group: groupname
23            user::perm
24            user:uid:perm
25            group::perm
26            group:gid:perm
27            mask:perm
28            other:perm
29            default:user::perm
30            default:user:uid:perm
31            default:group::perm
32            default:group:gid:perm
33            default:mask:perm
34            default:other:perm
35
36       The  first  "user"  entry gives the permissions granted to the owner of
37       the file.  The following "user" entries show the permissions granted to
38       specific  users,  they are sorted in ascending order of uid.  The first
39       "group" entry gives the permissions granted to the group owner  of  the
40       file.   The  following  "group" entries show the permissions granted to
41       specific groups, they are sorted in ascending order of gid.  The "mask"
42       entry  is  the  maximum permission granted to specific users or groups.
43       It does not affect the "owner" and  "other"  permissions.   The  "mask"
44       entry  must be present if there are specific "user" or "group" entries.
45       "default" entries associated with a directory are inherited  as  access
46       ACL  by  the  files  or  sub-directories created in that directory. The
47       umask is not used.  Sub-directories also inherit  the  default  ACL  as
48       default  ACL.  As soon as there is one default ACL entry, the 3 default
49       ACL base entries (default user, default group, default other)  must  be
50       present.
51
52       The entry processing conforms to the Posix 1003.1e draft standard 17.
53
54       path   specifies  the DPNS pathname.  If path does not start with /, it
55              is prefixed by the content of the  DPNS_HOME  environment  vari‐
56              able.
57
58       uid    is displayed as the username if known else as the numeric id.
59
60       gid    is displayed as the groupname if known else as the numeric id.
61
62       perm   is expressed as a combination of characters rwx-
63

OPTIONS

65       -a     only display the access ACL.
66
67       -d     only display the default ACL.
68

EXAMPLES

70       dpns-getacl /dpm/dteam/test/file.log/d2
71
72       # file: /dpm/dteam/test/file.log/d2
73       # owner: baud
74       # group: c3
75       user::rwx
76       group::r-x              #effective:r-x
77       other::r-x
78       default:user::rwx
79       default:group::r-x
80       default:other::r-x
81

EXIT STATUS

83       This  program  returns  0  if the operation was successful or >0 if the
84       operation failed.
85

SEE ALSO

87       Castor_limits(4), dpns_chmod(3), dpns_chown(3)
88

AUTHOR

90       LCG Grid Deployment Team
91
92
93
94DPNS                     $Date: 2005/03/02 08:32:12 $           DPNS-GETACL(1)
Impressum