CPACL(1)                        Domain/OS BSD                         CPACL(1)



NAME
     cpacl - copy access control list

SYNOPSIS
     cpacl [ -odfitvLR ] source destinations ...

DESCRIPTION
     cpacl copies access control lists (ACLs).  If you do not specify an
     option, cpacl assumes -o.

     The first argument specifies the object from which to copy the ACL.  This
     ACL is then applied to the remaining files and directories as specified.
     Since only directories have fields specifying ACL inheritance, use of the
     -d, -f, and -i options requires that the source object be a directory.
     The destinations can be anything, and the appropriate set of fields are
     applied (see below).

OPTIONS
     -o   Copies the object ACL associated with source to each of
          destinations.  This is the default if you do not specify an option.

     -d   Copies the initial directory ACL associated with the specified
          directory to all destinations that are directories.

     -f   Copies the initial file ACL associated with the specified directory
          to all destinations that  are directories.

     -i   Copies an initial default ACL onto an object ACL.  The source must
          be a directory; destinations that  are files receive the initial
          file ACL of the source, and directories w receive the initial
          directory ACL of the source.  If you use -i  in combination with the
          -d or -f options, cpacl copies the initial directory or initial file
          ACL in the usual way.

     -t   Uses the object ACL of the source as a template for the initial file
          or directory ACL of the destination.  If the source is a file,cpacl
          copies its ACL to the initial file ACL of any directories.  If the
          source is a directory, cpacl copies its ACL only to the initial
          directory ACL of target directories.

     -v   Produce verbose output; that is, show the name of each target as an
          ACL is copied to it.

     -L   Directs cpacl to follow any soft links encountered, and operate on
          the object to which the link points.  Since soft links in Domain/OS
          do not have ACLs, attempting to copy to or from a soft link without
          the -L flag produces just a warning, with no change.

     -R   Recursively descends any directories encountered among the
          destination objects.  Be very careful when you combine this option
          with the -L option!

EXAMPLES
     To copy the ACL on foo to objects bar and zap, enter the following:

          cpacl foo bar zap

     To copy the ACL, initial directory ACL, and initial file ACL on the
     /usr/u/fred directory to all objects in the current directory (files will
     have only the object ACL applied), enter the following:

          cpacl -odf /usr/u/fred *

     To copy the initial file ACL on fred to all files in that directory, and
     the initial directory ACL on fred to all sub-directories (also, copy the
     initial file and directory ACLs to the initial file and directory ACLs of
     any subdirectories), enter the following:

          cpacl -idf /usr/u/fred /usr/u/fred/*

     To copy the object ACL on file-template to the initial file ACL of the
     current directory, enter the following:

          cpacl -t /usr/u/fred/file-template

     To copy the object ACL on dir-template to the initial directory acl of
     the current directory, enter the following:

          cpacl -t /usr/u/fred/dir-template

SEE ALSO
     cp(1), chacl(1), lsacl(1), dbacl(1), chmod(1), chgrp(1), chorg(1),
     chown(8), acl(7), umask(2), salacl(8)