DITTO(8)

NAME
ditto - copy source directories to destination directory

SYNOPSIS
ditto [ -v ] [ -V ] [ -arch archVal ] [ -bom bomFile ] src [ ... src ] dst

DESCRIPTION
Ditto copies one or more source directories to a destination directory. If the destination directory does not exist it will be created before the first source directory is copied. If the destination directory already exists then the source directories are merged with the previous contents of the destination.

Ditto overwrites existing files, symbolic links, and devices in the destination when these are copied from a source. The resulting files, links, and devices will have the same mode, owner, and group as the source items from which they are copied. On the other, ditto does not modify the mode, owner, or group of existing directories in the destination.

Ditto can be used to "thin" multi-architecture binaries during a copy. Ditto can also copy files selectively based on the contents of a BOM ("Bill of Materials") file. Ditto preserves hardlinks present in the source directories and preserves setuid and setgid modes.

OPTIONS

-v  Print a line of output for each source directory copied.

-V  Print a line of output for every file, symbolic link, device, and directory copied.

-arch archVal
    Thin multi-architecture binaries ("fat binaries") to the specified architecture. If multiple -arch options are specified then the resulting destination file will be multi-architectural containing each of the specified architectures (if they are present in the source file). archVal should be specified as "m68k", "ppc", "i386", "hppa", or "sparc".

-bom bomFile
    If this option is given then only files, links, devices, and directories that are present in the specified BOM file are copied.

EXAMPLES

ditto src dst    Copy "src" to "dst"
ditto src-1 ... src-n dst    Copy all of "src-1" ... "src-n" to "dst"
ditto -arch m68k src dst    Thin all fat files to Motorola 68000 architecture during copy
ditto -bom Foo.bom src dst    Copy only those files that occur in Foo.bom

SEE ALSO
bom(5), lsbom(8), mkbom(8)

DIAGNOSTICS
Ditto returns 0 if a copy finishes successfully, otherwise non-zero.

BUGS
Ditto currently requires that you must be logged in as root to run it.