dpns-getacl - Online in the Cloud

PROGRAM:

NAME

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

SYNOPSIS

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

DESCRIPTION

dpns-getacl gets the Access Control List associated with a DPNS directory/file. For each
path, it displays the file name, owner, the group, and the Access Control List (ACL) if
present. If a directory has a default ACL, dpns-getacl also 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 umask is 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.

path specifies the DPNS pathname. If path does not start with /, it is prefixed by the
content of the DPNS_HOME environment variable.

uid is displayed as the username if known else as the numeric id.

gid is displayed as the groupname if known else as the numeric id.
perm is expressed as a combination of characters rwx-

OPTIONS

-a only display the access ACL.

-d only display the default ACL.

EXAMPLES

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

EXIT STATUS

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

Use dpns-getacl online using onworks.net services