diff --git a/cmd/copy/copy.go b/cmd/copy/copy.go index 6bc8c07f7..6c3a9e7cf 100644 --- a/cmd/copy/copy.go +++ b/cmd/copy/copy.go @@ -71,7 +71,9 @@ recently very efficiently like this: rclone copy --max-age 24h --no-traverse /path/to/src remote: -**Note**: Use the ` + "`-P`" + `/` + "`--progress`" + ` flag to view real-time transfer statistics +**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. `, Run: func(command *cobra.Command, args []string) { cmd.CheckArgs(2, 2, command, args) diff --git a/cmd/dedupe/dedupe.go b/cmd/dedupe/dedupe.go index a9aacb4cf..68b52fdeb 100644 --- a/cmd/dedupe/dedupe.go +++ b/cmd/dedupe/dedupe.go @@ -34,8 +34,10 @@ merged. The ` + "`" + `dedupe` + "`" + ` command will delete all but one of any identical (same md5sum) files it finds without confirmation. This means that for most -duplicated files the ` + "`" + `dedupe` + "`" + ` command will not be interactive. You -can use ` + "`" + `--dry-run` + "`" + ` to see what would happen without doing anything. +duplicated files the ` + "`" + `dedupe` + "`" + ` command will not be interactive. + +**Important**: Since this can cause data loss, test first with the +` + "`--dry-run` or the `--interactive`/`-i`" + ` flag. Here is an example run. diff --git a/cmd/delete/delete.go b/cmd/delete/delete.go index bf3c0fa81..4f73709fe 100644 --- a/cmd/delete/delete.go +++ b/cmd/delete/delete.go @@ -45,6 +45,9 @@ Then delete That reads "delete everything with a minimum size of 100 MB", hence delete all files bigger than 100MBytes. + +**Important**: Since this can cause data loss, test first with the +` + "`--dry-run` or the `--interactive`/`-i`" + ` flag. `, Run: func(command *cobra.Command, args []string) { cmd.CheckArgs(1, 1, command, args) diff --git a/cmd/move/move.go b/cmd/move/move.go index 66dbf9a7b..695baaaf3 100644 --- a/cmd/move/move.go +++ b/cmd/move/move.go @@ -49,7 +49,7 @@ option when moving a small number of files into a large destination can speed transfers up greatly. **Important**: Since this can cause data loss, test first with the ---dry-run flag. +` + "`--dry-run` or the `--interactive`/`-i`" + ` flag. **Note**: Use the ` + "`-P`" + `/` + "`--progress`" + ` flag to view real-time transfer statistics. `, diff --git a/cmd/moveto/moveto.go b/cmd/moveto/moveto.go index d5f0f336e..d571e96f2 100644 --- a/cmd/moveto/moveto.go +++ b/cmd/moveto/moveto.go @@ -44,7 +44,7 @@ modification time or MD5SUM. src will be deleted on successful transfer. **Important**: Since this can cause data loss, test first with the ---dry-run flag. +` + "`--dry-run` or the `--interactive`/`-i`" + ` flag. **Note**: Use the ` + "`-P`" + `/` + "`--progress`" + ` flag to view real-time transfer statistics. `, diff --git a/cmd/purge/purge.go b/cmd/purge/purge.go index c62955031..1953ee4eb 100644 --- a/cmd/purge/purge.go +++ b/cmd/purge/purge.go @@ -19,6 +19,9 @@ var commandDefinition = &cobra.Command{ Remove the path and all of its contents. Note that this does not obey include/exclude filters - everything will be removed. Use ` + "`" + `delete` + "`" + ` if you want to selectively delete files. + +**Important**: Since this can cause data loss, test first with the +` + "`--dry-run` or the `--interactive`/`-i`" + ` flag. `, Run: func(command *cobra.Command, args []string) { cmd.CheckArgs(1, 1, command, args) diff --git a/cmd/sync/sync.go b/cmd/sync/sync.go index feb593be1..9ea97f4c9 100644 --- a/cmd/sync/sync.go +++ b/cmd/sync/sync.go @@ -30,7 +30,9 @@ modification time or MD5SUM. Destination is updated to match source, including deleting files if necessary. **Important**: Since this can cause data loss, test first with the -` + "`" + `--dry-run` + "`" + ` flag to see exactly what would be copied and deleted. +` + "`--dry-run` or the `--interactive`/`-i`" + ` flag. + + rclone sync -i SOURCE remote:DESTINATION Note that files in the destination won't be deleted if there were any errors at any point. diff --git a/docs/content/azureblob.md b/docs/content/azureblob.md index 28a032473..c15c07034 100644 --- a/docs/content/azureblob.md +++ b/docs/content/azureblob.md @@ -65,7 +65,7 @@ List the contents of a container Sync `/home/local/directory` to the remote container, deleting any excess files in the container. - rclone sync /home/local/directory remote:container + rclone sync -i /home/local/directory remote:container ### --fast-list ### diff --git a/docs/content/b2.md b/docs/content/b2.md index 3ead0252b..e15e4413e 100644 --- a/docs/content/b2.md +++ b/docs/content/b2.md @@ -70,7 +70,7 @@ List the contents of a bucket Sync `/home/local/directory` to the remote bucket, deleting any excess files in the bucket. - rclone sync /home/local/directory remote:bucket + rclone sync -i /home/local/directory remote:bucket ### Application Keys ### diff --git a/docs/content/chunker.md b/docs/content/chunker.md index e7e657c97..6a80685c9 100644 --- a/docs/content/chunker.md +++ b/docs/content/chunker.md @@ -250,7 +250,7 @@ chunk naming scheme is to: - Create another directory (most probably on the same cloud storage) and configure a new remote with desired metadata format, hash type, chunk naming etc. -- Now run `rclone sync oldchunks: newchunks:` and all your data +- Now run `rclone sync -i oldchunks: newchunks:` and all your data will be transparently converted in transfer. This may take some time, yet chunker will try server-side copy if possible. diff --git a/docs/content/crypt.md b/docs/content/crypt.md index a1b2b7d3b..ffd1f22aa 100644 --- a/docs/content/crypt.md +++ b/docs/content/crypt.md @@ -433,7 +433,7 @@ as `eremote:`. To sync the two remotes you would do - rclone sync remote:crypt remote2:crypt + rclone sync -i remote:crypt remote2:crypt And to check the integrity you would do diff --git a/docs/content/docs.md b/docs/content/docs.md index fae9578fa..1fdd6025b 100644 --- a/docs/content/docs.md +++ b/docs/content/docs.md @@ -83,7 +83,7 @@ rclone uses a system of subcommands. For example rclone ls remote:path # lists a remote rclone copy /local/path remote:path # copies /local/path to the remote - rclone sync /local/path remote:path # syncs /local/path to the remote + rclone sync -i /local/path remote:path # syncs /local/path to the remote The main rclone commands with most used first @@ -249,11 +249,11 @@ file or directory like this then use the full path starting with a So to sync a directory called `sync:me` to a remote called `remote:` use - rclone sync ./sync:me remote:path + rclone sync -i ./sync:me remote:path or - rclone sync /full/path/to/sync:me remote:path + rclone sync -i /full/path/to/sync:me remote:path Server Side Copy ---------------- @@ -286,8 +286,8 @@ same. This can be used when scripting to make aged backups efficiently, eg - rclone sync remote:current-backup remote:previous-backup - rclone sync /path/to/files remote:current-backup + rclone sync -i remote:current-backup remote:previous-backup + rclone sync -i /path/to/files remote:current-backup Options ------- @@ -329,7 +329,7 @@ directory must not overlap the destination directory. For example - rclone sync /path/to/local remote:current --backup-dir remote:old + rclone sync -i /path/to/local remote:current --backup-dir remote:old will sync `/path/to/local` to `remote:current`, but for any files which would have been updated or deleted will be stored in @@ -604,7 +604,7 @@ Add an HTTP header for all download transactions. The flag can be repeated to add multiple headers. ``` -rclone sync s3:test/src ~/dst --header-download "X-Amz-Meta-Test: Foo" --header-download "X-Amz-Meta-Test2: Bar" +rclone sync -i s3:test/src ~/dst --header-download "X-Amz-Meta-Test: Foo" --header-download "X-Amz-Meta-Test2: Bar" ``` See the GitHub issue [here](https://github.com/rclone/rclone/issues/59) for @@ -616,7 +616,7 @@ Add an HTTP header for all upload transactions. The flag can be repeated to add multiple headers. ``` -rclone sync ~/src s3:test/dst --header-upload "Content-Disposition: attachment; filename='cool.html'" --header-upload "X-Amz-Meta-Test: FooBar" +rclone sync -i ~/src s3:test/dst --header-upload "Content-Disposition: attachment; filename='cool.html'" --header-upload "X-Amz-Meta-Test: FooBar" ``` See the GitHub issue [here](https://github.com/rclone/rclone/issues/59) for @@ -1197,7 +1197,7 @@ or with `--backup-dir`. See `--backup-dir` for more info. For example - rclone sync /path/to/local/file remote:current --suffix .bak + rclone sync -i /path/to/local/file remote:current --suffix .bak will sync `/path/to/local` to `remote:current`, but for any files which would have been updated or deleted have .bak added. diff --git a/docs/content/faq.md b/docs/content/faq.md index b62e1c6c0..2af1b3020 100644 --- a/docs/content/faq.md +++ b/docs/content/faq.md @@ -34,7 +34,7 @@ The syncs would be incremental (on a file by file basis). Eg - rclone sync drive:Folder s3:bucket + rclone sync -i drive:Folder s3:bucket ### Using rclone from multiple locations at the same time ### @@ -43,8 +43,8 @@ You can use rclone from multiple places at the same time if you choose different subdirectory for the output, eg ``` -Server A> rclone sync /tmp/whatever remote:ServerA -Server B> rclone sync /tmp/whatever remote:ServerB +Server A> rclone sync -i /tmp/whatever remote:ServerA +Server B> rclone sync -i /tmp/whatever remote:ServerB ``` If you sync to the same directory then you should use rclone copy diff --git a/docs/content/filtering.md b/docs/content/filtering.md index 01fc179d8..d21ccb6cf 100644 --- a/docs/content/filtering.md +++ b/docs/content/filtering.md @@ -452,7 +452,7 @@ from the sync on the destination. If for example you did a sync from `A` to `B` without the `--min-size 50k` flag - rclone sync A: B: + rclone sync -i A: B: Then you repeated it like this with the `--delete-excluded` @@ -510,7 +510,7 @@ Imagine, you have the following directory structure: You can exclude `dir3` from sync by running the following command: - rclone sync --exclude-if-present .ignore dir1 remote:backup + rclone sync -i --exclude-if-present .ignore dir1 remote:backup Currently only one filename is supported, i.e. `--exclude-if-present` should not be used multiple times. diff --git a/docs/content/ftp.md b/docs/content/ftp.md index f55abfadf..0e5b23a60 100644 --- a/docs/content/ftp.md +++ b/docs/content/ftp.md @@ -91,7 +91,7 @@ List the contents of a directory Sync `/home/local/directory` to the remote directory, deleting any excess files in the directory. - rclone sync /home/local/directory remote:directory + rclone sync -i /home/local/directory remote:directory ### Modified time ### diff --git a/docs/content/googlecloudstorage.md b/docs/content/googlecloudstorage.md index 584d45b86..9f5edb5a6 100644 --- a/docs/content/googlecloudstorage.md +++ b/docs/content/googlecloudstorage.md @@ -165,7 +165,7 @@ List the contents of a bucket Sync `/home/local/directory` to the remote bucket, deleting any excess files in the bucket. - rclone sync /home/local/directory remote:bucket + rclone sync -i /home/local/directory remote:bucket ### Service Account support ### diff --git a/docs/content/googlephotos.md b/docs/content/googlephotos.md index 4c94a3fb8..51def918a 100644 --- a/docs/content/googlephotos.md +++ b/docs/content/googlephotos.md @@ -112,7 +112,7 @@ List the contents of an album Sync `/home/local/images` to the Google Photos, removing any excess files in the album. - rclone sync /home/local/image remote:album/newAlbum + rclone sync -i /home/local/image remote:album/newAlbum ## Layout diff --git a/docs/content/http.md b/docs/content/http.md index 0c73481ea..3ecb26e9a 100644 --- a/docs/content/http.md +++ b/docs/content/http.md @@ -78,7 +78,7 @@ List the contents of a directory Sync the remote `directory` to `/home/local/directory`, deleting any excess files. - rclone sync remote:directory /home/local/directory + rclone sync -i remote:directory /home/local/directory ### Read only ### diff --git a/docs/content/local.md b/docs/content/local.md index a58cd085e..c0da9a961 100644 --- a/docs/content/local.md +++ b/docs/content/local.md @@ -8,7 +8,7 @@ description: "Rclone docs for the local filesystem" Local paths are specified as normal filesystem paths, eg `/path/to/wherever`, so - rclone sync /home/source /tmp/destination + rclone sync -i /home/source /tmp/destination Will sync `/home/source` to `/tmp/destination` diff --git a/docs/content/mailru.md b/docs/content/mailru.md index 630c79cd1..ba9577301 100644 --- a/docs/content/mailru.md +++ b/docs/content/mailru.md @@ -106,7 +106,7 @@ List the contents of a directory Sync `/home/local/directory` to the remote path, deleting any excess files in the path. - rclone sync /home/local/directory remote:directory + rclone sync -i /home/local/directory remote:directory ### Modified time ### diff --git a/docs/content/qingstor.md b/docs/content/qingstor.md index 83825b0fa..87140a951 100644 --- a/docs/content/qingstor.md +++ b/docs/content/qingstor.md @@ -90,7 +90,7 @@ List the contents of a bucket Sync `/home/local/directory` to the remote bucket, deleting any excess files in the bucket. - rclone sync /home/local/directory remote:bucket + rclone sync -i /home/local/directory remote:bucket ### --fast-list ### diff --git a/docs/content/s3.md b/docs/content/s3.md index d3b3ddb21..25d26e363 100644 --- a/docs/content/s3.md +++ b/docs/content/s3.md @@ -42,7 +42,7 @@ List the contents of a bucket Sync `/home/local/directory` to the remote bucket, deleting any excess files in the bucket. - rclone sync /home/local/directory remote:bucket + rclone sync -i /home/local/directory remote:bucket ## AWS S3 {#amazon-s3} diff --git a/docs/content/seafile.md b/docs/content/seafile.md index 2c9852b59..b8fefadf0 100644 --- a/docs/content/seafile.md +++ b/docs/content/seafile.md @@ -112,7 +112,7 @@ List the contents of a library Sync `/home/local/directory` to the remote library, deleting any excess files in the library. - rclone sync /home/local/directory seafile:library + rclone sync -i /home/local/directory seafile:library ### Configuration in library mode ### @@ -208,7 +208,7 @@ List the contents of a directory Sync `/home/local/directory` to the remote library, deleting any excess files in the library. - rclone sync /home/local/directory seafile: + rclone sync -i /home/local/directory seafile: ### --fast-list ### diff --git a/docs/content/sftp.md b/docs/content/sftp.md index 3c7cc2d80..ddee387fb 100644 --- a/docs/content/sftp.md +++ b/docs/content/sftp.md @@ -95,7 +95,7 @@ List the contents of a directory Sync `/home/local/directory` to the remote directory, deleting any excess files in the directory. - rclone sync /home/local/directory remote:directory + rclone sync -i /home/local/directory remote:directory ### SSH Authentication ### @@ -302,11 +302,11 @@ different. This issue affects among others Synology NAS boxes. Shared folders can be found in directories representing volumes - rclone sync /home/local/directory remote:/directory --ssh-path-override /volume2/directory + rclone sync -i /home/local/directory remote:/directory --ssh-path-override /volume2/directory Home directory can be found in a shared folder called "home" - rclone sync /home/local/directory remote:/home/directory --ssh-path-override /volume1/homes/USER/directory + rclone sync -i /home/local/directory remote:/home/directory --ssh-path-override /volume1/homes/USER/directory - Config: path_override - Env Var: RCLONE_SFTP_PATH_OVERRIDE diff --git a/docs/content/swift.md b/docs/content/swift.md index 4b35b8d68..491b78a68 100644 --- a/docs/content/swift.md +++ b/docs/content/swift.md @@ -132,7 +132,7 @@ List the contents of a container Sync `/home/local/directory` to the remote container, deleting any excess files in the container. - rclone sync /home/local/directory remote:container + rclone sync -i /home/local/directory remote:container ### Configuration from an OpenStack credentials file ### diff --git a/docs/content/tardigrade.md b/docs/content/tardigrade.md index c299f4c2e..aaeac2b51 100644 --- a/docs/content/tardigrade.md +++ b/docs/content/tardigrade.md @@ -217,7 +217,7 @@ Use the `size` command to print the total size of objects in a bucket or a folde Use the `sync` command to sync the source to the destination, changing the destination only, deleting any excess files. - rclone sync --progress /home/local/directory/ remote:bucket/path/to/dir/ + rclone sync -i --progress /home/local/directory/ remote:bucket/path/to/dir/ The `--progress` flag is for displaying progress information. Remove it if you don't need this information. @@ -227,15 +227,15 @@ to see exactly what would be copied and deleted. The sync can be done also from Tardigrade to the local file system. - rclone sync --progress remote:bucket/path/to/dir/ /home/local/directory/ + rclone sync -i --progress remote:bucket/path/to/dir/ /home/local/directory/ Or between two Tardigrade buckets. - rclone sync --progress remote-us:bucket/path/to/dir/ remote-europe:bucket/path/to/dir/ + rclone sync -i --progress remote-us:bucket/path/to/dir/ remote-europe:bucket/path/to/dir/ Or even between another cloud storage and Tardigrade. - rclone sync --progress s3:bucket/path/to/dir/ tardigrade:bucket/path/to/dir/ + rclone sync -i --progress s3:bucket/path/to/dir/ tardigrade:bucket/path/to/dir/ {{< rem autogenerated options start" - DO NOT EDIT - instead edit fs.RegInfo in backend/tardigrade/tardigrade.go then run make backenddocs" >}} ### Standard Options diff --git a/docs/content/yandex.md b/docs/content/yandex.md index cf96a3927..90c32520c 100644 --- a/docs/content/yandex.md +++ b/docs/content/yandex.md @@ -80,7 +80,7 @@ List the contents of a directory Sync `/home/local/directory` to the remote path, deleting any excess files in the path. - rclone sync /home/local/directory remote:directory + rclone sync -i /home/local/directory remote:directory Yandex paths may be as deep as required, eg `remote:directory/subdirectory`.