dpns-getacl man page

DPNS-GETACL(1) DPNS User Commands DPNS-GETACL(1)

[1mNAME[0m
dpns-getacl - get DPNS directory/file access control lists

[1mSYNOPSIS[0m
[1mdpns-getacl [22m[[1m-a[22m] [[1m-d[22m] [4mpath[24m...

[1mDESCRIPTION[0m
[1mdpns-getacl [22mgets the Access Control List associated with a DPNS direc-
tory/file. For each [4mpath[24m, it displays the file name, owner, the
group, and the Access Control List (ACL) if present. If a directory has
a default ACL, [1mdpns-getacl [22malso displays the default ACL. Regular files
cannot have default ACLs.

The output looks like:

# file: filename
# owner: username
# group: groupname
user::perm
user:uid:perm
group::perm
group:gid:perm
mask:perm
other:perm
default:user::perm
default:user:uid:perm
default:group::perm
default:group:gid:perm
default:mask:perm
default:other:perm

The first "user" entry gives the permissions granted to the owner of
the file. The following "user" entries show the permissions granted to
specific users, they are sorted in ascending order of uid. The first
"group" entry gives the permissions granted to the group owner of the
file. The following "group" entries show the permissions granted to
specific groups, they are sorted in ascending order of gid. The "mask"
entry is the maximum permission granted to specific users or groups.
It does not affect the "owner" and "other" permissions. The "mask"
entry must be present if there are specific "user" or "group" entries.
"default" entries associated with a directory are inherited as access
ACL by the files or sub-directories created in that directory. The
[1mumask [22mis not used. Sub-directories also inherit the default ACL as
default ACL. As soon as there is one default ACL entry, the 3 default
ACL base entries (default user, default group, default other) must be
present.

The entry processing conforms to the Posix 1003.1e draft standard 17.

[4mpath[24m specifies the DPNS pathname. If [4mpath[24m does not start with [1m/[22m, it
is prefixed by the content of the [1mDPNS_HOME [22menvironment vari-
able.

[4muid[24m is displayed as the username if known else as the numeric id.

[4mgid[24m is displayed as the groupname if known else as the numeric id.

[4mperm[24m is expressed as a combination of characters [1mrwx-[0m

[1mOPTIONS[0m
[1m-a [22monly display the access ACL.

[1m-d [22monly display the default ACL.

[1mEXAMPLES[0m
dpns-getacl /dpm/dteam/test/file.log/d2

# file: /dpm/dteam/test/file.log/d2
# owner: baud
# group: c3
user::rwx
group::r-x #effective:r-x
other::r-x
default:user::rwx
default:group::r-x
default:other::r-x

[1mEXIT STATUS[0m
This program returns 0 if the operation was successful or >0 if the
operation failed.

[1mSEE ALSO[0m
[1mCastor_limits(4)[22m, [1mdpns_chmod(3)[22m, [1mdpns_chown(3)[0m

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

DPNS $Date: 2005/03/02 08:32:12 $ DPNS-GETACL(1)

Info