TrueCloudLab/rclone
16
0
Fork 2
Code Issues 1 Pull requests 1 Projects Releases Packages Wiki Activity Actions
rclone/docs/content/commands/rclone_copy.md

98 lines
2.9 KiB
Markdown
Raw Normal View History

Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
---
title: "rclone copy"
Version v1.54.0
2021-02-02 13:42:35 +00:00
description: "Copy files from source to dest, skipping already copied."
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
slug: rclone_copy
url: /commands/rclone_copy/
gendocs: add autogenerated header to all docs
2020-02-10 12:31:45 +00:00
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/copy/ and as part of making a release run "make commanddocs"
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
---
docs: make command docs titles be one higher
2020-05-22 10:17:37 +00:00
# rclone copy
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
Version v1.54.0
2021-02-02 13:42:35 +00:00
Copy files from source to dest, skipping already copied.
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
docs: make command docs titles be one higher
2020-05-22 10:17:37 +00:00
## Synopsis
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
Copy the source to the destination. Doesn't transfer
unchanged files, testing by size and modification time or
MD5SUM. Doesn't delete files from the destination.
docs: note that destination is always a directory (#5766)
2021-10-29 22:30:00 +00:00
Note that when the source is a directory, it is always the contents
of the directory that is copied, not the directory itself.
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
docs: note that destination is always a directory (#5766)
2021-10-29 22:30:00 +00:00
For example, given the following command:
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
rclone copy source:sourcepath dest:destpath
docs: note that destination is always a directory (#5766)
2021-10-29 22:30:00 +00:00
Let's say there are two files in source:
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
sourcepath/one.txt
sourcepath/two.txt
docs: note that destination is always a directory (#5766)
2021-10-29 22:30:00 +00:00
The command will copy them to:
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
destpath/one.txt
destpath/two.txt
docs: note that destination is always a directory (#5766)
2021-10-29 22:30:00 +00:00
Not to:
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
destpath/sourcepath/one.txt
destpath/sourcepath/two.txt
docs: note that destination is always a directory (#5766)
2021-10-29 22:30:00 +00:00
Also note that the destination is always a directory. If the path
does not exist, it will be created as a directory and the contents of
the source will be copied into it. This is the case even if the source
path points to a file. If you want to copy a single file to a different
name you must use [copyto](commands/rclone_copyto/) instead.
For example, given the command:
rclone copy source:sourcepath/one.txt dest:destpath/one.txt
Rclone will create a directory `dest:destpath/one.txt` and put the source file in there:
dest:destpath/one.txt/one.txt
Not copy the single source file as a file with the given destination path,
which would be the result if copyto had been used instead:
dest:destpath/one.txt
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
If you are familiar with `rsync`, rclone always works as if you had
Version v1.54.0
2021-02-02 13:42:35 +00:00
written a trailing `/` - meaning "copy the contents of this directory".
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
This applies to all commands and whether you are talking about the
source or destination.
Version v1.46
2019-02-09 10:42:57 +00:00
See the [--no-traverse](/docs/#no-traverse) option for controlling
whether rclone lists the destination directory or not. Supplying this
option when copying a small number of files into a large destination
can speed transfers up greatly.
For example, if you have many files in /path/to/src but only a few of
docs: add description to commands and index page
2020-05-16 14:11:55 +00:00
them change every day, you can copy all the files which have changed
recently very efficiently like this:
Version v1.46
2019-02-09 10:42:57 +00:00
rclone copy --max-age 24h --no-traverse /path/to/src remote:
Version v1.53.0
2020-09-02 15:59:04 +00:00
**Note**: Use the `-P`/`--progress` flag to view real-time transfer statistics.
**Note**: Use the `--dry-run` or the `--interactive`/`-i` flag to test without copying anything.
Version v1.45
2018-11-24 13:44:25 +00:00
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
```
Version v1.38
2017-09-30 13:19:47 +00:00
rclone copy source:path dest:path [flags]
```
docs: make command docs titles be one higher
2020-05-22 10:17:37 +00:00
## Options
Version v1.38
2017-09-30 13:19:47 +00:00
```
Version v1.47.0
2019-04-13 10:01:58 +00:00
--create-empty-src-dirs Create empty source dirs on destination after copy
-h, --help help for copy
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
```
docs: add a new page with global flags and link to it from the command docs In f544234 we removed the global flags from each command as it was making each page very big and causing 1000s of lines of duplication in the man page. This change adds a new flags page with all the global flags on and links each command page to it. Fixes #3273
2019-06-20 15:18:02 +00:00
See the [global flags page](/flags/) for global options not listed here.
docs: make command docs titles be one higher
2020-05-22 10:17:37 +00:00
## SEE ALSO
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md
2016-08-03 20:36:28 +00:00
Version v1.44
2018-10-15 10:03:08 +00:00
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.
Version v1.40
2018-03-19 10:06:13 +00:00
Reference in a new issue Copy permalink