This manual page is part of Xcode Tools version 3.2.2

To obtain these tools:

If you are running a version of Xcode Tools other than 3.2.2, view the documentation locally:

  • In Xcode

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • For more information about the manual page format, see the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Reference Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.


CPMAC(1)                                 BSD General Commands Manual                                CPMAC(1)

NAME
     /usr/bin/CpMac -- copy files preserving metadata and forks

SYNOPSIS
     /usr/bin/CpMac [-rp] [-mac] source target
     /usr/bin/CpMac [-rp] [-mac] source ... directory

DESCRIPTION
     In its first form, the /usr/bin/CpMac utility copies the contents of the file named by the source oper-and operand
     and to the destination path named by the target operand.  This form is assumed when the last operand
     does not name an already existing directory.

     In its second form, /usr/bin/CpMac copies each file named by a source operand to a destination direc-tory directory
     tory named by the directory operand.  The destination path for each operand is the pathname produced by
     the concatenation of the last operand, a slash, and the final pathname component of the named file.

     The following options are available:

     -r    If source designates a directory, /usr/bin/CpMac copies the directory and the entire subtree con-nected connected
           nected at that point.  This option also causes symbolic links to be copied, rather than indi-rected indirected
           rected through, and for /usr/bin/CpMac to create special files rather than copying them as normal
           files.  Created directories have the same mode as the corresponding source directory, unmodified
           by the process' umask.

     -p    Causes /usr/bin/CpMac to preserve in the copy as many of the modification time, access time, file
           flags, file mode, user ID, and group ID as allowed by permissions.

     -mac  Allows use of HFS-style paths for both source and target.  Path elements must be separated by
           colons, and the path must begin with a volume name or a colon (to designate current directory).

NOTES
     The /usr/bin/CpMac command does not support the same options as the POSIX cp command, and is much less
     flexible in its operands.  It cannot be used as a direct substitute for cp in scripts.

     As of Mac OS X 10.4, the cp command preserves metadata and resource forks of files on Extended HFS vol-umes, volumes,
     umes, so it can be used in place of CpMac.  The /usr/bin/CpMac command will be deprecated in future
     versions of Mac OS X.

SEE ALSO
     cp(1) MvMac(1)

Mac OS X                                       April 12, 2004                                       Mac OS X

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Did this document help you? Yes It's good, but... Not helpful...