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

151 lines
8 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 move"
docs: add description to commands and index page
2020-05-16 14:11:55 +00:00
description: "Move files from source to dest."
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_move
url: /commands/rclone_move/
docs: update command docs to new style
2023-08-02 09:02:38 +00:00
groups: Filter,Listing,Important,Copy
Version v1.61.0
2022-12-20 17:16:14 +00:00
versionIntroduced: v1.19
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/move/ 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 move
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
Move files from source to dest.
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
Moves the contents of the source directory to the destination
Version v1.35
2017-01-02 15:30:34 +00:00
directory. Rclone will error if the source and destination overlap and
Version v1.54.0
2021-02-02 13:42:35 +00:00
the remote does not support a server-side directory move operation.
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.59.0
2022-07-09 17:08:20 +00:00
To move single files, use the [moveto](/commands/rclone_moveto/)
command instead.
Version v1.54.0
2021-02-02 13:42:35 +00:00
If no filters are in use and if possible this will server-side move
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
`source:path` into `dest:path`. After this `source:path` will no
docs: make command docs titles be one higher
2020-05-22 10:17:37 +00:00
longer exist.
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
Otherwise for each file in `source:path` selected by the filters (if
Version v1.54.0
2021-02-02 13:42:35 +00:00
any) this will move it into `dest:path`. If possible a server-side
move will be used, otherwise it will copy it (server-side if possible)
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
into `dest:path` then delete the original (if no errors on copy) in
`source:path`.
Version v1.59.0
2022-07-09 17:08:20 +00:00
If you want to delete empty source directories after move, use the
`--delete-empty-src-dirs` flag.
move: add --delete-empty-src-dirs flag - fixes #1854
2017-11-27 11:42:02 +00:00
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 moving a small number of files into a large destination
can speed transfers up greatly.
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
**Important**: Since this can cause data loss, test first with the
Version v1.53.0
2020-09-02 15:59:04 +00:00
`--dry-run` or the `--interactive`/`-i` flag.
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.45
2018-11-24 13:44:25 +00:00
**Note**: Use the `-P`/`--progress` flag to view real-time transfer statistics.
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 move 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 move
Version v1.39
2017-12-23 13:07:45 +00:00
--delete-empty-src-dirs Delete empty source dirs after move
-h, --help help for move
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: update command docs to new style
2023-08-02 09:02:38 +00:00
## Copy Options
Flags for anything which can Copy a file.
```
--check-first Do all the checks before starting transfers
-c, --checksum Skip based on checksum (if available) & size, not mod-time & size
--compare-dest stringArray Include additional comma separated server-side paths during comparison
--copy-dest stringArray Implies --compare-dest but also copies files from paths into destination
--cutoff-mode string Mode to stop transfers when reaching the max transfer limit HARD|SOFT|CAUTIOUS (default "HARD")
--ignore-case-sync Ignore case when synchronizing
--ignore-checksum Skip post copy check of checksums
--ignore-existing Skip all files that exist on destination
--ignore-size Ignore size when skipping use mod-time or checksum
-I, --ignore-times Don't skip files that match size and time - transfer all files
--immutable Do not modify files, fail if existing files have been modified
--inplace Download directly to destination file instead of atomic download to temp/rename
--max-backlog int Maximum number of objects in sync or check backlog (default 10000)
--max-duration Duration Maximum duration rclone will transfer data for (default 0s)
--max-transfer SizeSuffix Maximum size of data to transfer (default off)
-M, --metadata If set, preserve metadata when copying objects
--modify-window Duration Max time diff to be considered the same (default 1ns)
--multi-thread-cutoff SizeSuffix Use multi-thread downloads for files above this size (default 250Mi)
--multi-thread-streams int Max number of streams to use for multi-thread downloads (default 4)
--multi-thread-write-buffer-size SizeSuffix In memory buffer size for writing when in multi-thread mode (default 128Ki)
--no-check-dest Don't check the destination, copy regardless
--no-traverse Don't traverse destination file system on copy
--no-update-modtime Don't update destination mod-time if files identical
--order-by string Instructions on how to order the transfers, e.g. 'size,descending'
--refresh-times Refresh the modtime of remote files
--server-side-across-configs Allow server-side operations (e.g. copy) to work across different configs
--size-only Skip based on size only, not mod-time or checksum
--streaming-upload-cutoff SizeSuffix Cutoff for switching to chunked upload if file size is unknown, upload starts after reaching cutoff or when file ends (default 100Ki)
-u, --update Skip files that are newer on the destination
```
## Important Options
Important flags useful for most commands.
```
-n, --dry-run Do a trial run with no permanent changes
-i, --interactive Enable interactive mode
-v, --verbose count Print lots more stuff (repeat for more)
```
## Filter Options
Flags for filtering directory listings.
```
--delete-excluded Delete files on dest excluded from sync
--exclude stringArray Exclude files matching pattern
--exclude-from stringArray Read file exclude patterns from file (use - to read from stdin)
--exclude-if-present stringArray Exclude directories if filename is present
--files-from stringArray Read list of source-file names from file (use - to read from stdin)
--files-from-raw stringArray Read list of source-file names from file without any processing of lines (use - to read from stdin)
-f, --filter stringArray Add a file filtering rule
--filter-from stringArray Read file filtering patterns from a file (use - to read from stdin)
--ignore-case Ignore case in filters (case insensitive)
--include stringArray Include files matching pattern
--include-from stringArray Read file include patterns from file (use - to read from stdin)
--max-age Duration Only transfer files younger than this in s or suffix ms|s|m|h|d|w|M|y (default off)
--max-depth int If set limits the recursion depth to this (default -1)
--max-size SizeSuffix Only transfer files smaller than this in KiB or suffix B|K|M|G|T|P (default off)
--metadata-exclude stringArray Exclude metadatas matching pattern
--metadata-exclude-from stringArray Read metadata exclude patterns from file (use - to read from stdin)
--metadata-filter stringArray Add a metadata filtering rule
--metadata-filter-from stringArray Read metadata filtering patterns from a file (use - to read from stdin)
--metadata-include stringArray Include metadatas matching pattern
--metadata-include-from stringArray Read metadata include patterns from file (use - to read from stdin)
--min-age Duration Only transfer files older than this in s or suffix ms|s|m|h|d|w|M|y (default off)
--min-size SizeSuffix Only transfer files bigger than this in KiB or suffix B|K|M|G|T|P (default off)
```
## Listing Options
Flags for listing directories.
```
--default-time Time Time to show if modtime is unknown for files and directories (default 2000-01-01T00:00:00Z)
--fast-list Use recursive list if available; uses more memory but fewer transactions
```
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: update command docs to new style
2023-08-02 09:02:38 +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