Version v1.51.0

s3-about
Nick Craig-Wood 2020-02-01 10:31:42 +00:00
parent 9f99c20232
commit 43daecd89b
107 changed files with 38444 additions and 25727 deletions

15786
MANUAL.html generated

File diff suppressed because one or more lines are too long

1481
MANUAL.md generated

File diff suppressed because it is too large Load Diff

14872
MANUAL.txt generated

File diff suppressed because it is too large Load Diff

View File

@ -9,12 +9,13 @@ This file describes how to make the various kinds of releases
## Making a release
* git checkout master
* git pull
* git status - make sure everything is checked in
* Check travis & appveyor builds are green
* make check
* Check GitHub actions build for master is Green
* make test # see integration test server or run locally
* make tag
* edit docs/content/changelog.md
* edit docs/content/changelog.md # make sure to remove duplicate logs from point releases
* make tidy
* make doc
* git status - to check for new man pages - git add them

View File

@ -1 +1 @@
v1.50.2
v1.51.0

View File

@ -262,6 +262,17 @@ underlying S3 storage.
- Type: SizeSuffix
- Default: 9G
#### --acd-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_ACD_ENCODING
- Type: MultiEncoder
- Default: Slash,InvalidUtf8,Dot
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -272,6 +272,17 @@ tiering blob to "Hot" or "Cool".
- Type: string
- Default: ""
#### --azureblob-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_AZUREBLOB_ENCODING
- Type: MultiEncoder
- Default: Slash,BackSlash,Del,Ctl,RightPeriod,InvalidUtf8
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -457,5 +457,16 @@ The minimum value is 1 second. The maximum value is one week.
- Type: Duration
- Default: 1w
#### --b2-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_B2_ENCODING
- Type: MultiEncoder
- Default: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot
<!--- autogenerated options stop -->

View File

@ -298,6 +298,17 @@ Max number of times to try committing a multipart file.
- Type: int
- Default: 100
#### --box-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_BOX_ENCODING
- Type: MultiEncoder
- Default: Slash,BackSlash,Del,Ctl,RightSpace,InvalidUtf8,Dot
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -1,11 +1,148 @@
---
title: "Documentation"
description: "Rclone Changelog"
date: "2019-11-19"
date: "2020-02-01"
---
# Changelog
## v1.51.0 - 2020-02-01
* New backends
* [Memory](/memory) (Nick Craig-Wood)
* [Sugarsync](/sugarsync) (Nick Craig-Wood)
* New Features
* Adjust all backends to have `--backend-encoding` parameter (Nick Craig-Wood)
* this enables the encoding for special characters to be adjusted or disabled
* Add `--max-duration` flag to control the maximum duration of a transfer session (boosh)
* Add `--expect-continue-timeout` flag, default 1s (Nick Craig-Wood)
* Add `--no-check-dest` flag for copying without testing the destination (Nick Craig-Wood)
* Implement `--order-by` flag to order transfers (Nick Craig-Wood)
* accounting
* Don't show entries in both transferring and checking (Nick Craig-Wood)
* Add option to delete stats (Aleksandar Jankovic)
* build
* Compress the test builds with gzip (Nick Craig-Wood)
* Implement a framework for starting test servers during tests (Nick Craig-Wood)
* cmd: Always print elapsed time to tenth place seconds in progress (Gary Kim)
* config
* Add `--password-command` to allow dynamic config password (Damon Permezel)
* Give config questions default values (Nick Craig-Wood)
* Check a remote exists when creating a new one (Nick Craig-Wood)
* copyurl: Add `--stdout` flag to write to stdout (Nick Craig-Wood)
* dedupe: Implement keep smallest too (Nick Craig-Wood)
* hashsum: Add flag `--base64` flag (landall)
* lsf: Speed up on s3/swift/etc by not reading mimetype by default (Nick Craig-Wood)
* lsjson: Add `--no-mimetype` flag (Nick Craig-Wood)
* rc: Add methods to turn on blocking and mutex profiling (Nick Craig-Wood)
* rcd
* Adding group parameter to stats (Chaitanya)
* Move webgui apart; option to disable browser (Xiaoxing Ye)
* serve sftp: Add support for public key with auth proxy (Paul Tinsley)
* stats: Show deletes in stats and hide zero stats (anuar45)
* Bug Fixes
* accounting
* Fix error counter counting multiple times (Ankur Gupta)
* Fix error count shown as checks (Cnly)
* Clear finished transfer in stats-reset (Maciej Zimnoch)
* Added StatsInfo locking in statsGroups sum function (Michał Matczuk)
* asyncreader: Fix EOF error (buengese)
* check: Fix `--one-way` recursing more directories than it needs to (Nick Craig-Wood)
* chunkedreader: Disable hash calculation for first segment (Nick Craig-Wood)
* config
* Do not open browser on headless on drive/gcs/google photos (Xiaoxing Ye)
* SetValueAndSave ignore error if config section does not exist yet (buengese)
* cmd: Fix completion with an encrypted config (Danil Semelenov)
* dbhashsum: Stop it returning UNSUPPORTED on dropbox (Nick Craig-Wood)
* dedupe: Add missing modes to help string (Nick Craig-Wood)
* operations
* Fix dedupe continuing on errors like insufficientFilePermisson (SezalAgrawal)
* Clear accounting before low level retry (Maciej Zimnoch)
* Write debug message when hashes could not be checked (Ole Schütt)
* Move interface assertion to tests to remove pflag dependency (Nick Craig-Wood)
* Make NewOverrideObjectInfo public and factor uses (Nick Craig-Wood)
* proxy: Replace use of bcrypt with sha256 (Nick Craig-Wood)
* vendor
* Update bazil.org/fuse to fix FreeBSD 12.1 (Nick Craig-Wood)
* Update github.com/t3rm1n4l/go-mega to fix mega "illegal base64 data at input byte 22" (Nick Craig-Wood)
* Update termbox-go to fix ncdu command on FreeBSD (Kuang-che Wu)
* Update t3rm1n4l/go-mega - fixes mega: couldn't login: crypto/aes: invalid key size 0 (Nick Craig-Wood)
* Mount
* Enable async reads for a 20% speedup (Nick Craig-Wood)
* Replace use of WriteAt with Write for cache mode >= writes and O_APPEND (Brett Dutro)
* Make sure we call unmount when exiting (Nick Craig-Wood)
* Don't build on go1.10 as bazil/fuse no longer supports it (Nick Craig-Wood)
* When setting dates discard out of range dates (Nick Craig-Wood)
* VFS
* Add a newly created file straight into the directory (Nick Craig-Wood)
* Only calculate one hash for reads for a speedup (Nick Craig-Wood)
* Make ReadAt for non cached files work better with non-sequential reads (Nick Craig-Wood)
* Fix edge cases when reading ModTime from file (Nick Craig-Wood)
* Make sure existing files opened for write show correct size (Nick Craig-Wood)
* Don't cache the path in RW file objects to fix renaming (Nick Craig-Wood)
* Fix rename of open files when using the VFS cache (Nick Craig-Wood)
* When renaming files in the cache, rename the cache item in memory too (Nick Craig-Wood)
* Fix open file renaming on drive when using `--vfs-cache-mode writes` (Nick Craig-Wood)
* Fix incorrect modtime for mv into mount with `--vfs-cache-modes writes` (Nick Craig-Wood)
* On rename, rename in cache too if the file exists (Anagh Kumar Baranwal)
* Local
* Make source file being updated errors be NoLowLevelRetry errors (Nick Craig-Wood)
* Fix update of hidden files on Windows (Nick Craig-Wood)
* Cache
* Follow move of upstream library github.com/coreos/bbolt github.com/etcd-io/bbolt (Nick Craig-Wood)
* Fix `fatal error: concurrent map writes` (Nick Craig-Wood)
* Crypt
* Reorder the filename encryption options (Thomas Eales)
* Correctly handle trailing dot (buengese)
* Chunker
* Reduce length of temporary suffix (Ivan Andreev)
* Drive
* Add `--drive-stop-on-upload-limit` flag to stop syncs when upload limit reached (Nick Craig-Wood)
* Add `--drive-use-shared-date` to use date file was shared instead of modified date (Garry McNulty)
* Make sure invalid auth for teamdrives always reports an error (Nick Craig-Wood)
* Fix `--fast-list` when using appDataFolder (Nick Craig-Wood)
* Use multipart resumable uploads for streaming and uploads in mount (Nick Craig-Wood)
* Log an ERROR if an incomplete search is returned (Nick Craig-Wood)
* Hide dangerous config from the configurator (Nick Craig-Wood)
* Dropbox
* Treat `insufficient_space` errors as non retriable errors (Nick Craig-Wood)
* Jottacloud
* Use new auth method used by official client (buengese)
* Add URL to generate Login Token to config wizard (Nick Craig-Wood)
* Add support whitelabel versions (buengese)
* Koofr
* Use rclone HTTP client. (jaKa)
* Onedrive
* Add Sites.Read.All permission (Benjamin Richter)
* Add support "Retry-After" header (Motonori IWAMURO)
* Opendrive
* Implement `--opendrive-chunk-size` (Nick Craig-Wood)
* S3
* Re-implement multipart upload to fix memory issues (Nick Craig-Wood)
* Add `--s3-copy-cutoff` for size to switch to multipart copy (Nick Craig-Wood)
* Add new region Asia Patific (Hong Kong) (Outvi V)
* Reduce memory usage streaming files by reducing max stream upload size (Nick Craig-Wood)
* Add `--s3-list-chunk` option for bucket listing (Thomas Kriechbaumer)
* Force path style bucket access to off for AWS deprecation (Nick Craig-Wood)
* Use AWS web identity role provider if available (Tennix)
* Add StackPath Object Storage Support (Dave Koston)
* Fix ExpiryWindow value (Aleksandar Jankovic)
* Fix DisableChecksum condition (Aleksandar Janković)
* Fix URL decoding of NextMarker (Nick Craig-Wood)
* SFTP
* Add `--sftp-skip-links` to skip symlinks and non regular files (Nick Craig-Wood)
* Retry Creation of Connection (Sebastian Brandt)
* Fix "failed to parse private key file: ssh: not an encrypted key" error (Nick Craig-Wood)
* Open files for update write only to fix AWS SFTP interop (Nick Craig-Wood)
* Swift
* Reserve segments of dynamic large object when delete objects in container what was enabled versioning. (Nguyễn Hữu Luân)
* Fix parsing of X-Object-Manifest (Nick Craig-Wood)
* Update OVH API endpoint (unbelauscht)
* WebDAV
* Make nextcloud only upload SHA1 checksums (Nick Craig-Wood)
* Fix case of "Bearer" in Authorization: header to agree with RFC (Nick Craig-Wood)
* Add Referer header to fix problems with WAFs (Nick Craig-Wood)
## v1.50.2 - 2019-11-19
* Bug Fixes

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone"
slug: rclone
url: /commands/rclone/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone about"
slug: rclone_about
url: /commands/rclone_about/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone authorize"
slug: rclone_authorize
url: /commands/rclone_authorize/
@ -15,6 +15,9 @@ Remote authorization. Used to authorize a remote or headless
rclone from a machine with a browser - use as instructed by
rclone config.
Use the --auth-no-open-browser to prevent rclone to open auth
link in default browser automatically.
```
rclone authorize [flags]
```
@ -22,8 +25,8 @@ rclone authorize [flags]
### Options
```
--auth-no-open-browser Do not automatically open auth link in default browser
-h, --help help for authorize
--auth-no-open-browser Do not automatically open auth link in default browser
-h, --help help for authorize
```
See the [global flags page](/flags/) for global options not listed here.

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone cachestats"
slug: rclone_cachestats
url: /commands/rclone_cachestats/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone cat"
slug: rclone_cat
url: /commands/rclone_cat/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone check"
slug: rclone_check
url: /commands/rclone_check/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone cleanup"
slug: rclone_cleanup
url: /commands/rclone_cleanup/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone config"
slug: rclone_config
url: /commands/rclone_config/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone config create"
slug: rclone_config_create
url: /commands/rclone_config_create/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone config delete"
slug: rclone_config_delete
url: /commands/rclone_config_delete/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone config disconnect"
slug: rclone_config_disconnect
url: /commands/rclone_config_disconnect/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone config dump"
slug: rclone_config_dump
url: /commands/rclone_config_dump/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone config edit"
slug: rclone_config_edit
url: /commands/rclone_config_edit/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone config file"
slug: rclone_config_file
url: /commands/rclone_config_file/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone config password"
slug: rclone_config_password
url: /commands/rclone_config_password/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone config providers"
slug: rclone_config_providers
url: /commands/rclone_config_providers/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone config reconnect"
slug: rclone_config_reconnect
url: /commands/rclone_config_reconnect/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone config show"
slug: rclone_config_show
url: /commands/rclone_config_show/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone config update"
slug: rclone_config_update
url: /commands/rclone_config_update/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone config userinfo"
slug: rclone_config_userinfo
url: /commands/rclone_config_userinfo/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone copy"
slug: rclone_copy
url: /commands/rclone_copy/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone copyto"
slug: rclone_copyto
url: /commands/rclone_copyto/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone copyurl"
slug: rclone_copyurl
url: /commands/rclone_copyurl/
@ -11,10 +11,15 @@ Copy url content to dest.
### Synopsis
Download urls content and copy it to destination
without saving it in tmp storage.
Download a URL's content and copy it to the destination without saving
it in temporary storage.
Setting --auto-filename flag will cause retrieving file name from url and using it in destination path.
Setting --auto-filename will cause the file name to be retreived from
the from URL (after any redirections) and used in the destination
path.
Setting --stdout or making the output file name "-" will cause the
output to be written to standard output.
```
@ -24,8 +29,9 @@ rclone copyurl https://example.com dest:path [flags]
### Options
```
-a, --auto-filename Get the file name from the url and use it for destination file path
-a, --auto-filename Get the file name from the URL and use it for destination file path
-h, --help help for copyurl
--stdout Write the output to stdout rather than a file
```
See the [global flags page](/flags/) for global options not listed here.

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone cryptcheck"
slug: rclone_cryptcheck
url: /commands/rclone_cryptcheck/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone cryptdecode"
slug: rclone_cryptdecode
url: /commands/rclone_cryptdecode/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone dbhashsum"
slug: rclone_dbhashsum
url: /commands/rclone_dbhashsum/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone dedupe"
slug: rclone_dedupe
url: /commands/rclone_dedupe/
@ -81,6 +81,7 @@ Dedupe can be run non interactively using the `--dedupe-mode` flag or by using a
* `--dedupe-mode newest` - removes identical files then keeps the newest one.
* `--dedupe-mode oldest` - removes identical files then keeps the oldest one.
* `--dedupe-mode largest` - removes identical files then keeps the largest one.
* `--dedupe-mode smallest` - removes identical files then keeps the smallest one.
* `--dedupe-mode rename` - removes identical files then renames the rest to be different.
For example to rename all the identically named photos in your Google Photos directory, do
@ -99,7 +100,7 @@ rclone dedupe [mode] remote:path [flags]
### Options
```
--dedupe-mode string Dedupe mode interactive|skip|first|newest|oldest|rename. (default "interactive")
--dedupe-mode string Dedupe mode interactive|skip|first|newest|oldest|largest|smallest|rename. (default "interactive")
-h, --help help for dedupe
```

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone delete"
slug: rclone_delete
url: /commands/rclone_delete/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone deletefile"
slug: rclone_deletefile
url: /commands/rclone_deletefile/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone genautocomplete"
slug: rclone_genautocomplete
url: /commands/rclone_genautocomplete/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone genautocomplete bash"
slug: rclone_genautocomplete_bash
url: /commands/rclone_genautocomplete_bash/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone genautocomplete zsh"
slug: rclone_genautocomplete_zsh
url: /commands/rclone_genautocomplete_zsh/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone gendocs"
slug: rclone_gendocs
url: /commands/rclone_gendocs/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone hashsum"
slug: rclone_hashsum
url: /commands/rclone_hashsum/
@ -36,7 +36,8 @@ rclone hashsum <hash> remote:path [flags]
### Options
```
-h, --help help for hashsum
--base64 Output base64 encoded hashsum
-h, --help help for hashsum
```
See the [global flags page](/flags/) for global options not listed here.

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone link"
slug: rclone_link
url: /commands/rclone_link/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone listremotes"
slug: rclone_listremotes
url: /commands/rclone_listremotes/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone ls"
slug: rclone_ls
url: /commands/rclone_ls/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone lsd"
slug: rclone_lsd
url: /commands/rclone_lsd/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone lsf"
slug: rclone_lsf
url: /commands/rclone_lsf/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone lsjson"
slug: rclone_lsjson
url: /commands/rclone_lsjson/
@ -36,7 +36,9 @@ The output is an array of Items, where each Item looks like this
If --hash is not specified the Hashes property won't be emitted.
If --no-modtime is specified then ModTime will be blank.
If --no-modtime is specified then ModTime will be blank. This can speed things up on remotes where reading the ModTime takes an extra request (eg s3, swift).
If --no-mimetype is specified then MimeType will be blank. This can speed things up on remotes where reading the MimeType takes an extra request (eg s3, swift).
If --encrypted is not specified the Encrypted won't be emitted.
@ -94,14 +96,15 @@ rclone lsjson remote:path [flags]
### Options
```
--dirs-only Show only directories in the listing.
-M, --encrypted Show the encrypted names.
--files-only Show only files in the listing.
--hash Include hashes in the output (may take longer).
-h, --help help for lsjson
--no-modtime Don't read the modification time (can speed things up).
--original Show the ID of the underlying Object.
-R, --recursive Recurse into the listing.
--dirs-only Show only directories in the listing.
-M, --encrypted Show the encrypted names.
--files-only Show only files in the listing.
--hash Include hashes in the output (may take longer).
-h, --help help for lsjson
--no-mimetype Don't read the mime type (can speed things up).
--no-modtime Don't read the modification time (can speed things up).
--original Show the ID of the underlying Object.
-R, --recursive Recurse into the listing.
```
See the [global flags page](/flags/) for global options not listed here.

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone lsl"
slug: rclone_lsl
url: /commands/rclone_lsl/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone md5sum"
slug: rclone_md5sum
url: /commands/rclone_md5sum/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone mkdir"
slug: rclone_mkdir
url: /commands/rclone_mkdir/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone mount"
slug: rclone_mount
url: /commands/rclone_mount/
@ -65,28 +65,6 @@ infrastructure](https://github.com/billziss-gh/winfsp/wiki/WinFsp-Service-Archit
which creates drives accessible for everyone on the system or
alternatively using [the nssm service manager](https://nssm.cc/usage).
#### Mount as a network drive
By default, rclone will mount the remote as a normal drive. However, you can also mount it as a **Network Drive**
(or **Network Share**, as mentioned in some places)
Unlike other systems, Windows provides a different filesystem type for network drives.
Windows and other programs treat the network drives and fixed/removable drives differently:
In network drives, many I/O operations are optimized, as the high latency and low reliability
(compared to a normal drive) of a network is expected.
Although many people prefer network shares to be mounted as normal system drives, this might cause
some issues, such as programs not working as expected or freezes and errors while operating with the
mounted remote in Windows Explorer. If you experience any of those, consider mounting rclone remotes as network shares,
as Windows expects normal drives to be fast and reliable, while cloud storage is far from that.
See also [Limitations](#limitations) section below for more info
Add `--fuse-flag --VolumePrefix=\server\share` to your `mount` command, **replacing `share` with any other
name of your choice if you are mounting more than one remote**. Otherwise, the mountpoints will conflict and
your mounted filesystems will overlap.
[Read more about drive mapping](https://en.wikipedia.org/wiki/Drive_mapping)
### Limitations
Without the use of "--vfs-cache-mode" this can only write files

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone move"
slug: rclone_move
url: /commands/rclone_move/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone moveto"
slug: rclone_moveto
url: /commands/rclone_moveto/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone ncdu"
slug: rclone_ncdu
url: /commands/rclone_ncdu/
@ -31,6 +31,7 @@ Here are the keys - press '?' to toggle the help on and off
g toggle graph
n,s,C sort by name,size,count
d delete file/directory
y copy current path to clipbard
Y display current path
^L refresh screen
? to toggle help on and off

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone obscure"
slug: rclone_obscure
url: /commands/rclone_obscure/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone purge"
slug: rclone_purge
url: /commands/rclone_purge/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone rc"
slug: rclone_rc
url: /commands/rclone_rc/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone rcat"
slug: rclone_rcat
url: /commands/rclone_rcat/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone rcd"
slug: rclone_rcd
url: /commands/rclone_rcd/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone rmdir"
slug: rclone_rmdir
url: /commands/rclone_rmdir/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone rmdirs"
slug: rclone_rmdirs
url: /commands/rclone_rmdirs/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone serve"
slug: rclone_serve
url: /commands/rclone_serve/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone serve dlna"
slug: rclone_serve_dlna
url: /commands/rclone_serve_dlna/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone serve ftp"
slug: rclone_serve_ftp
url: /commands/rclone_serve_ftp/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone serve http"
slug: rclone_serve_http
url: /commands/rclone_serve_http/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone serve restic"
slug: rclone_serve_restic
url: /commands/rclone_serve_restic/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone serve sftp"
slug: rclone_serve_sftp
url: /commands/rclone_serve_sftp/
@ -22,9 +22,9 @@ The server will log errors. Use -v to see access logs.
--bwlimit will be respected for file transfers. Use --stats to
control the stats printing.
You must provide some means of authentication, either with `--user`/`--pass`,
an authorized keys file (specify location with `--authorized-keys` - the
default is the same as ssh), an `--auth-proxy`, or set the --no-auth flag for no
You must provide some means of authentication, either with --user/--pass,
an authorized keys file (specify location with --authorized-keys - the
default is the same as ssh) or set the --no-auth flag for no
authentication when logging in.
Note that this also implements a small number of shell commands so
@ -183,13 +183,11 @@ rclone will use that program to generate backends on the fly which
then are used to authenticate incoming requests. This uses a simple
JSON based protocl with input on STDIN and output on STDOUT.
> **PLEASE NOTE:** `--auth-proxy` and `--authorized-keys` cannot be used together, if `--auth-proxy` is set the authorized keys option will be ignored.
There is an example program
[bin/test_proxy.py](https://github.com/rclone/rclone/blob/master/test_proxy.py)
in the rclone source code.
The program's job is to take a `user` and `pass` or `public_key` on the input and turn
The program's job is to take a `user` and `pass` on the input and turn
those into the config for a backend on STDOUT in JSON format. This
config will have any default parameters for the backend added, but it
won't use configuration from environment variables or command line
@ -202,7 +200,7 @@ This config generated must have this extra parameter
And it may have this parameter
- `_obscure` - comma separated strings for parameters to obscure
If password authentication was used by the client, input to the proxy process (on STDIN) would look similar to this:
For example the program might take this on STDIN
```
{
@ -211,16 +209,7 @@ If password authentication was used by the client, input to the proxy process (o
}
```
If public-key authentication was used by the client, input to the proxy process (on STDIN) would look similar to this:
```
{
"user": "me",
"public_key": "AAAAB3NzaC1yc2EAAAADAQABAAABAQDuwESFdAe14hVS6omeyX7edc+4BlQz1s6tWT5VxBu1YlR9w39BUAom4qDKuH+uqLMDIaS5F7D6lNwOuPylvyV/LgMFsgJV4QZ52Kws7mNgdsCEDTvfLz5Pt9Qtp6Gnah3kA0cmbXcfQFaO50Ojnz/W1ozg2z5evKmGtyYMtywTXvH/KVh5WjhbpQ/ERgu+1pbgwWkpWNBM8TCO8D85PSpxtkdpEdkaiGtKA6U+6ZOtdCqd88EasyMEBWLVSx9bvqMVsD8plYstXOm5CCptGWWqckZBIqp0YBP6atw/ANRESD3cIJ4dOO+qlWkLR5npAZZTx2Qqh+hVw6qqTFB+JQdf"
}
```
And as an example return this on STDOUT
And return this on STDOUT
```
{
@ -234,7 +223,7 @@ And as an example return this on STDOUT
```
This would mean that an SFTP backend would be created on the fly for
the `user` and `pass`/`public_key` returned in the output to the host given. Note
the `user` and `pass` returned in the output to the host given. Note
that since `_obscure` is set to `pass`, rclone will obscure the `pass`
parameter before creating the backend (which is required for sftp
backends).
@ -246,8 +235,8 @@ in the output and the user to `user`. For security you'd probably want
to restrict the `host` to a limited list.
Note that an internal cache is keyed on `user` so only use that for
configuration, don't use `pass` or `public_key`. This also means that if a user's
password or public-key is changed the cache will need to expire (which takes 5 mins)
configuration, don't use `pass`. This also means that if a user's
password is changed the cache will need to expire (which takes 5 mins)
before it takes effect.
This can be used to build general purpose proxies to any kind of

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone serve webdav"
slug: rclone_serve_webdav
url: /commands/rclone_serve_webdav/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone settier"
slug: rclone_settier
url: /commands/rclone_settier/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone sha1sum"
slug: rclone_sha1sum
url: /commands/rclone_sha1sum/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone size"
slug: rclone_size
url: /commands/rclone_size/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone sync"
slug: rclone_sync
url: /commands/rclone_sync/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone touch"
slug: rclone_touch
url: /commands/rclone_touch/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone tree"
slug: rclone_tree
url: /commands/rclone_tree/

View File

@ -1,5 +1,5 @@
---
date: 2019-10-26T11:04:03+01:00
date: 2020-02-01T10:26:53Z
title: "rclone version"
slug: rclone_version
url: /commands/rclone_version/

View File

@ -297,12 +297,12 @@ How to encrypt the filenames.
- Type: string
- Default: "standard"
- Examples:
- "off"
- Don't encrypt the file names. Adds a ".bin" extension only.
- "standard"
- Encrypt the filenames see the docs for the details.
- "obfuscate"
- Very simple filename obfuscation.
- "off"
- Don't encrypt the file names. Adds a ".bin" extension only.
#### --crypt-directory-name-encryption

View File

@ -735,6 +735,21 @@ or move the photos locally and use the date the image was taken
- Type: bool
- Default: false
#### --drive-use-shared-date
Use date file was shared instead of modified date.
Note that, as with "--drive-use-created-date", this flag may have
unexpected consequences when uploading/downloading files.
If both this flag and "--drive-use-created-date" are set, the created
date is used.
- Config: use_shared_date
- Env Var: RCLONE_DRIVE_USE_SHARED_DATE
- Type: bool
- Default: false
#### --drive-list-chunk
Size of listing chunk 100-1000. 0 to disable.
@ -820,10 +835,20 @@ Keep new head revision of each file forever.
#### --drive-size-as-quota
Show storage quota usage for file size.
Show sizes as storage quota usage, not actual size.
The storage used by a file is the size of the current version plus any
older versions that have been set to keep forever.
Show the size of a file as the the storage quota used. This is the
current version plus any older versions that have been set to keep
forever.
**WARNING**: This flag may have some unexpected consequences.
It is not recommended to set this flag in your config - the
recommended usage is using the flag form --drive-size-as-quota when
doing rclone ls/lsl/lsf/lsjson/etc only.
If you do use this flag for syncing (not recommended) then you will
need to use --ignore size also.
- Config: size_as_quota
- Env Var: RCLONE_DRIVE_SIZE_AS_QUOTA
@ -889,6 +914,38 @@ See: https://github.com/rclone/rclone/issues/3631
- Type: bool
- Default: true
#### --drive-stop-on-upload-limit
Make upload limit errors be fatal
At the time of writing it is only possible to upload 750GB of data to
Google Drive a day (this is an undocumented limit). When this limit is
reached Google Drive produces a slightly different error message. When
this flag is set it causes these errors to be fatal. These will stop
the in-progress sync.
Note that this detection is relying on error message strings which
Google don't document so it may break in the future.
See: https://github.com/rclone/rclone/issues/3857
- Config: stop_on_upload_limit
- Env Var: RCLONE_DRIVE_STOP_ON_UPLOAD_LIMIT
- Type: bool
- Default: false
#### --drive-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_DRIVE_ENCODING
- Type: MultiEncoder
- Default: InvalidUtf8
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -174,6 +174,17 @@ Impersonate this user when using a business account.
- Type: string
- Default: ""
#### --dropbox-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_DROPBOX_ENCODING
- Type: MultiEncoder
- Default: Slash,BackSlash,Del,RightSpace,InvalidUtf8,Dot
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -140,4 +140,15 @@ If you want to download a shared folder, add this parameter
- Type: string
- Default: ""
#### --fichier-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_FICHIER_ENCODING
- Type: MultiEncoder
- Default: Slash,LtGt,DoubleQuote,SingleQuote,BackQuote,Dollar,BackSlash,Del,Ctl,LeftSpace,RightSpace,InvalidUtf8,Dot
<!--- autogenerated options stop -->

View File

@ -1,7 +1,7 @@
---
title: "Global Flags"
description: "Rclone Global Flags"
date: "2019-10-26T11:04:03+01:00"
date: "2020-02-01T10:26:53Z"
---
# Global Flags
@ -26,10 +26,10 @@ These flags are available for every command.
-c, --checksum Skip based on checksum (if available) & size, not mod-time & size
--client-cert string Client SSL certificate (PEM) for mutual TLS auth
--client-key string Client SSL private key (PEM) for mutual TLS auth
--compare-dest string use DIR to server side copy flies from.
--compare-dest string Include additional server-side path during comparison.
--config string Config file. (default "$HOME/.config/rclone/rclone.conf")
--contimeout duration Connect timeout (default 1m0s)
--copy-dest string Compare dest to DIR also.
--copy-dest string Implies --compare-dest but also copies files from path into destination.
--cpuprofile string Write cpu profile to file
--delete-after When synchronizing, delete files on destination after transferring (default)
--delete-before When synchronizing, delete files on destination before transferring
@ -43,6 +43,7 @@ These flags are available for every command.
--exclude stringArray Exclude files matching pattern
--exclude-from stringArray Read exclude patterns from file
--exclude-if-present string Exclude directories if filename is present
--expect-continue-timeout duration Timeout when using expect / 100-continue in HTTP (default 1s)
--fast-list Use recursive list if available. Uses more memory but fewer transactions.
--files-from stringArray Read list of source-file names from file
-f, --filter stringArray Add a file-filtering rule
@ -65,6 +66,7 @@ These flags are available for every command.
--max-backlog int Maximum number of objects in sync or check backlog. (default 10000)
--max-delete int When synchronizing, limit the number of deletes (default -1)
--max-depth int If set limits the recursion depth to this. (default -1)
--max-duration duration Maximum duration rclone will transfer data for.
--max-size SizeSuffix Only transfer files smaller than this in k or suffix b|k|M|G (default off)
--max-stats-groups int Maximum number of stats groups to keep in memory. On max oldest is discarded. (default 1000)
--max-transfer SizeSuffix Maximum size of data to transfer. (default off)
@ -75,9 +77,12 @@ These flags are available for every command.
--multi-thread-cutoff SizeSuffix Use multi-thread downloads for files above this size. (default 250M)
--multi-thread-streams int Max number of streams to use for multi-thread downloads. (default 4)
--no-check-certificate Do not verify the server SSL certificate. Insecure.
--no-check-dest Don't check the destination, copy regardless.
--no-gzip-encoding Don't set Accept-Encoding: gzip.
--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, eg 'size,descending'
--password-command SpaceSepList Command for supplying password for encrypted configuration.
-P, --progress Show progress during transfer.
-q, --quiet Print as little stuff as possible
--rc Enable the remote control server.
@ -101,9 +106,9 @@ These flags are available for every command.
--rc-user string User name for authentication.
--rc-web-fetch-url string URL to fetch the releases for webgui. (default "https://api.github.com/repos/rclone/rclone-webui-react/releases/latest")
--rc-web-gui Launch WebGUI on localhost
--rc-web-gui-update Check and update to latest version of web gui
--rc-web-gui-force-update Force update to latest version of web gui
--rc-web-gui-no-open-browser Don't open browser automatically
--rc-web-gui-no-open-browser Don't open the browser automatically
--rc-web-gui-update Check and update to latest version of web gui
--retries int Retry operations this many times if they fail (default 3)
--retries-sleep duration Interval between retrying operations if they fail, e.g 500ms, 60s, 5m. (0 to disable)
--size-only Skip based on size only, not mod-time or checksum
@ -129,7 +134,7 @@ These flags are available for every command.
--use-json-log Use json log format.
--use-mmap Use mmap allocator (see docs).
--use-server-modtime Use server modified time instead of object metadata
--user-agent string Set the user-agent to a specified string. The default is rclone/ version (default "rclone/v1.50.0")
--user-agent string Set the user-agent to a specified string. The default is rclone/ version (default "rclone/v1.51.0")
-v, --verbose count Print lots more stuff (repeat for more)
```
@ -142,6 +147,7 @@ and may be set in the config file.
--acd-auth-url string Auth server URL.
--acd-client-id string Amazon Application Client ID.
--acd-client-secret string Amazon Application Client Secret.
--acd-encoding MultiEncoder This sets the encoding for the backend. (default Slash,InvalidUtf8,Dot)
--acd-templink-threshold SizeSuffix Files >= this size will be downloaded via their tempLink. (default 9G)
--acd-token-url string Token server url.
--acd-upload-wait-per-gb Duration Additional time per GB to wait after a failed complete upload to see if it appears. (default 3m0s)
@ -149,6 +155,7 @@ and may be set in the config file.
--azureblob-access-tier string Access tier of blob: hot, cool or archive.
--azureblob-account string Storage Account Name (leave blank to use SAS URL or Emulator)
--azureblob-chunk-size SizeSuffix Upload chunk size (<= 100MB). (default 4M)
--azureblob-encoding MultiEncoder This sets the encoding for the backend. (default Slash,BackSlash,Del,Ctl,RightPeriod,InvalidUtf8)
--azureblob-endpoint string Endpoint for the service
--azureblob-key string Storage Account Key (leave blank to use SAS URL or Emulator)
--azureblob-list-chunk int Size of blob list. (default 5000)
@ -160,6 +167,7 @@ and may be set in the config file.
--b2-disable-checksum Disable checksums for large (> upload cutoff) files
--b2-download-auth-duration Duration Time before the authorization token will expire in s or suffix ms|s|m|h|d. (default 1w)
--b2-download-url string Custom endpoint for downloads.
--b2-encoding MultiEncoder This sets the encoding for the backend. (default Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
--b2-endpoint string Endpoint for the service.
--b2-hard-delete Permanently delete files on remote removal, otherwise hide files.
--b2-key string Application Key
@ -171,6 +179,7 @@ and may be set in the config file.
--box-client-id string Box App Client Id.
--box-client-secret string Box App Client Secret
--box-commit-retries int Max number of times to try committing a multipart file. (default 100)
--box-encoding MultiEncoder This sets the encoding for the backend. (default Slash,BackSlash,Del,Ctl,RightSpace,InvalidUtf8,Dot)
--box-upload-cutoff SizeSuffix Cutoff for switching to multipart upload (>= 50MB). (default 50M)
--cache-chunk-clean-interval Duration How often should the cache perform cleanups of the chunk storage. (default 1m0s)
--cache-chunk-no-memory Disable the in-memory cache for storing chunks during streaming.
@ -214,6 +223,7 @@ and may be set in the config file.
--drive-client-id string Google Application Client Id
--drive-client-secret string Google Application Client Secret
--drive-disable-http2 Disable drive using http2 (default true)
--drive-encoding MultiEncoder This sets the encoding for the backend. (default InvalidUtf8)
--drive-export-formats string Comma separated list of preferred formats for downloading Google docs. (default "docx,xlsx,pptx,svg")
--drive-formats string Deprecated: see export_formats
--drive-impersonate string Impersonate this user when using a service account.
@ -228,23 +238,28 @@ and may be set in the config file.
--drive-service-account-credentials string Service Account Credentials JSON blob
--drive-service-account-file string Service Account Credentials JSON file path
--drive-shared-with-me Only show files that are shared with me.
--drive-size-as-quota Show storage quota usage for file size.
--drive-size-as-quota Show sizes as storage quota usage, not actual size.
--drive-skip-checksum-gphotos Skip MD5 checksum on Google photos and videos only.
--drive-skip-gdocs Skip google documents in all listings.
--drive-stop-on-upload-limit Make upload limit errors be fatal
--drive-team-drive string ID of the Team Drive
--drive-trashed-only Only show files that are in the trash.
--drive-upload-cutoff SizeSuffix Cutoff for switching to chunked upload (default 8M)
--drive-use-created-date Use file created date instead of modified date.,
--drive-use-shared-date Use date file was shared instead of modified date.
--drive-use-trash Send files to the trash instead of deleting permanently. (default true)
--drive-v2-download-min-size SizeSuffix If Object's are greater, use drive v2 API to download. (default off)
--dropbox-chunk-size SizeSuffix Upload chunk size. (< 150M). (default 48M)
--dropbox-client-id string Dropbox App Client Id
--dropbox-client-secret string Dropbox App Client Secret
--dropbox-encoding MultiEncoder This sets the encoding for the backend. (default Slash,BackSlash,Del,RightSpace,InvalidUtf8,Dot)
--dropbox-impersonate string Impersonate this user when using a business account.
--fichier-api-key string Your API Key, get it from https://1fichier.com/console/params.pl
--fichier-encoding MultiEncoder This sets the encoding for the backend. (default Slash,LtGt,DoubleQuote,SingleQuote,BackQuote,Dollar,BackSlash,Del,Ctl,LeftSpace,RightSpace,InvalidUtf8,Dot)
--fichier-shared-folder string If you want to download a shared folder, add this parameter
--ftp-concurrency int Maximum number of FTP simultaneous connections, 0 for unlimited
--ftp-disable-epsv Disable using EPSV even if server advertises support
--ftp-encoding MultiEncoder This sets the encoding for the backend. (default Slash,Del,Ctl,RightSpace,Dot)
--ftp-host string FTP host to connect to
--ftp-no-check-certificate Do not verify the TLS certificate of the server
--ftp-pass string FTP password
@ -255,6 +270,7 @@ and may be set in the config file.
--gcs-bucket-policy-only Access checks should use bucket-level IAM policies.
--gcs-client-id string Google Application Client Id
--gcs-client-secret string Google Application Client Secret
--gcs-encoding MultiEncoder This sets the encoding for the backend. (default Slash,CrLf,InvalidUtf8,Dot)
--gcs-location string Location for the newly created buckets.
--gcs-object-acl string Access Control List for new objects.
--gcs-project-number string Project number.
@ -271,11 +287,14 @@ and may be set in the config file.
--hubic-chunk-size SizeSuffix Above this size files will be chunked into a _segments container. (default 5G)
--hubic-client-id string Hubic Client Id
--hubic-client-secret string Hubic Client Secret
--hubic-encoding MultiEncoder This sets the encoding for the backend. (default Slash,InvalidUtf8)
--hubic-no-chunk Don't chunk files during streaming upload.
--jottacloud-encoding MultiEncoder This sets the encoding for the backend. (default Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,Del,Ctl,InvalidUtf8,Dot)
--jottacloud-hard-delete Delete files permanently rather than putting them into the trash.
--jottacloud-md5-memory-limit SizeSuffix Files bigger than this will be cached on disk to calculate the MD5 if required. (default 10M)
--jottacloud-unlink Remove existing public link to file/folder with link command rather than creating.
--jottacloud-upload-resume-limit SizeSuffix Files bigger than this can be resumed if the upload fail's. (default 10M)
--koofr-encoding MultiEncoder This sets the encoding for the backend. (default Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
--koofr-endpoint string The Koofr API endpoint to use (default "https://app.koofr.net")
--koofr-mountid string Mount ID of the mount to use. If omitted, the primary mount is used.
--koofr-password string Your Koofr password for rclone (generate one at https://app.koofr.net/app/admin/preferences/password)
@ -284,10 +303,12 @@ and may be set in the config file.
-l, --links Translate symlinks to/from regular files with a '.rclonelink' extension
--local-case-insensitive Force the filesystem to report itself as case insensitive
--local-case-sensitive Force the filesystem to report itself as case sensitive.
--local-encoding MultiEncoder This sets the encoding for the backend. (default Slash,Dot)
--local-no-check-updated Don't check to see if the files change during upload
--local-no-unicode-normalization Don't apply unicode normalization to paths and filenames (Deprecated)
--local-nounc string Disable UNC (long path names) conversion on Windows
--mailru-check-hash What should copy do if file checksum is mismatched or invalid (default true)
--mailru-encoding MultiEncoder This sets the encoding for the backend. (default Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,InvalidUtf8,Dot)
--mailru-pass string Password
--mailru-speedup-enable Skip full upload if there is another file with same data hash. (default true)
--mailru-speedup-file-patterns string Comma separated list of file name patterns eligible for speedup (put by hash). (default "*.mkv,*.avi,*.mp4,*.mp3,*.zip,*.gz,*.rar,*.pdf")
@ -295,6 +316,7 @@ and may be set in the config file.
--mailru-speedup-max-memory SizeSuffix Files larger than the size given below will always be hashed on disk. (default 32M)
--mailru-user string User name (usually email)
--mega-debug Output more debug from Mega.
--mega-encoding MultiEncoder This sets the encoding for the backend. (default Slash,InvalidUtf8,Dot)
--mega-hard-delete Delete files permanently rather than putting them into the trash.
--mega-pass string Password.
--mega-user string User name
@ -304,14 +326,21 @@ and may be set in the config file.
--onedrive-client-secret string Microsoft App Client Secret
--onedrive-drive-id string The ID of the drive to use
--onedrive-drive-type string The type of the drive ( personal | business | documentLibrary )
--onedrive-encoding MultiEncoder This sets the encoding for the backend. (default Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,Hash,Percent,BackSlash,Del,Ctl,LeftSpace,LeftTilde,RightSpace,RightPeriod,InvalidUtf8,Dot)
--onedrive-expose-onenote-files Set to make OneNote files show up in directory listings.
--opendrive-chunk-size SizeSuffix Files will be uploaded in chunks this size. (default 10M)
--opendrive-encoding MultiEncoder This sets the encoding for the backend. (default Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,LeftSpace,LeftCrLfHtVt,RightSpace,RightCrLfHtVt,InvalidUtf8,Dot)
--opendrive-password string Password.
--opendrive-username string Username
--pcloud-client-id string Pcloud App Client Id
--pcloud-client-secret string Pcloud App Client Secret
--pcloud-encoding MultiEncoder This sets the encoding for the backend. (default Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
--premiumizeme-encoding MultiEncoder This sets the encoding for the backend. (default Slash,DoubleQuote,BackSlash,Del,Ctl,InvalidUtf8,Dot)
--putio-encoding MultiEncoder This sets the encoding for the backend. (default Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
--qingstor-access-key-id string QingStor Access Key ID
--qingstor-chunk-size SizeSuffix Chunk size to use for uploading. (default 4M)
--qingstor-connection-retries int Number of connection retries. (default 3)
--qingstor-encoding MultiEncoder This sets the encoding for the backend. (default Slash,Ctl,InvalidUtf8)
--qingstor-endpoint string Enter a endpoint URL to connection QingStor API.
--qingstor-env-auth Get QingStor credentials from runtime. Only applies if access_key_id and secret_access_key is blank.
--qingstor-secret-access-key string QingStor Secret Access Key (password)
@ -322,11 +351,14 @@ and may be set in the config file.
--s3-acl string Canned ACL used when creating buckets and storing or copying objects.
--s3-bucket-acl string Canned ACL used when creating buckets.
--s3-chunk-size SizeSuffix Chunk size to use for uploading. (default 5M)
--s3-copy-cutoff SizeSuffix Cutoff for switching to multipart copy (default 5G)
--s3-disable-checksum Don't store MD5 checksum with object metadata
--s3-encoding MultiEncoder This sets the encoding for the backend. (default Slash,InvalidUtf8,Dot)
--s3-endpoint string Endpoint for S3 API.
--s3-env-auth Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
--s3-force-path-style If true use path style access if false use virtual hosted style. (default true)
--s3-leave-parts-on-error If true avoid calling abort upload on a failure, leaving all successfully uploaded parts on S3 for manual recovery.
--s3-list-chunk int Size of listing chunk (response list for each ListObject S3 request). (default 1000)
--s3-location-constraint string Location constraint - must be set to match the Region.
--s3-provider string Choose your S3 provider.
--s3-region string Region to connect to.
@ -351,13 +383,26 @@ and may be set in the config file.
--sftp-port string SSH port, leave blank to use default (22)
--sftp-set-modtime Set the modified time on the remote if set. (default true)
--sftp-sha1sum-command string The command used to read sha1 hashes. Leave blank for autodetect.
--sftp-skip-links Set to skip any symlinks and any other non regular files.
--sftp-use-insecure-cipher Enable the use of insecure ciphers and key exchange methods.
--sftp-user string SSH username, leave blank for current username, ncw
--sharefile-chunk-size SizeSuffix Upload chunk size. Must a power of 2 >= 256k. (default 64M)
--sharefile-encoding MultiEncoder This sets the encoding for the backend. (default Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Ctl,LeftSpace,LeftPeriod,RightSpace,RightPeriod,InvalidUtf8,Dot)
--sharefile-endpoint string Endpoint for API calls.
--sharefile-root-folder-id string ID of the root folder
--sharefile-upload-cutoff SizeSuffix Cutoff for switching to multipart upload. (default 128M)
--skip-links Don't warn about skipped symlinks.
--sugarsync-access-key-id string Sugarsync Access Key ID.
--sugarsync-app-id string Sugarsync App ID.
--sugarsync-authorization string Sugarsync authorization
--sugarsync-authorization-expiry string Sugarsync authorization expiry
--sugarsync-deleted-id string Sugarsync deleted folder id
--sugarsync-encoding MultiEncoder This sets the encoding for the backend. (default Slash,Ctl,InvalidUtf8,Dot)
--sugarsync-hard-delete Permanently delete files if true
--sugarsync-private-access-key string Sugarsync Private Access Key
--sugarsync-refresh-token string Sugarsync refresh token
--sugarsync-root-id string Sugarsync root id
--sugarsync-user string Sugarsync user
--swift-application-credential-id string Application Credential ID (OS_APPLICATION_CREDENTIAL_ID)
--swift-application-credential-name string Application Credential Name (OS_APPLICATION_CREDENTIAL_NAME)
--swift-application-credential-secret string Application Credential Secret (OS_APPLICATION_CREDENTIAL_SECRET)
@ -366,6 +411,7 @@ and may be set in the config file.
--swift-auth-version int AuthVersion - optional - set to (1,2,3) if your auth URL has no version (ST_AUTH_VERSION)
--swift-chunk-size SizeSuffix Above this size files will be chunked into a _segments container. (default 5G)
--swift-domain string User domain - optional (v3 auth) (OS_USER_DOMAIN_NAME)
--swift-encoding MultiEncoder This sets the encoding for the backend. (default Slash,InvalidUtf8)
--swift-endpoint-type string Endpoint type to choose from the service catalogue (OS_ENDPOINT_TYPE) (default "public")
--swift-env-auth Get swift credentials from environment variables in standard OpenStack form.
--swift-key string API key or password (OS_PASSWORD).
@ -387,5 +433,6 @@ and may be set in the config file.
--webdav-vendor string Name of the Webdav site/service/software you are using
--yandex-client-id string Yandex Client Id
--yandex-client-secret string Yandex Client Secret
--yandex-encoding MultiEncoder This sets the encoding for the backend. (default Slash,Del,Ctl,InvalidUtf8,Dot)
--yandex-unlink Remove existing public link to file/folder with link command rather than creating.
```

View File

@ -212,6 +212,17 @@ Disable using EPSV even if server advertises support
- Type: bool
- Default: false
#### --ftp-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_FTP_ENCODING
- Type: MultiEncoder
- Default: Slash,Del,Ctl,RightSpace,Dot
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -425,4 +425,19 @@ The storage class to use when storing objects in Google Cloud Storage.
- "DURABLE_REDUCED_AVAILABILITY"
- Durable reduced availability storage class
### Advanced Options
Here are the advanced options specific to google cloud storage (Google Cloud Storage (this is not Google Drive)).
#### --gcs-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_GCS_ENCODING
- Type: MultiEncoder
- Default: Slash,CrLf,InvalidUtf8,Dot
<!--- autogenerated options stop -->

View File

@ -165,6 +165,17 @@ copy operations.
- Type: bool
- Default: false
#### --hubic-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_HUBIC_ENCODING
- Type: MultiEncoder
- Default: Slash,InvalidUtf8
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -202,6 +202,17 @@ Files bigger than this can be resumed if the upload fail's.
- Type: SizeSuffix
- Default: 10M
#### --jottacloud-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_JOTTACLOUD_ENCODING
- Type: MultiEncoder
- Default: Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,Del,Ctl,InvalidUtf8,Dot
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -152,6 +152,17 @@ Does the backend support setting modification time. Set this to false if you use
- Type: bool
- Default: true
#### --koofr-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_KOOFR_ENCODING
- Type: MultiEncoder
- Default: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -413,4 +413,15 @@ to override the default choice.
- Type: bool
- Default: false
#### --local-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_LOCAL_ENCODING
- Type: MultiEncoder
- Default: Slash,Dot
<!--- autogenerated options stop -->

View File

@ -300,4 +300,15 @@ Supported quirks: atomicmkdir binlist gzip insecure retry400
- Type: string
- Default: ""
#### --mailru-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_MAILRU_ENCODING
- Type: MultiEncoder
- Default: Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,InvalidUtf8,Dot
<!--- autogenerated options stop -->

View File

@ -203,6 +203,17 @@ permanently delete objects instead.
- Type: bool
- Default: false
#### --mega-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_MEGA_ENCODING
- Type: MultiEncoder
- Default: Slash,InvalidUtf8,Dot
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -267,6 +267,17 @@ listing, set this option.
- Type: bool
- Default: false
#### --onedrive-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_ONEDRIVE_ENCODING
- Type: MultiEncoder
- Default: Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,Hash,Percent,BackSlash,Del,Ctl,LeftSpace,LeftTilde,RightSpace,RightPeriod,InvalidUtf8,Dot
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -122,6 +122,33 @@ Password.
- Type: string
- Default: ""
### Advanced Options
Here are the advanced options specific to opendrive (OpenDrive).
#### --opendrive-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_OPENDRIVE_ENCODING
- Type: MultiEncoder
- Default: Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,LeftSpace,LeftCrLfHtVt,RightSpace,RightCrLfHtVt,InvalidUtf8,Dot
#### --opendrive-chunk-size
Files will be uploaded in chunks this size.
Note that these chunks are buffered in memory so increasing them will
increase memory use.
- Config: chunk_size
- Env Var: RCLONE_OPENDRIVE_CHUNK_SIZE
- Type: SizeSuffix
- Default: 10M
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -137,4 +137,19 @@ Leave blank normally.
- Type: string
- Default: ""
### Advanced Options
Here are the advanced options specific to pcloud (Pcloud).
#### --pcloud-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_PCLOUD_ENCODING
- Type: MultiEncoder
- Default: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot
<!--- autogenerated options stop -->

View File

@ -118,6 +118,21 @@ This is not normally used - use oauth instead.
- Type: string
- Default: ""
### Advanced Options
Here are the advanced options specific to premiumizeme (premiumize.me).
#### --premiumizeme-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_PREMIUMIZEME_ENCODING
- Type: MultiEncoder
- Default: Slash,DoubleQuote,BackSlash,Del,Ctl,InvalidUtf8,Dot
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -109,4 +109,19 @@ Invalid UTF-8 bytes will also be [replaced](/overview/#invalid-utf8),
as they can't be used in JSON strings.
<!--- autogenerated options start - DO NOT EDIT, instead edit fs.RegInfo in backend/putio/putio.go then run make backenddocs -->
### Advanced Options
Here are the advanced options specific to putio (Put.io).
#### --putio-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_PUTIO_ENCODING
- Type: MultiEncoder
- Default: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot
<!--- autogenerated options stop -->

View File

@ -266,4 +266,15 @@ this may help to speed up the transfers.
- Type: int
- Default: 1
#### --qingstor-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_QINGSTOR_ENCODING
- Type: MultiEncoder
- Default: Slash,Ctl,InvalidUtf8
<!--- autogenerated options stop -->

View File

@ -531,9 +531,17 @@ Returns the following values:
Values for "transferring", "checking" and "lastError" are only assigned if data is available.
The value for "eta" is null if an eta cannot be determined.
### core/stats-delete: Delete stats group. {#core/stats-delete}
This deletes entire stats group
Parameters
- group - name of the stats group (string)
### core/stats-reset: Reset stats. {#core/stats-reset}
This clears counters, errors and finished transfers for all stats or specific
This clears counters, errors and finished transfers for all stats or specific
stats group if group is provided.
Parameters

View File

@ -566,7 +566,7 @@ Region to connect to.
- Asia Pacific (Mumbai)
- Needs location constraint ap-south-1.
- "ap-east-1"
- Asia Pacific (Hong Kong) Region
- Asia Patific (Hong Kong) Region
- Needs location constraint ap-east-1.
- "sa-east-1"
- South America (Sao Paulo) Region
@ -1051,8 +1051,10 @@ The minimum is 0 and the maximum is 5GB.
Chunk size to use for uploading.
When uploading files larger than upload_cutoff they will be uploaded
as multipart uploads using this chunk size.
When uploading files larger than upload_cutoff or files with unknown
size (eg from "rclone rcat" or uploaded with "rclone mount" or google
photos or google docs) they will be uploaded as multipart uploads
using this chunk size.
Note that "--s3-upload-concurrency" chunks of this size are buffered
in memory per transfer.
@ -1060,11 +1062,34 @@ in memory per transfer.
If you are transferring large files over high speed links and you have
enough memory, then increasing this will speed up the transfers.
Rclone will automatically increase the chunk size when uploading a
large file of known size to stay below the 10,000 chunks limit.
Files of unknown size are uploaded with the configured
chunk_size. Since the default chunk size is 5MB and there can be at
most 10,000 chunks, this means that by default the maximum size of
file you can stream upload is 48GB. If you wish to stream upload
larger files then you will need to increase chunk_size.
- Config: chunk_size
- Env Var: RCLONE_S3_CHUNK_SIZE
- Type: SizeSuffix
- Default: 5M
#### --s3-copy-cutoff
Cutoff for switching to multipart copy
Any files larger than this that need to be server side copied will be
copied in chunks of this size.
The minimum is 0 and the maximum is 5GB.
- Config: copy_cutoff
- Env Var: RCLONE_S3_COPY_CUTOFF
- Type: SizeSuffix
- Default: 5G
#### --s3-disable-checksum
Don't store MD5 checksum with object metadata
@ -1108,7 +1133,9 @@ if false then rclone will use virtual path style. See [the AWS S3
docs](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro)
for more info.
Some providers (eg Aliyun OSS or Netease COS) require this set to false.
Some providers (eg AWS, Aliyun OSS or Netease COS) require this set to
false - rclone will do this automatically based on the provider
setting.
- Config: force_path_style
- Env Var: RCLONE_S3_FORCE_PATH_STYLE
@ -1169,6 +1196,17 @@ In Ceph, this can be increased with the "rgw list buckets max chunk" option.
- Type: int
- Default: 1000
#### --s3-encoding
This sets the encoding for the backend.
See: the [encoding section in the overview](/overview/#encoding) for more info.
- Config: encoding
- Env Var: RCLONE_S3_ENCODING
- Type: MultiEncoder
- Default: Slash,InvalidUtf8,Dot
<!--- autogenerated options stop -->
### Anonymous access to public buckets ###

View File

@ -320,6 +320,15 @@ The command used to read sha1 hashes. Leave blank for autodetect.
- Type: string
- Default: ""
#### --sftp-skip-links
Set to skip any symlinks and any other non regular files.
- Config: skip_links
- Env Var: RCLONE_SFTP_SKIP_LINKS
- Type: bool
- Default: false
<!--- autogenerated options stop -->
### Limitations ###

Some files were not shown because too many files have changed in this diff Show More