Man Linux: Main Page and Category List

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