diff --git a/backend/drive/drive.go b/backend/drive/drive.go index 7bd0c41e5..f5ec559f4 100644 --- a/backend/drive/drive.go +++ b/backend/drive/drive.go @@ -3322,9 +3322,9 @@ This takes an optional directory to trash which make this easier to use via the API. rclone backend untrash drive:directory - rclone backend -i untrash drive:directory subdir + rclone backend --interactive untrash drive:directory subdir -Use the -i flag to see what would be restored before restoring it. +Use the --interactive/-i or --dry-run flag to see what would be restored before restoring it. Result: @@ -3354,7 +3354,7 @@ component will be used as the file name. If the destination is a drive backend then server-side copying will be attempted if possible. -Use the -i flag to see what would be copied before copying. +Use the --interactive/-i or --dry-run flag to see what would be copied before copying. `, }, { Name: "exportformats", diff --git a/backend/oracleobjectstorage/command.go b/backend/oracleobjectstorage/command.go index 6e0c7e115..529730971 100644 --- a/backend/oracleobjectstorage/command.go +++ b/backend/oracleobjectstorage/command.go @@ -65,8 +65,8 @@ a bucket or with a bucket and path. Long: `This command removes unfinished multipart uploads of age greater than max-age which defaults to 24 hours. -Note that you can use -i/--dry-run with this command to see what it -would do. +Note that you can use --interactive/-i or --dry-run with this command to see what +it would do. rclone backend cleanup oos:bucket/path/to/object rclone backend cleanup -o max-age=7w oos:bucket/path/to/object diff --git a/backend/s3/s3.go b/backend/s3/s3.go index 872e87498..14bfdbdcd 100644 --- a/backend/s3/s3.go +++ b/backend/s3/s3.go @@ -4103,9 +4103,9 @@ Usage Examples: rclone backend restore s3:bucket/path/to/directory [-o priority=PRIORITY] [-o lifetime=DAYS] rclone backend restore s3:bucket [-o priority=PRIORITY] [-o lifetime=DAYS] -This flag also obeys the filters. Test first with -i/--interactive or --dry-run flags +This flag also obeys the filters. Test first with --interactive/-i or --dry-run flags - rclone -i backend restore --include "*.txt" s3:bucket/path -o priority=Standard + rclone --interactive backend restore --include "*.txt" s3:bucket/path -o priority=Standard All the objects shown will be marked for restore, then @@ -4173,8 +4173,8 @@ a bucket or with a bucket and path. Long: `This command removes unfinished multipart uploads of age greater than max-age which defaults to 24 hours. -Note that you can use -i/--dry-run with this command to see what it -would do. +Note that you can use --interactive/-i or --dry-run with this command to see what +it would do. rclone backend cleanup s3:bucket/path/to/object rclone backend cleanup -o max-age=7w s3:bucket/path/to/object @@ -4190,8 +4190,8 @@ Durations are parsed as per the rest of rclone, 2h, 7d, 7w etc. Long: `This command removes any old hidden versions of files on a versions enabled bucket. -Note that you can use -i/--dry-run with this command to see what it -would do. +Note that you can use --interactive/-i or --dry-run with this command to see what +it would do. rclone backend cleanup-hidden s3:bucket/path/to/dir `, diff --git a/cmd/sync/sync.go b/cmd/sync/sync.go index 33a5b0027..25c3746be 100644 --- a/cmd/sync/sync.go +++ b/cmd/sync/sync.go @@ -36,7 +36,7 @@ want to delete files from destination, use the **Important**: Since this can cause data loss, test first with the ` + "`--dry-run` or the `--interactive`/`-i`" + ` flag. - rclone sync -i SOURCE remote:DESTINATION + rclone sync --interactive SOURCE remote:DESTINATION Note that files in the destination won't be deleted if there were any errors at any point. Duplicate objects (files with the same name, on diff --git a/cmd/touch/touch.go b/cmd/touch/touch.go index 7ec4a0980..5dcf123e3 100644 --- a/cmd/touch/touch.go +++ b/cmd/touch/touch.go @@ -52,7 +52,7 @@ unless ` + "`--no-create`" + ` or ` + "`--recursive`" + ` is provided. If ` + "`--recursive`" + ` is used then recursively sets the modification time on all existing files that is found under the path. Filters are supported, -and you can test with the ` + "`--dry-run`" + ` or the ` + "`--interactive`" + ` flag. +and you can test with the ` + "`--dry-run`" + ` or the ` + "`--interactive`/`-i`" + ` flag. If ` + "`--timestamp`" + ` is used then sets the modification time to that time instead of the current time. Times may be specified as one of: diff --git a/docs/content/azureblob.md b/docs/content/azureblob.md index e1ea77086..9a3440e99 100644 --- a/docs/content/azureblob.md +++ b/docs/content/azureblob.md @@ -67,7 +67,7 @@ List the contents of a container Sync `/home/local/directory` to the remote container, deleting any excess files in the container. - rclone sync -i /home/local/directory remote:container + rclone sync --interactive /home/local/directory remote:container ### --fast-list diff --git a/docs/content/b2.md b/docs/content/b2.md index 0bddeaa01..b5e5552b5 100644 --- a/docs/content/b2.md +++ b/docs/content/b2.md @@ -72,7 +72,7 @@ List the contents of a bucket Sync `/home/local/directory` to the remote bucket, deleting any excess files in the bucket. - rclone sync -i /home/local/directory remote:bucket + rclone sync --interactive /home/local/directory remote:bucket ### Application Keys diff --git a/docs/content/chunker.md b/docs/content/chunker.md index ad4354b60..f9287c89c 100644 --- a/docs/content/chunker.md +++ b/docs/content/chunker.md @@ -257,7 +257,7 @@ style or 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 -i oldchunks: newchunks:` and all your data +- Now run `rclone sync --interactive 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/commands/rclone_sync.md b/docs/content/commands/rclone_sync.md index 173714f21..ef888c492 100644 --- a/docs/content/commands/rclone_sync.md +++ b/docs/content/commands/rclone_sync.md @@ -23,7 +23,7 @@ want to delete files from destination, use the **Important**: Since this can cause data loss, test first with the `--dry-run` or the `--interactive`/`-i` flag. - rclone sync -i SOURCE remote:DESTINATION + rclone sync --interactive SOURCE remote:DESTINATION Note that files in the destination won't be deleted if there were any errors at any point. Duplicate objects (files with the same name, on diff --git a/docs/content/commands/rclone_touch.md b/docs/content/commands/rclone_touch.md index 0882cc34a..4c110248a 100644 --- a/docs/content/commands/rclone_touch.md +++ b/docs/content/commands/rclone_touch.md @@ -21,7 +21,7 @@ unless `--no-create` or `--recursive` is provided. If `--recursive` is used then recursively sets the modification time on all existing files that is found under the path. Filters are supported, -and you can test with the `--dry-run` or the `--interactive` flag. +and you can test with the `--dry-run` or the `--interactive`/`-i` flag. If `--timestamp` is used then sets the modification time to that time instead of the current time. Times may be specified as one of: diff --git a/docs/content/crypt.md b/docs/content/crypt.md index 2b0550246..cdab3b8f8 100644 --- a/docs/content/crypt.md +++ b/docs/content/crypt.md @@ -662,7 +662,7 @@ as `eremote:`. To sync the two remotes you would do - rclone sync -i remote:crypt remote2:crypt + rclone sync --interactive 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 c899b44c1..8c9cae769 100644 --- a/docs/content/docs.md +++ b/docs/content/docs.md @@ -94,7 +94,7 @@ storage system in the config file then the sub path, e.g. You can define as many storage paths as you like in the config file. -Please use the [`-i` / `--interactive`](#interactive) flag while +Please use the [`--interactive`/`-i`](#interactive) flag while learning rclone to avoid accidental data loss. Subcommands @@ -104,7 +104,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 -i /local/path remote:path # syncs /local/path to the remote + rclone sync --interactive /local/path remote:path # syncs /local/path to the remote The main rclone commands with most used first @@ -396,11 +396,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 -i ./sync:me remote:path + rclone sync --interactive ./sync:me remote:path or - rclone sync -i /full/path/to/sync:me remote:path + rclone sync --interactive /full/path/to/sync:me remote:path Server Side Copy ---------------- @@ -433,8 +433,8 @@ same. This can be used when scripting to make aged backups efficiently, e.g. - rclone sync -i remote:current-backup remote:previous-backup - rclone sync -i /path/to/files remote:current-backup + rclone sync --interactive remote:current-backup remote:previous-backup + rclone sync --interactive /path/to/files remote:current-backup ## Metadata support {#metadata} @@ -621,7 +621,7 @@ excluded by a filter rule. For example - rclone sync -i /path/to/local remote:current --backup-dir remote:old + rclone sync --interactive /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 @@ -1086,7 +1086,7 @@ Add an HTTP header for all download transactions. The flag can be repeated to add multiple headers. ``` -rclone sync -i s3:test/src ~/dst --header-download "X-Amz-Meta-Test: Foo" --header-download "X-Amz-Meta-Test2: Bar" +rclone sync --interactive 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 @@ -1098,7 +1098,7 @@ Add an HTTP header for all upload transactions. The flag can be repeated to add multiple headers. ``` -rclone sync -i ~/src s3:test/dst --header-upload "Content-Disposition: attachment; filename='cool.html'" --header-upload "X-Amz-Meta-Test: FooBar" +rclone sync --interactive ~/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 @@ -1208,7 +1208,7 @@ This can be useful as an additional layer of protection for immutable or append-only data sets (notably backup archives), where modification implies corruption and should not be propagated. -### -i / --interactive {#interactive} +### -i, --interactive {#interactive} This flag can be used to tell rclone that you wish a manual confirmation before destructive operations. @@ -1219,7 +1219,7 @@ especially with `rclone sync`. For example ``` -$ rclone delete -i /tmp/dir +$ rclone delete --interactive /tmp/dir rclone: delete "important-file.txt"? y) Yes, this is OK (default) n) No, skip this @@ -1372,7 +1372,7 @@ When the limit is reached all transfers will stop immediately. Rclone will exit with exit code 8 if the transfer limit is reached. -## --metadata / -M +## -M, --metadata Setting this flag enables rclone to copy the metadata from the source to the destination. For local backends this is ownership, permissions, @@ -1791,7 +1791,7 @@ or with `--backup-dir`. See `--backup-dir` for more info. For example - rclone copy -i /path/to/local/file remote:current --suffix .bak + rclone copy --interactive /path/to/local/file remote:current --suffix .bak will copy `/path/to/local` to `remote:current`, but for any files which would have been updated or deleted have .bak added. @@ -1800,7 +1800,7 @@ If using `rclone sync` with `--suffix` and without `--backup-dir` then it is recommended to put a filter rule in excluding the suffix otherwise the `sync` will delete the backup files. - rclone sync -i /path/to/local/file remote:current --suffix .bak --exclude "*.bak" + rclone sync --interactive /path/to/local/file remote:current --suffix .bak --exclude "*.bak" ### --suffix-keep-extension ### diff --git a/docs/content/faq.md b/docs/content/faq.md index b42403af5..574cd540f 100644 --- a/docs/content/faq.md +++ b/docs/content/faq.md @@ -33,7 +33,7 @@ The syncs would be incremental (on a file by file basis). e.g. - rclone sync -i drive:Folder s3:bucket + rclone sync --interactive drive:Folder s3:bucket ### Using rclone from multiple locations at the same time ### @@ -42,8 +42,8 @@ You can use rclone from multiple places at the same time if you choose different subdirectory for the output, e.g. ``` -Server A> rclone sync -i /tmp/whatever remote:ServerA -Server B> rclone sync -i /tmp/whatever remote:ServerB +Server A> rclone sync --interactive /tmp/whatever remote:ServerA +Server B> rclone sync --interactive /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 bfff3eab9..d61bb1992 100644 --- a/docs/content/filtering.md +++ b/docs/content/filtering.md @@ -723,7 +723,7 @@ and `-v` first. In conjunction with `rclone sync`, `--delete-excluded` deletes any files on the destination which are excluded from the command. -E.g. the scope of `rclone sync -i A: B:` can be restricted: +E.g. the scope of `rclone sync --interactive A: B:` can be restricted: rclone --min-size 50k --delete-excluded sync A: B: diff --git a/docs/content/ftp.md b/docs/content/ftp.md index ca919fd37..394ad8a42 100644 --- a/docs/content/ftp.md +++ b/docs/content/ftp.md @@ -99,7 +99,7 @@ List the contents of a directory Sync `/home/local/directory` to the remote directory, deleting any excess files in the directory. - rclone sync -i /home/local/directory remote:directory + rclone sync --interactive /home/local/directory remote:directory ### Anonymous FTP diff --git a/docs/content/googlecloudstorage.md b/docs/content/googlecloudstorage.md index 1932696f2..704112a0e 100644 --- a/docs/content/googlecloudstorage.md +++ b/docs/content/googlecloudstorage.md @@ -172,7 +172,7 @@ List the contents of a bucket Sync `/home/local/directory` to the remote bucket, deleting any excess files in the bucket. - rclone sync -i /home/local/directory remote:bucket + rclone sync --interactive /home/local/directory remote:bucket ### Service Account support diff --git a/docs/content/googlephotos.md b/docs/content/googlephotos.md index 69bb4a1dc..e10b2a9fe 100644 --- a/docs/content/googlephotos.md +++ b/docs/content/googlephotos.md @@ -117,7 +117,7 @@ List the contents of an album Sync `/home/local/images` to the Google Photos, removing any excess files in the album. - rclone sync -i /home/local/image remote:album/newAlbum + rclone sync --interactive /home/local/image remote:album/newAlbum ### Layout diff --git a/docs/content/hdfs.md b/docs/content/hdfs.md index 867e7a096..701590e60 100644 --- a/docs/content/hdfs.md +++ b/docs/content/hdfs.md @@ -91,7 +91,7 @@ List the contents of a directory Sync the remote `directory` to `/home/local/directory`, deleting any excess files. - rclone sync -i remote:directory /home/local/directory + rclone sync --interactive remote:directory /home/local/directory ### Setting up your own HDFS instance for testing diff --git a/docs/content/http.md b/docs/content/http.md index 93c5aee66..06ae9cada 100644 --- a/docs/content/http.md +++ b/docs/content/http.md @@ -99,7 +99,7 @@ List the contents of a directory Sync the remote `directory` to `/home/local/directory`, deleting any excess files. - rclone sync -i remote:directory /home/local/directory + rclone sync --interactive remote:directory /home/local/directory ### Read only diff --git a/docs/content/internetarchive.md b/docs/content/internetarchive.md index 71f7db35d..a2d5a4771 100644 --- a/docs/content/internetarchive.md +++ b/docs/content/internetarchive.md @@ -28,7 +28,7 @@ List the contents of a item Sync `/home/local/directory` to the remote item, deleting any excess files in the item. - rclone sync -i /home/local/directory remote:item + rclone sync --interactive /home/local/directory remote:item ## Notes Because of Internet Archive's architecture, it enqueues write operations (and extra post-processings) in a per-item queue. You can check item's queue at https://catalogd.archive.org/history/item-name-here . Because of that, all uploads/deletes will not show up immediately and takes some time to be available. diff --git a/docs/content/local.md b/docs/content/local.md index 15c577e83..42327a940 100644 --- a/docs/content/local.md +++ b/docs/content/local.md @@ -8,7 +8,7 @@ versionIntroduced: "v0.91" Local paths are specified as normal filesystem paths, e.g. `/path/to/wherever`, so - rclone sync -i /home/source /tmp/destination + rclone sync --interactive /home/source /tmp/destination Will sync `/home/source` to `/tmp/destination`. diff --git a/docs/content/mailru.md b/docs/content/mailru.md index 8d5b70a48..c618b27f5 100644 --- a/docs/content/mailru.md +++ b/docs/content/mailru.md @@ -123,7 +123,7 @@ List the contents of a directory Sync `/home/local/directory` to the remote path, deleting any excess files in the path. - rclone sync -i /home/local/directory remote:directory + rclone sync --interactive /home/local/directory remote:directory ### Modified time diff --git a/docs/content/onedrive.md b/docs/content/onedrive.md index 2377b04e1..8e2b0ee44 100644 --- a/docs/content/onedrive.md +++ b/docs/content/onedrive.md @@ -629,11 +629,11 @@ OneDrive supports `rclone cleanup` which causes rclone to look through every file under the path supplied and delete all version but the current version. Because this involves traversing all the files, then querying each file for versions it can be quite slow. Rclone does -`--checkers` tests in parallel. The command also supports `-i` which -is a great way to see what it would do. +`--checkers` tests in parallel. The command also supports `--interactive`/`i` +or `--dry-run` which is a great way to see what it would do. - rclone cleanup -i remote:path/subdir # interactively remove all old version for path/subdir - rclone cleanup remote:path/subdir # unconditionally remove all old version for path/subdir + rclone cleanup --interactive remote:path/subdir # interactively remove all old version for path/subdir + rclone cleanup remote:path/subdir # unconditionally remove all old version for path/subdir **NB** Onedrive personal can't currently delete versions diff --git a/docs/content/qingstor.md b/docs/content/qingstor.md index 68772f4dd..219e61a9b 100644 --- a/docs/content/qingstor.md +++ b/docs/content/qingstor.md @@ -92,7 +92,7 @@ List the contents of a bucket Sync `/home/local/directory` to the remote bucket, deleting any excess files in the bucket. - rclone sync -i /home/local/directory remote:bucket + rclone sync --interactive /home/local/directory remote:bucket ### --fast-list diff --git a/docs/content/s3.md b/docs/content/s3.md index 172365e24..e9a65ea3c 100644 --- a/docs/content/s3.md +++ b/docs/content/s3.md @@ -55,7 +55,7 @@ List the contents of a bucket Sync `/home/local/directory` to the remote bucket, deleting any excess files in the bucket. - rclone sync -i /home/local/directory remote:bucket + rclone sync --interactive /home/local/directory remote:bucket ## Configuration @@ -459,10 +459,10 @@ $ rclone -q --s3-versions ls s3:cleanup-test ### Cleanup If you run `rclone cleanup s3:bucket` then it will remove all pending -multipart uploads older than 24 hours. You can use the `-i` flag to -see exactly what it will do. If you want more control over the expiry -date then run `rclone backend cleanup s3:bucket -o max-age=1h` to -expire all uploads older than one hour. You can use `rclone backend +multipart uploads older than 24 hours. You can use the `--interactive`/`i` +or `--dry-run` flag to see exactly what it will do. If you want more control over the +expiry date then run `rclone backend cleanup s3:bucket -o max-age=1h` +to expire all uploads older than one hour. You can use `rclone backend list-multipart-uploads s3:bucket` to see the pending multipart uploads. diff --git a/docs/content/seafile.md b/docs/content/seafile.md index 57399657a..5afeadbfe 100644 --- a/docs/content/seafile.md +++ b/docs/content/seafile.md @@ -113,7 +113,7 @@ List the contents of a library Sync `/home/local/directory` to the remote library, deleting any excess files in the library. - rclone sync -i /home/local/directory seafile:library + rclone sync --interactive /home/local/directory seafile:library ### Configuration in library mode @@ -209,7 +209,7 @@ List the contents of a directory Sync `/home/local/directory` to the remote library, deleting any excess files in the library. - rclone sync -i /home/local/directory seafile: + rclone sync --interactive /home/local/directory seafile: ### --fast-list diff --git a/docs/content/sftp.md b/docs/content/sftp.md index d7b23ee0f..bff2796be 100644 --- a/docs/content/sftp.md +++ b/docs/content/sftp.md @@ -109,7 +109,7 @@ List the contents of a directory Sync `/home/local/directory` to the remote directory, deleting any excess files in the directory. - rclone sync -i /home/local/directory remote:directory + rclone sync --interactive /home/local/directory remote:directory Mount the remote path `/srv/www-data/` to the local path `/mnt/www-data` diff --git a/docs/content/storj.md b/docs/content/storj.md index 95c3e4caa..cd0d936c5 100644 --- a/docs/content/storj.md +++ b/docs/content/storj.md @@ -389,7 +389,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 -i --progress /home/local/directory/ remote:bucket/path/to/dir/ + rclone sync --interactive --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. @@ -399,15 +399,15 @@ to see exactly what would be copied and deleted. The sync can be done also from Storj to the local file system. - rclone sync -i --progress remote:bucket/path/to/dir/ /home/local/directory/ + rclone sync --interactive --progress remote:bucket/path/to/dir/ /home/local/directory/ Or between two Storj buckets. - rclone sync -i --progress remote-us:bucket/path/to/dir/ remote-europe:bucket/path/to/dir/ + rclone sync --interactive --progress remote-us:bucket/path/to/dir/ remote-europe:bucket/path/to/dir/ Or even between another cloud storage and Storj. - rclone sync -i --progress s3:bucket/path/to/dir/ storj:bucket/path/to/dir/ + rclone sync --interactive --progress s3:bucket/path/to/dir/ storj:bucket/path/to/dir/ ## Limitations diff --git a/docs/content/swift.md b/docs/content/swift.md index b1334ac03..7f73fa556 100644 --- a/docs/content/swift.md +++ b/docs/content/swift.md @@ -134,7 +134,7 @@ List the contents of a container Sync `/home/local/directory` to the remote container, deleting any excess files in the container. - rclone sync -i /home/local/directory remote:container + rclone sync --interactive /home/local/directory remote:container ### Configuration from an OpenStack credentials file diff --git a/docs/content/yandex.md b/docs/content/yandex.md index 0093d6235..0606fdfbd 100644 --- a/docs/content/yandex.md +++ b/docs/content/yandex.md @@ -83,7 +83,7 @@ List the contents of a directory Sync `/home/local/directory` to the remote path, deleting any excess files in the path. - rclone sync -i /home/local/directory remote:directory + rclone sync --interactive /home/local/directory remote:directory Yandex paths may be as deep as required, e.g. `remote:directory/subdirectory`. diff --git a/docs/content/zoho.md b/docs/content/zoho.md index 18306a63b..a103c4613 100644 --- a/docs/content/zoho.md +++ b/docs/content/zoho.md @@ -103,7 +103,7 @@ List the contents of a directory Sync `/home/local/directory` to the remote path, deleting any excess files in the path. - rclone sync -i /home/local/directory remote:directory + rclone sync --interactive /home/local/directory remote:directory Zoho paths may be as deep as required, eg `remote:directory/subdirectory`.