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", "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 dstCopy "src" to "dst"
ditto src-1 ... src-n dstCopy all of "src-1" ... "src-n" to "dst"
ditto -arch m68k src dstThin all fat files to Motorola 68000 architecture during copy
ditto -bom Foo.bom src dstCopy 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. 

NeXT Computer, Inc.  —  August 26, 1994