github.com/10XDev/rclone@v1.52.3-0.20200626220027-16af9ab76b2a/docs/content/commands/rclone_copy.md (about)

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