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  destina-
       tion  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 architec-
                           ture. If multiple  -arch  options  are
                           specified  then the resulting destina-
                           tion 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.

       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.