Version v1.50.0

s3-about
Nick Craig-Wood 2019-10-26 11:04:54 +01:00
parent ab895390f4
commit 6fabf476cf
88 changed files with 27557 additions and 23192 deletions

14056
MANUAL.html generated

File diff suppressed because one or more lines are too long

1997
MANUAL.md generated

File diff suppressed because it is too large Load Diff

14067
MANUAL.txt generated

File diff suppressed because it is too large Load Diff

View File

@ -96,6 +96,11 @@ update:
GO111MODULE=on go mod tidy
GO111MODULE=on go mod vendor
# Tidy the module dependencies
tidy:
GO111MODULE=on go mod tidy
GO111MODULE=on go mod vendor
doc: rclone.1 MANUAL.html MANUAL.txt rcdocs commanddocs
rclone.1: MANUAL.md

View File

@ -15,6 +15,7 @@ This file describes how to make the various kinds of releases
* make test # see integration test server or run locally
* make tag
* edit docs/content/changelog.md
* make tidy
* make doc
* git status - to check for new man pages - git add them
* git commit -a -v -m "Version v1.XX.0"

View File

@ -1 +1 @@
v1.49.5
v1.50.0

View File

@ -252,6 +252,30 @@ Leave blank normally.
- Type: string
- Default: ""
#### --box-box-config-file
Box App config.json location
Leave blank normally.
- Config: box_config_file
- Env Var: RCLONE_BOX_BOX_CONFIG_FILE
- Type: string
- Default: ""
#### --box-box-sub-type
- Config: box_sub_type
- Env Var: RCLONE_BOX_BOX_SUB_TYPE
- Type: string
- Default: "user"
- Examples:
- "user"
- Rclone should act on behalf of a user
- "enterprise"
- Rclone should act on behalf of a service account
### Advanced Options
Here are the advanced options specific to box (Box).

View File

@ -1,11 +1,118 @@
---
title: "Documentation"
description: "Rclone Changelog"
date: "2019-10-05"
date: "2019-10-26"
---
# Changelog
## v1.50.0 - 2019-10-26
* New backends
* [Citrix Sharefile](/sharefile) (Nick Craig-Wood)
* [Chunker](/chunker) - an overlay backend to split files into smaller parts (Ivan Andreev)
* [Mail.ru Cloud](/mailru) (Ivan Andreev)
* New Features
* encodings (Fabian Möller & Nick Craig-Wood)
* All backends now use file name encoding to ensure any file name can be written to any backend.
* See the [restricted file name docs](/overview/#restricted-filenames) for more info and the [local backend docs](/local/#filenames).
* Some file names may look different in rclone if you are using any control characters in names or [unicode FULLWIDTH symbols](https://en.wikipedia.org/wiki/Halfwidth_and_Fullwidth_Forms_(Unicode_block)).
* build
* Update to use go1.13 for the build (Nick Craig-Wood)
* Drop support for go1.9 (Nick Craig-Wood)
* Build rclone with GitHub actions (Nick Craig-Wood)
* Convert python scripts to python3 (Nick Craig-Wood)
* Swap Azure/go-ansiterm for mattn/go-colorable (Nick Craig-Wood)
* Dockerfile fixes (Matei David)
* Add [plugin support](https://github.com/rclone/rclone/blob/master/CONTRIBUTING.md#writing-a-plugin) for backends and commands (Richard Patel)
* config
* Use alternating Red/Green in config to make more obvious (Nick Craig-Wood)
* contrib
* Add sample DLNA server Docker Compose manifest. (pataquets)
* Add sample WebDAV server Docker Compose manifest. (pataquets)
* copyurl
* Add `--auto-filename` flag for using file name from URL in destination path (Denis)
* serve dlna:
* Many compatability improvements (Dan Walters)
* Support for external srt subtitles (Dan Walters)
* rc
* Added command core/quit (Saksham Khanna)
* Bug Fixes
* sync
* Make `--update`/`-u` not transfer files that haven't changed (Nick Craig-Wood)
* Free objects after they come out of the transfer pipe to save memory (Nick Craig-Wood)
* Fix `--files-from without --no-traverse` doing a recursive scan (Nick Craig-Wood)
* operations
* Fix accounting for server side copies (Nick Craig-Wood)
* Display 'All duplicates removed' only if dedupe successful (Sezal Agrawal)
* Display 'Deleted X extra copies' only if dedupe successful (Sezal Agrawal)
* accounting
* Only allow up to 100 completed transfers in the accounting list to save memory (Nick Craig-Wood)
* Cull the old time ranges when possible to save memory (Nick Craig-Wood)
* Fix panic due to server-side copy fallback (Ivan Andreev)
* Fix memory leak noticeable for transfers of large numbers of objects (Nick Craig-Wood)
* Fix total duration calculation (Nick Craig-Wood)
* cmd
* Fix environment variables not setting command line flags (Nick Craig-Wood)
* Make autocomplete compatible with bash's posix mode for macOS (Danil Semelenov)
* Make `--progress` work in git bash on Windows (Nick Craig-Wood)
* Fix 'compopt: command not found' on autocomplete on macOS (Danil Semelenov)
* config
* Fix setting of non top level flags from environment variables (Nick Craig-Wood)
* Check config names more carefully and report errors (Nick Craig-Wood)
* Remove error: can't use `--size-only` and `--ignore-size` together. (Nick Craig-Wood)
* filter: Prevent mixing options when `--files-from` is in use (Michele Caci)
* serve sftp: Fix crash on unsupported operations (eg Readlink) (Nick Craig-Wood)
* Mount
* Allow files of unkown size to be read properly (Nick Craig-Wood)
* Skip tests on <= 2 CPUs to avoid lockup (Nick Craig-Wood)
* Fix panic on File.Open (Nick Craig-Wood)
* Fix "mount_fusefs: -o timeout=: option not supported" on FreeBSD (Nick Craig-Wood)
* Don't pass huge filenames (>4k) to FUSE as it can't cope (Nick Craig-Wood)
* VFS
* Add flag `--vfs-case-insensitive` for windows/macOS mounts (Ivan Andreev)
* Make objects of unknown size readable through the VFS (Nick Craig-Wood)
* Move writeback of dirty data out of close() method into its own method (FlushWrites) and remove close() call from Flush() (Brett Dutro)
* Stop empty dirs disappearing when renamed on bucket based remotes (Nick Craig-Wood)
* Stop change notify polling clearing so much of the directory cache (Nick Craig-Wood)
* Azure Blob
* Disable logging to the Windows event log (Nick Craig-Wood)
* B2
* Remove `unverified:` prefix on sha1 to improve interop (eg with CyberDuck) (Nick Craig-Wood)
* Box
* Add options to get access token via JWT auth (David)
* Drive
* Disable HTTP/2 by default to work around INTERNAL_ERROR problems (Nick Craig-Wood)
* Make sure that drive root ID is always canonical (Nick Craig-Wood)
* Fix `--drive-shared-with-me` from the root with lsand `--fast-list` (Nick Craig-Wood)
* Fix ChangeNotify polling for shared drives (Nick Craig-Wood)
* Fix change notify polling when using appDataFolder (Nick Craig-Wood)
* Dropbox
* Make disallowed filenames errors not retry (Nick Craig-Wood)
* Fix nil pointer exception on restricted files (Nick Craig-Wood)
* Fichier
* Fix accessing files > 2GB on 32 bit systems (Nick Craig-Wood)
* FTP
* Allow disabling EPSV mode (Jon Fautley)
* HTTP
* HEAD directory entries in parallel to speedup (Nick Craig-Wood)
* Add `--http-no-head` to stop rclone doing HEAD in listings (Nick Craig-Wood)
* Putio
* Add ability to resume uploads (Cenk Alti)
* S3
* Fix signature v2_auth headers (Anthony Rusdi)
* Fix encoding for control characters (Nick Craig-Wood)
* Only ask for URL encoded directory listings if we need them on Ceph (Nick Craig-Wood)
* Add option for multipart failiure behaviour (Aleksandar Jankovic)
* Support for multipart copy (庄天翼)
* Fix nil pointer reference if no metadata returned for object (Nick Craig-Wood)
* SFTP
* Fix `--sftp-ask-password` trying to contact the ssh agent (Nick Craig-Wood)
* Fix hashes of files with backslashes (Nick Craig-Wood)
* Include more ciphers with `--sftp-use-insecure-cipher` (Carlos Ferreyra)
* WebDAV
* Parse and return Sharepoint error response (Henning Surmeier)
## v1.49.5 - 2019-10-05
* Bug Fixes
@ -36,17 +143,15 @@ date: "2019-10-05"
* New Features
* build: Add Docker workflow support (Alfonso Montero)
* Bug Fixes
* accounting: Fix locking in Transfer to avoid deadlock with --progress (Nick Craig-Wood)
* accounting: Fix locking in Transfer to avoid deadlock with `--progress` (Nick Craig-Wood)
* docs: Fix template argument for mktemp in install.sh (Cnly)
* operations: Fix -u/--update with google photos / files of unknown size (Nick Craig-Wood)
* operations: Fix `-u`/`--update` with google photos / files of unknown size (Nick Craig-Wood)
* rc: Fix docs for config/create /update /password (Nick Craig-Wood)
* Google Cloud Storage
* Fix need for elevated permissions on SetModTime (Nick Craig-Wood)
## v1.49.1 - 2019-08-28
Point release to fix config bug and google photos backend.
* Bug Fixes
* config: Fix generated passwords being stored as empty password (Nick Craig-Wood)
* rcd: Added missing parameter for web-gui info logs. (Chaitanya)

View File

@ -293,7 +293,7 @@ in the same directory).
<!--- autogenerated options start - DO NOT EDIT, instead edit fs.RegInfo in backend/chunker/chunker.go then run make backenddocs -->
### Standard Options
Here are the standard options specific to chunker.
Here are the standard options specific to chunker (Transparently chunk/split large files).
#### --chunker-remote
@ -341,7 +341,7 @@ Choose how chunker handles hash sums. All modes but "none" require metadata.
### Advanced Options
Here are the advanced options specific to chunker.
Here are the advanced options specific to chunker (Transparently chunk/split large files).
#### --chunker-name-format

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone"
slug: rclone
url: /commands/rclone/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone about"
slug: rclone_about
url: /commands/rclone_about/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone authorize"
slug: rclone_authorize
url: /commands/rclone_authorize/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone cachestats"
slug: rclone_cachestats
url: /commands/rclone_cachestats/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone cat"
slug: rclone_cat
url: /commands/rclone_cat/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone check"
slug: rclone_check
url: /commands/rclone_check/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone cleanup"
slug: rclone_cleanup
url: /commands/rclone_cleanup/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone config"
slug: rclone_config
url: /commands/rclone_config/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone config create"
slug: rclone_config_create
url: /commands/rclone_config_create/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone config delete"
slug: rclone_config_delete
url: /commands/rclone_config_delete/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone config disconnect"
slug: rclone_config_disconnect
url: /commands/rclone_config_disconnect/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone config dump"
slug: rclone_config_dump
url: /commands/rclone_config_dump/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone config edit"
slug: rclone_config_edit
url: /commands/rclone_config_edit/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone config file"
slug: rclone_config_file
url: /commands/rclone_config_file/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone config password"
slug: rclone_config_password
url: /commands/rclone_config_password/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone config providers"
slug: rclone_config_providers
url: /commands/rclone_config_providers/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone config reconnect"
slug: rclone_config_reconnect
url: /commands/rclone_config_reconnect/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone config show"
slug: rclone_config_show
url: /commands/rclone_config_show/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone config update"
slug: rclone_config_update
url: /commands/rclone_config_update/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone config userinfo"
slug: rclone_config_userinfo
url: /commands/rclone_config_userinfo/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone copy"
slug: rclone_copy
url: /commands/rclone_copy/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone copyto"
slug: rclone_copyto
url: /commands/rclone_copyto/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone copyurl"
slug: rclone_copyurl
url: /commands/rclone_copyurl/
@ -14,6 +14,8 @@ Copy url content to dest.
Download urls content and copy it to destination
without saving it in tmp storage.
Setting --auto-filename flag will cause retrieving file name from url and using it in destination path.
```
rclone copyurl https://example.com dest:path [flags]

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone cryptcheck"
slug: rclone_cryptcheck
url: /commands/rclone_cryptcheck/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone cryptdecode"
slug: rclone_cryptdecode
url: /commands/rclone_cryptdecode/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone dbhashsum"
slug: rclone_dbhashsum
url: /commands/rclone_dbhashsum/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone dedupe"
slug: rclone_dedupe
url: /commands/rclone_dedupe/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone delete"
slug: rclone_delete
url: /commands/rclone_delete/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone deletefile"
slug: rclone_deletefile
url: /commands/rclone_deletefile/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone genautocomplete"
slug: rclone_genautocomplete
url: /commands/rclone_genautocomplete/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone genautocomplete bash"
slug: rclone_genautocomplete_bash
url: /commands/rclone_genautocomplete_bash/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone genautocomplete zsh"
slug: rclone_genautocomplete_zsh
url: /commands/rclone_genautocomplete_zsh/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone gendocs"
slug: rclone_gendocs
url: /commands/rclone_gendocs/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone hashsum"
slug: rclone_hashsum
url: /commands/rclone_hashsum/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone link"
slug: rclone_link
url: /commands/rclone_link/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone listremotes"
slug: rclone_listremotes
url: /commands/rclone_listremotes/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone ls"
slug: rclone_ls
url: /commands/rclone_ls/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone lsd"
slug: rclone_lsd
url: /commands/rclone_lsd/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone lsf"
slug: rclone_lsf
url: /commands/rclone_lsf/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone lsjson"
slug: rclone_lsjson
url: /commands/rclone_lsjson/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone lsl"
slug: rclone_lsl
url: /commands/rclone_lsl/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone md5sum"
slug: rclone_md5sum
url: /commands/rclone_md5sum/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone mkdir"
slug: rclone_mkdir
url: /commands/rclone_mkdir/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone mount"
slug: rclone_mount
url: /commands/rclone_mount/
@ -287,46 +287,11 @@ This mode should support all normal file system operations.
If an upload or download fails it will be retried up to
--low-level-retries times.
```
rclone mount remote:path /path/to/mountpoint [flags]
```
### Case Sensitivity
Linux file systems are case-sensitive: two files can differ only
by case, and the exact case must be used when opening a file.
Windows is not like most other operating systems supported by rclone.
File systems in modern Windows are case-insensitive but case-preserving:
although existing files can be opened using any case, the exact case used
to create the file is preserved and available for programs to query.
It is not allowed for two files in the same directory to differ only by case.
Usually file systems on MacOS are case-insensitive. It is possible to make MacOS
file systems case-sensitive but that is not the default
The `--vfs-case-insensitive` mount flag controls how rclone handles these
two cases. If its value is `false`, rclone passes file names to the mounted
file system as is. If the flag is `true` (or appears without a value on
command line), rclone may perform a "fixup" as explained below.
The user may specify a file name to open/delete/rename/etc with a case
different than what is stored on mounted file system. If an argument refers
to an existing file with exactly the same name, then the case of the existing
file on the disk will be used. However, if a file name with exactly the same
name is not found but a name differing only by case exists, rclone will
transparently fixup the name. This fixup happens only when an existing file
is requested. Case sensitivity of file names created anew by rclone is
controlled by an underlying mounted file system.
Note that case sensitivity of the operating system running rclone (the target)
may differ from case sensitivity of a file system mounted by rclone (the source).
The flag controls whether "fixup" is performed to satisfy the target.
If the flag is not provided on command line, then its default value depends
on the operating system where rclone runs: `true` on Windows and MacOS, `false`
otherwise. If the flag is provided without a value, then it is `true`.
### Options
```
@ -357,7 +322,7 @@ otherwise. If the flag is provided without a value, then it is `true`.
--vfs-cache-max-size SizeSuffix Max total size of objects in the cache. (default off)
--vfs-cache-mode CacheMode Cache mode off|minimal|writes|full (default off)
--vfs-cache-poll-interval duration Interval to poll the cache for stale objects. (default 1m0s)
--vfs-case-insensitive [bool] Case insensitive mount true|false (default depends on operating system)
--vfs-case-insensitive If a file name not found, find a case insensitive match.
--vfs-read-chunk-size SizeSuffix Read the source objects in chunks. (default 128M)
--vfs-read-chunk-size-limit SizeSuffix If greater than --vfs-read-chunk-size, double the chunk size after each chunk read, until the limit is reached. 'off' is unlimited. (default off)
--volname string Set the volume name (not supported by all OSes).

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone move"
slug: rclone_move
url: /commands/rclone_move/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone moveto"
slug: rclone_moveto
url: /commands/rclone_moveto/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone ncdu"
slug: rclone_ncdu
url: /commands/rclone_ncdu/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone obscure"
slug: rclone_obscure
url: /commands/rclone_obscure/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone purge"
slug: rclone_purge
url: /commands/rclone_purge/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone rc"
slug: rclone_rc
url: /commands/rclone_rc/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone rcat"
slug: rclone_rcat
url: /commands/rclone_rcat/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone rcd"
slug: rclone_rcd
url: /commands/rclone_rcd/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone rmdir"
slug: rclone_rmdir
url: /commands/rclone_rmdir/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone rmdirs"
slug: rclone_rmdirs
url: /commands/rclone_rmdirs/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone serve"
slug: rclone_serve
url: /commands/rclone_serve/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone serve dlna"
slug: rclone_serve_dlna
url: /commands/rclone_serve_dlna/
@ -193,6 +193,7 @@ rclone serve dlna remote:path [flags]
--vfs-cache-max-size SizeSuffix Max total size of objects in the cache. (default off)
--vfs-cache-mode CacheMode Cache mode off|minimal|writes|full (default off)
--vfs-cache-poll-interval duration Interval to poll the cache for stale objects. (default 1m0s)
--vfs-case-insensitive If a file name not found, find a case insensitive match.
--vfs-read-chunk-size SizeSuffix Read the source objects in chunks. (default 128M)
--vfs-read-chunk-size-limit SizeSuffix If greater than --vfs-read-chunk-size, double the chunk size after each chunk read, until the limit is reached. 'off' is unlimited. (default off)
```

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone serve ftp"
slug: rclone_serve_ftp
url: /commands/rclone_serve_ftp/
@ -261,6 +261,7 @@ rclone serve ftp remote:path [flags]
--vfs-cache-max-size SizeSuffix Max total size of objects in the cache. (default off)
--vfs-cache-mode CacheMode Cache mode off|minimal|writes|full (default off)
--vfs-cache-poll-interval duration Interval to poll the cache for stale objects. (default 1m0s)
--vfs-case-insensitive If a file name not found, find a case insensitive match.
--vfs-read-chunk-size SizeSuffix Read the source objects in chunks. (default 128M)
--vfs-read-chunk-size-limit SizeSuffix If greater than --vfs-read-chunk-size, double the chunk size after each chunk read, until the limit is reached. 'off' is unlimited. (default off)
```

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone serve http"
slug: rclone_serve_http
url: /commands/rclone_serve_http/
@ -250,6 +250,7 @@ rclone serve http remote:path [flags]
--vfs-cache-max-size SizeSuffix Max total size of objects in the cache. (default off)
--vfs-cache-mode CacheMode Cache mode off|minimal|writes|full (default off)
--vfs-cache-poll-interval duration Interval to poll the cache for stale objects. (default 1m0s)
--vfs-case-insensitive If a file name not found, find a case insensitive match.
--vfs-read-chunk-size SizeSuffix Read the source objects in chunks. (default 128M)
--vfs-read-chunk-size-limit SizeSuffix If greater than --vfs-read-chunk-size, double the chunk size after each chunk read, until the limit is reached. 'off' is unlimited. (default off)
```

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone serve restic"
slug: rclone_serve_restic
url: /commands/rclone_serve_restic/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone serve sftp"
slug: rclone_serve_sftp
url: /commands/rclone_serve_sftp/
@ -273,6 +273,7 @@ rclone serve sftp remote:path [flags]
--vfs-cache-max-size SizeSuffix Max total size of objects in the cache. (default off)
--vfs-cache-mode CacheMode Cache mode off|minimal|writes|full (default off)
--vfs-cache-poll-interval duration Interval to poll the cache for stale objects. (default 1m0s)
--vfs-case-insensitive If a file name not found, find a case insensitive match.
--vfs-read-chunk-size SizeSuffix Read the source objects in chunks. (default 128M)
--vfs-read-chunk-size-limit SizeSuffix If greater than --vfs-read-chunk-size, double the chunk size after each chunk read, until the limit is reached. 'off' is unlimited. (default off)
```

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone serve webdav"
slug: rclone_serve_webdav
url: /commands/rclone_serve_webdav/
@ -327,6 +327,7 @@ rclone serve webdav remote:path [flags]
--vfs-cache-max-size SizeSuffix Max total size of objects in the cache. (default off)
--vfs-cache-mode CacheMode Cache mode off|minimal|writes|full (default off)
--vfs-cache-poll-interval duration Interval to poll the cache for stale objects. (default 1m0s)
--vfs-case-insensitive If a file name not found, find a case insensitive match.
--vfs-read-chunk-size SizeSuffix Read the source objects in chunks. (default 128M)
--vfs-read-chunk-size-limit SizeSuffix If greater than --vfs-read-chunk-size, double the chunk size after each chunk read, until the limit is reached. 'off' is unlimited. (default off)
```

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone settier"
slug: rclone_settier
url: /commands/rclone_settier/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone sha1sum"
slug: rclone_sha1sum
url: /commands/rclone_sha1sum/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone size"
slug: rclone_size
url: /commands/rclone_size/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone sync"
slug: rclone_sync
url: /commands/rclone_sync/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone touch"
slug: rclone_touch
url: /commands/rclone_touch/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone tree"
slug: rclone_tree
url: /commands/rclone_tree/

View File

@ -1,5 +1,5 @@
---
date: 2019-08-26T15:19:45+01:00
date: 2019-10-26T11:04:03+01:00
title: "rclone version"
slug: rclone_version
url: /commands/rclone_version/

View File

@ -550,7 +550,13 @@ Scope that rclone should use when requesting access from drive.
ID of the root folder
Leave blank normally.
Fill in to access "Computers" folders. (see docs).
Fill in to access "Computers" folders (see docs), or for rclone to use
a non root folder as its starting point.
Note that if this is blank, the first time rclone runs it will fill it
in with the ID of the root folder.
- Config: root_folder_id
- Env Var: RCLONE_DRIVE_ROOT_FOLDER_ID
@ -857,7 +863,7 @@ Allow server side operations (eg copy) to work across different drive configs.
This can be useful if you wish to do a server side copy between two
different Google drives. Note that this isn't enabled by default
because it isn't easy to tell if it will work beween any two
because it isn't easy to tell if it will work between any two
configurations.
- Config: server_side_across_configs
@ -865,6 +871,24 @@ configurations.
- Type: bool
- Default: false
#### --drive-disable-http2
Disable drive using http2
There is currently an unsolved issue with the google drive backend and
HTTP/2. HTTP/2 is therefore disabled by default for the drive backend
but can be re-enabled here. When the issue is solved this flag will
be removed.
See: https://github.com/rclone/rclone/issues/3631
- Config: disable_http2
- Env Var: RCLONE_DRIVE_DISABLE_HTTP2
- Type: bool
- Default: true
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -1,7 +1,7 @@
---
title: "Global Flags"
description: "Rclone Global Flags"
date: "2019-08-26T15:19:45+01:00"
date: "2019-10-26T11:04:03+01:00"
---
# Global Flags
@ -127,7 +127,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.49.0")
--user-agent string Set the user-agent to a specified string. The default is rclone/ version (default "rclone/v1.50.0")
-v, --verbose count Print lots more stuff (repeat for more)
```
@ -164,6 +164,8 @@ and may be set in the config file.
--b2-test-mode string A flag string for X-Bz-Test-Mode header for debugging.
--b2-upload-cutoff SizeSuffix Cutoff for switching to chunked upload. (default 200M)
--b2-versions Include old versions in directory listings.
--box-box-config-file string Box App config.json location
--box-box-sub-type string (default "user")
--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)
@ -188,6 +190,13 @@ and may be set in the config file.
--cache-tmp-wait-time Duration How long should files be stored in local cache before being uploaded (default 15s)
--cache-workers int How many workers should run in parallel to download chunks. (default 4)
--cache-writes Cache file data on writes through the FS
--chunker-chunk-size SizeSuffix Files larger than chunk size will be split in chunks. (default 2G)
--chunker-fail-hard Choose how chunker should handle files with missing or invalid chunks.
--chunker-hash-type string Choose how chunker handles hash sums. All modes but "none" require metadata. (default "md5")
--chunker-meta-format string Format of the metadata object or "none". By default "simplejson". (default "simplejson")
--chunker-name-format string String format of chunk file names. (default "*.rclone_chunk.###")
--chunker-remote string Remote to chunk/unchunk.
--chunker-start-from int Minimum valid chunk number. Usually 0 or 1. (default 1)
-L, --copy-links Follow symlinks and copy the pointed to item.
--crypt-directory-name-encryption Option to either encrypt directory names or leave them intact. (default true)
--crypt-filename-encryption string How to encrypt the filenames. (default "standard")
@ -202,6 +211,7 @@ and may be set in the config file.
--drive-chunk-size SizeSuffix Upload chunk size. Must a power of 2 >= 256k. (default 8M)
--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-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.
@ -232,6 +242,7 @@ and may be set in the config file.
--fichier-api-key string Your API Key, get it from https://1fichier.com/console/params.pl
--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-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
@ -252,6 +263,7 @@ and may be set in the config file.
--gphotos-read-only Set to make the Google Photos backend read only.
--gphotos-read-size Set to read the size of media items.
--http-headers CommaSepList Set HTTP headers for all transactions
--http-no-head Don't use HEAD requests to find file sizes in dir listing
--http-no-slash Set this if the site doesn't end directories with /
--http-url string URL of http host to connect to
--hubic-chunk-size SizeSuffix Above this size files will be chunked into a _segments container. (default 5G)
@ -273,12 +285,19 @@ and may be set in the config file.
--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-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")
--mailru-speedup-max-disk SizeSuffix This option allows you to disable speedup (put by hash) for large files (default 3G)
--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-hard-delete Delete files permanently rather than putting them into the trash.
--mega-pass string Password.
--mega-user string User name
-x, --one-file-system Don't cross filesystem boundaries (unix/macOS only).
--onedrive-chunk-size SizeSuffix Chunk size to upload files with - must be multiple of 320k. (default 10M)
--onedrive-chunk-size SizeSuffix Chunk size to upload files with - must be multiple of 320k (327,680 bytes). (default 10M)
--onedrive-client-id string Microsoft App Client Id
--onedrive-client-secret string Microsoft App Client Secret
--onedrive-drive-id string The ID of the drive to use
@ -305,6 +324,7 @@ and may be set in the config file.
--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-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.
@ -329,8 +349,12 @@ 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-use-insecure-cipher Enable the use of the aes128-cbc cipher and diffie-hellman-group-exchange-sha256, diffie-hellman-group-exchange-sha1 key exchange. Those algorithms are insecure and may allow plaintext data to be recovered by an attacker.
--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-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.
--swift-application-credential-id string Application Credential ID (OS_APPLICATION_CREDENTIAL_ID)
--swift-application-credential-name string Application Credential Name (OS_APPLICATION_CREDENTIAL_NAME)

View File

@ -203,6 +203,15 @@ Do not verify the TLS certificate of the server
- Type: bool
- Default: false
#### --ftp-disable-epsv
Disable using EPSV even if server advertises support
- Config: disable_epsv
- Env Var: RCLONE_FTP_DISABLE_EPSV
- Type: bool
- Default: false
<!--- autogenerated options stop -->
### Limitations ###

View File

@ -162,4 +162,28 @@ directories.
- Type: bool
- Default: false
#### --http-no-head
Don't use HEAD requests to find file sizes in dir listing
If your site is being very slow to load then you can try this option.
Normally rclone does a HEAD request for each potential file in a
directory listing to:
- find its size
- check it really exists
- check to see if it is a directory
If you set this option, rclone will not do the HEAD request. This will mean
- directory listings are much quicker
- rclone won't have the times or sizes of any files
- some files that don't exist may be in the listing
- Config: no_head
- Env Var: RCLONE_HTTP_NO_HEAD
- Type: bool
- Default: false
<!--- autogenerated options stop -->

View File

@ -319,7 +319,7 @@ Disable UNC (long path names) conversion on Windows
Here are the advanced options specific to local (Local Disk).
#### --copy-links
#### --copy-links / -L
Follow symlinks and copy the pointed to item.
@ -328,7 +328,7 @@ Follow symlinks and copy the pointed to item.
- Type: bool
- Default: false
#### --links
#### --links / -l
Translate symlinks to/from regular files with a '.rclonelink' extension
@ -378,7 +378,7 @@ check can be disabled with this flag.
- Type: bool
- Default: false
#### --one-file-system
#### --one-file-system / -x
Don't cross filesystem boundaries (unix/macOS only).

View File

@ -213,20 +213,20 @@ Here are the advanced options specific to mailru (Mail.ru Cloud).
#### --mailru-speedup-file-patterns
Comma separated list of file name patterns eligible for speedup (put by hash).
Patterns are case insensitive and can contain `*` or `?` meta characters.
Patterns are case insensitive and can contain '*' or '?' meta characters.
- Config: speedup_file_patterns
- Env Var: RCLONE_MAILRU_SPEEDUP_FILE_PATTERNS
- Type: string
- Default: "*.mkv,*.avi,*.mp4,*.mp3,*.zip,*.gz,*.rar,*.pdf"
- Examples:
- `""`
- ""
- Empty list completely disables speedup (put by hash).
- `"*"`
- "*"
- All files will be attempted for speedup.
- `"*.mkv,*.avi,*.mp4,*.mp3"`
- "*.mkv,*.avi,*.mp4,*.mp3"
- Only common audio/video files will be tried for put by hash.
- `"*.zip,*.gz,*.rar,*.pdf"`
- "*.zip,*.gz,*.rar,*.pdf"
- Only common archives or PDF books will be tried for speedup.
#### --mailru-speedup-max-disk
@ -288,8 +288,12 @@ Defaults to "rclone/VERSION" or "--user-agent" provided on command line.
#### --mailru-quirks
Comma separated list of internal maintenance flags. This option is intended
for development purposes. Should not be used by an ordinary user.
Comma separated list of internal maintenance flags.
This option must not be used by an ordinary user. It is intended only to
facilitate remote troubleshooting of backend issues. Strict meaning of
flags is not documented and not guaranteed to persist between releases.
Quirks will be removed when the backend grows stable.
Supported quirks: atomicmkdir binlist gzip insecure retry400
- Config: quirks
- Env Var: RCLONE_MAILRU_QUIRKS

View File

@ -467,6 +467,11 @@ Returns
This returns PID of current process.
Useful for stopping rclone process.
### core/quit: Terminates the app. {#core/quit}
(optional) Pass an exit code to be used for terminating the app:
- exitCode - int
### core/stats: Returns stats about current transfers. {#core/stats}
This returns all available stats:
@ -519,6 +524,7 @@ is provided.
Parameters
- group - name of the stats group (string)
```
### core/transferred: Returns stats about completed transfers. {#core/transferred}
@ -529,6 +535,8 @@ This returns stats about completed transfers:
If group is not provided then completed transfers for all groups will be
returned.
Note only the last 100 completed transfers are returned.
Parameters
- group - name of the stats group (string)
@ -630,7 +638,7 @@ This takes the following parameters
- fs - a remote name string eg "drive:"
- remote - a path within that remote eg "dir"
- url - string, URL to read from
- autoFilename - boolean, set to true to retrieve destination file name from url
See the [copyurl command](/commands/rclone_copyurl/) command for more information on the above.
Authentication is required for this call.

View File

@ -222,7 +222,18 @@ when the ssh-agent contains many keys.
#### --sftp-use-insecure-cipher
Enable the use of the aes128-cbc cipher and diffie-hellman-group-exchange-sha256, diffie-hellman-group-exchange-sha1 key exchange. Those algorithms are insecure and may allow plaintext data to be recovered by an attacker.
Enable the use of insecure ciphers and key exchange methods.
This enables the use of the the following insecure ciphers and key exchange methods:
- aes128-cbc
- aes192-cbc
- aes256-cbc
- 3des-cbc
- diffie-hellman-group-exchange-sha256
- diffie-hellman-group-exchange-sha1
Those algorithms are insecure and may allow plaintext data to be recovered by an attacker.
- Config: use_insecure_cipher
- Env Var: RCLONE_SFTP_USE_INSECURE_CIPHER
@ -252,6 +263,11 @@ Here are the advanced options specific to sftp (SSH/SFTP Connection).
Allow asking for SFTP password when needed.
If this is set and no password is supplied then rclone will:
- ask for a password
- not contact the ssh agent
- Config: ask_password
- Env Var: RCLONE_SFTP_ASK_PASSWORD
- Type: bool

View File

@ -1 +1 @@
v1.49.0
v1.50.0

View File

@ -1,4 +1,4 @@
package fs
// Version of rclone
var Version = "v1.49.5-DEV"
var Version = "v1.50.0"

20147
rclone.1 generated

File diff suppressed because it is too large Load Diff