doppel copies files or directories to a destination (a file, directory, or archive). Think of it as the offspring of install(1) and tar(1).
doppel [OPTION]... SOURCE... DEST
To copy files or directories, just list the sources as arguments followed by
the destination: doppel src1 src2 dst
. By default, if only one source is
specified, it is copied onto the destination; if multiple sources are
specified, they are copied into the destination. This default can be
explicitly specified with -o/--onto
or -i/--into
, respectively.
If the destination requires administrator access to write to, doppel will try to
detect this an automatically provide a sudo
(or equivalent) prompt before
copying.
Note: Unlike install(1), doppel copies relative symlinks as symlinks by
default. To adjust this behavior, you can use the --symlink
option, described
below.
Change to directory DIR
before resolving paths of source files.
Set the format of the output archive; one of: tar
, gzip
, bzip2
, or zip
.
If this option is specified, --into
is implied. If not set, source files will
be copied normally, and no archive will be created.
Copy sources into directory DEST
.
Set the file permissions to MODE
(an octal) when copying. Note: this has no
effect when --format=zip
.
When copying, use the full name of each source file as specified on the command line instead of just the tail. This behavior is similar to tar(1).
Copy a single source onto file or directory DEST
.
Automatically create parent directories for DEST
as needed.
A prefix to add to the paths of destination files. This only applies when using
--format
.
Recursively copy source directories to the destination.
Before copying, elevate with sudo
(or your platform's equivalent). WHEN
is
one of always
, auto
(the default), or never
. If auto
, doppel will
attempt to determine automatically if sudo
would be needed before performing
the copy.
Copy symlinks as links. WHEN
is one of always
, relative
(the default), or
never
. If relative
, only symlinks with relative targets will be copied as
symlinks; those with absolute targets will be copied as regular files.
Read options from file
and use them when executing.
Display a help message and exit.
Output version information and exit.
This project is licensed under the BSD 3-clause license.