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

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.

SEE ALSO

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

AUTHOR

       LCG Grid Deployment Team

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