github.com/ncw/rclone@v1.48.1-0.20190724201158-a35aa1360e3e/docs/content/commands/rclone_copy.md (about)

     1  ---
     2  date: 2019-06-20T16:09:42+01:00
     3  title: "rclone copy"
     4  slug: rclone_copy
     5  url: /commands/rclone_copy/
     6  ---
     7  ## rclone copy
     8  
     9  Copy files from source to dest, skipping already copied
    10  
    11  ### Synopsis
    12  
    13  
    14  Copy the source to the destination.  Doesn't transfer
    15  unchanged files, testing by size and modification time or
    16  MD5SUM.  Doesn't delete files from the destination.
    17  
    18  Note that it is always the contents of the directory that is synced,
    19  not the directory so when source:path is a directory, it's the
    20  contents of source:path that are copied, not the directory name and
    21  contents.
    22  
    23  If dest:path doesn't exist, it is created and the source:path contents
    24  go there.
    25  
    26  For example
    27  
    28      rclone copy source:sourcepath dest:destpath
    29  
    30  Let's say there are two files in sourcepath
    31  
    32      sourcepath/one.txt
    33      sourcepath/two.txt
    34  
    35  This copies them to
    36  
    37      destpath/one.txt
    38      destpath/two.txt
    39  
    40  Not to
    41  
    42      destpath/sourcepath/one.txt
    43      destpath/sourcepath/two.txt
    44  
    45  If you are familiar with `rsync`, rclone always works as if you had
    46  written a trailing / - meaning "copy the contents of this directory".
    47  This applies to all commands and whether you are talking about the
    48  source or destination.
    49  
    50  See the [--no-traverse](/docs/#no-traverse) option for controlling
    51  whether rclone lists the destination directory or not.  Supplying this
    52  option when copying a small number of files into a large destination
    53  can speed transfers up greatly.
    54  
    55  For example, if you have many files in /path/to/src but only a few of
    56  them change every day, you can to copy all the files which have
    57  changed recently very efficiently like this:
    58  
    59      rclone copy --max-age 24h --no-traverse /path/to/src remote:
    60  
    61  **Note**: Use the `-P`/`--progress` flag to view real-time transfer statistics
    62  
    63  
    64  ```
    65  rclone copy source:path dest:path [flags]
    66  ```
    67  
    68  ### Options
    69  
    70  ```
    71        --create-empty-src-dirs   Create empty source dirs on destination after copy
    72    -h, --help                    help for copy
    73  ```
    74  
    75  See the [global flags page](/flags/) for global options not listed here.
    76  
    77  ### SEE ALSO
    78  
    79  * [rclone](/commands/rclone/)	 - Show help for rclone commands, flags and backends.
    80