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)