1DPNS‐GETACL(1)                      DPNS       User      Commands
2DPNS‐GETACL(1)
3
4
5
6[1mNAME[0m
7       dpns‐getacl ‐ get DPNS directory/file access control lists
8
9[1mSYNOPSIS[0m
10       [1mdpns‐getacl [22m[[1m‐a[22m] [[1m‐d[22m] [4mpath[24m...
11
12[1mDESCRIPTION[0m
13       [1mdpns‐getacl  [22mgets the Access Control List associat‐
14ed with a DPNS direc‐
15       tory/file.  For each [4mpath[24m, it   displays  the  file
16name,  owner,  the
17       group, and the Access Control List (ACL) if present. If  a
18directory has
19       a  default  ACL,  [1mdpns‐getacl [22malso displays the de‐
20fault ACL. Regular files
21       cannot have default ACLs.
22
23       The output looks like:
24
25            # file: filename
26            # owner: username
27            # group: groupname
28            user::perm
29            user:uid:perm
30            group::perm
31            group:gid:perm
32            mask:perm
33            other:perm
34            default:user::perm
35            default:user:uid:perm
36            default:group::perm
37            default:group:gid:perm
38            default:mask:perm
39            default:other:perm
40
41       The  first  "user"  entry gives the permissions granted to
42the owner of
43       the  file.   The following "user" entries show the permis‐
44sions granted to
45       specific  users,  they are sorted in  ascending  order  of
46uid.  The first
47       "group"  entry  gives the permissions granted to the group
48owner  of  the
49       file.   The  following  "group" entries show  the  permis‐
50sions granted to
51       specific  groups,  they  are  sorted in ascending order of
52gid.  The "mask"
53       entry  is  the  maximum  permission  granted  to  specific
54users or groups.
55       It  does not affect the "owner" and  "other"  permissions.
56The  "mask"
57       entry  must be present if there  are  specific  "user"  or
58"group" entries.
59       "default" entries associated with a directory are inherit‐
60ed  as  access
61       ACL  by  the  files  or  sub‐directories created  in  that
62directory. The
63       [1mumask  [22mis  not  used.  Sub‐directories also inherit
64the  default  ACL  as
65       default  ACL.  As soon as there is one default ACL  entry,
66the 3 default
67       ACL  base  entries  (default  user, default group, default
68other)  must  be
69       present.
70
71       The entry processing conforms to the Posix  1003.1e  draft
72standard 17.
73
74       [4mpath[24m      specifies    the   DPNS   pathname.    If
75[4mpath[24m does not start with [1m/[22m, it
76              is prefixed by the  content  of  the   [1mDPNS_HOME
77[22menvironment  vari‐
78              able.
79
80       [4muid[24m     is  displayed as the username if known else
81as the numeric id.
82
83       [4mgid[24m    is displayed as the groupname if known  else
84as the numeric id.
85
86       [4mperm[24m    is expressed as a combination of characters
87[1mrwx‐[0m
88
89[1mOPTIONS[0m
90       [1m‐a     [22monly display the access ACL.
91
92       [1m‐d     [22monly display the default ACL.
93
94[1mEXAMPLES[0m
95       dpns‐getacl /dpm/dteam/test/file.log/d2
96
97       # file: /dpm/dteam/test/file.log/d2
98       # owner: baud
99       # group: c3
100       user::rwx
101       group::r‐x              #effective:r‐x
102       other::r‐x
103       default:user::rwx
104       default:group::r‐x
105       default:other::r‐x
106
107[1mEXIT STATUS[0m
108       This  program  returns  0  if the operation was successful
109or >0 if the
110       operation failed.
111
112[1mSEE ALSO[0m
113       [1mCastor_limits(4)[22m,    [1mdpns_chmod(3)[22m,   [1mdp‐
114ns_chown(3)[0m
115
116[1mAUTHOR[0m
117       [1mLCG Grid Deployment [22mTeam
118
119
120
121DPNS                        $Date:    2005/03/02    08:32:12    $
122DPNS‐GETACL(1)
123
124
125
126
127
128
129
130
131
132
Impressum