ditto <source...> <dest>

Copy directory hierarchies, create and extract archives

Arguments

NameDescription
sourcefilepaths, folders
destfolders

Options

NameDescription
--helpShow help for ditto
-hPrint full usage
-XWhen copying one or more source directories, do not descend into directories that have a different device ID
-cCreate an archive at the destination path
-zCreate compressed CPIO archives, using gzip(1) compression
-jCreate compressed CPIO archives, using bzip2(1) compression
-vPrint a line of output to stderr for each source directory copied
-VPrint a line of output to stderr for every file, symbolic link, and device copied
-xExtract the archives given as source arguments
-kCreate or extract from a PKZip archive instead of the default CPIO
--keepParentWhen creating an archive, embed the parent directory name src in dst_archive
--arch <arch>
  • Repeatable ♾
--bom <bom>Copy only files, links, devices, and directories that are present in the specified BOM
-rsrcPreserve resource forks and HFS meta-data. ditto will store this data in Carbon-compatible ._ AppleDouble files on filesystems that do not natively support resource forks. As of Mac OS X 10.4, --rsrc is default behavior
--norsrcDo not preserve resource forks and HFS meta-data. If both --norsrc and --rsrc are passed, whichever is passed last will take precedence. Both options override DITTONORSRC. Unless explicitly specified, --norsrc also implies --noextattr and --noacl to match the behavior of Mac OS X 10.4
--extattrPreserve extended attributes (requires --rsrc). As of Mac OS X 10.5, --extattr is the default
--noextattrDo not preserve extended attributes (requires --norsrc)
--qtnPreserve quarantine information. As of Mac OS X 10.5, --qtn is the default
--noqtnDo not preserve quarantine information
--aclPreserve Access Control Lists (ACLs). As of Mac OS X 10.5, --acl is the default
--noaclDo not preserve ACLs
--nocacheDo not perform copies using the Mac OS X Unified Buffer Cache. Files read and written will not be cached, although if the file is already present in the cache, the cached information will be used
--hfsCompressionWhen copying files or extracting content from an archive, if the destination is an HFS+ volume that supports compression, all the content will be compressed if appropriate. This is only supported on Mac OS X 10.6 or later, and is only intended to be used in installation and backup scenarios that involve system files. Since files using HFS+ compression are not readable on versions of Mac OS X earlier than 10.6, this flag should not be used when dealing with non-system files or other user-generated content that will be used on a version of Mac OS X earlier than 10.6
--nohfsCompressionDo not compress files with HFS+ compression when copying or extracting content from an archive unless the content is already compressed with HFS+ compression. This flag is only supported on Mac OS X 10.6 or later. --nohfsCompression is the default
--preserveHFSCompressionWhen copying files to an HFS+ volume that supports compression, ditto will preserve the compression of any source files that were using HFS+ compression. This flag is only supported on Mac OS X 10.6 or later. --preserveHFSCompression is the default
--nopreserveHFSCompressionDo not preserve HFS+ compression when copying files that are already compressed with HFS+ compression. This is only supported on Mac OS X 10.6 or later
--sequesterRsrcWhen creating a PKZip archive, preserve resource forks and HFS meta-data in the subdirectory __MACOSX. PKZip extraction will automatically find these resources
--zlibCompressionLevel <compression level>Sets the compression level to use when creating a PKZip archive. The compression level can be set from 0 to 9, where 0 represents no compression, and 9 represents optimal (slowest) compression. By default, ditto will use the default compression level as defined by zlib
--passwordWhen extracting a password-encrypted ZIP archive, you must specify --password to allow ditto to prompt for a password to use to extract the contents of the file. If this option is not provided, and a password-encrypted file is encountered, ditto will emit an error message