Version v1.61.0

docs/content/changelog.md

@@ -5,6 +5,101 @@ description: "Rclone Changelog"
 
 # Changelog
 
+## v1.61.0 - 2022-12-20
+
+[See commits](https://github.com/rclone/rclone/compare/v1.60.0...v1.61.0)
+
+* New backends
+    * New S3 providers
+        * [Liara LOS](/s3/#liara-cloud) (MohammadReza)
+* New Features
+    * build: Add vulnerability testing using govulncheck (albertony)
+    * cmd: Enable `SIGINFO` (Ctrl-T) handler on FreeBSD, NetBSD, OpenBSD and Dragonfly BSD (x3-apptech)
+    * config: Add [config/setpath](/rc/#config-setpath) for setting config path via rc/librclone (Nick Craig-Wood)
+    * dedupe
+        * Count Checks in the stats while scanning for duplicates (Nick Craig-Wood)
+        * Make dedupe obey the filters (Nick Craig-Wood)
+    * dlna: Properly attribute code used from https://github.com/anacrolix/dms (Nick Craig-Wood)
+    * docs
+        * Add minimum versions and status badges to backend and command docs (Nick Craig-Wood, albertony)
+        * Remote names may not start or end with space (albertony)
+    * filter: Add metadata filters [--metadata-include/exclude/filter](/filtering/#metadata) and friends (Nick Craig-Wood)
+    * fs
+        * Make all duration flags take `y`, `M`, `w`, `d` etc suffixes (Nick Craig-Wood)
+        * Add global flag `--color` to control terminal colors (Kevin Verstaen)
+    * fspath: Allow unicode numbers and letters in remote names (albertony)
+    * lib/file: Improve error message for creating dir on non-existent network host on windows (albertony)
+    * lib/http: Finish port of rclone servers to `lib/http` (Tom Mombourquette, Nick Craig-Wood)
+    * lib/oauthutil: Improved usability of config flows needing web browser (Ole Frost)
+    * ncdu
+        * Add support for modification time (albertony)
+        * Fallback to sort by name also for sort by average size (albertony)
+        * Rework to use tcell directly instead of the termbox wrapper (eNV25)
+    * rc: Add commands to set [GC Percent](/rc/#debug-set-gc-percent) & [Memory Limit](/rc/#debug-set-soft-memory-limit) (go 1.19+) (Anagh Kumar Baranwal)
+    * rcat: Preserve metadata when Copy falls back to Rcat (Nick Craig-Wood)
+    * rcd: Refactor rclone rc server to use `lib/http` (Nick Craig-Wood)
+    * rcserver: Avoid generating default credentials with htpasswd (Kamui)
+    * restic: Refactor to use `lib/http` (Nolan Woods)
+    * serve http: Support unix sockets and multiple listeners (Tom Mombourquette)
+    * serve webdav: Refactor to use `lib/http` (Nick Craig-Wood)
+    * test: Replace defer cleanup with `t.Cleanup` (Eng Zer Jun)
+    * test memory: Read metadata if `-M` flag is specified (Nick Craig-Wood)
+    * wasm: Comply with `wasm_exec.js` licence terms (Matthew Vernon)
+* Bug Fixes
+    * build: Update `golang.org/x/net/http2` to fix GO-2022-1144 (Nick Craig-Wood)
+    * restic: Fix typo in docs 'remove' should be 'remote' (asdffdsazqqq)
+    * serve dlna: Fix panic: Logger uninitialized. (Nick Craig-Wood)
+* Mount
+    * Update cgofuse for FUSE-T support for mounting volumes on Mac (Nick Craig-Wood)
+* VFS
+    * Windows: fix slow opening of exe files by not truncating files when not necessary (Nick Craig-Wood)
+    * Fix IO Error opening a file with `O_CREATE|O_RDONLY` in `--vfs-cache-mode` not full (Nick Craig-Wood)
+* Crypt
+    * Fix compress wrapping crypt giving upload errors (Nick Craig-Wood)
+* Azure Blob
+    * Port to new SDK (Nick Craig-Wood)
+        * Revamp authentication to include all methods and docs (Nick Craig-Wood)
+        * Port old authentication methods to new SDK (Nick Craig-Wood, Brad Ackerman)
+        * Thanks to [Stonebranch](https://www.stonebranch.com/) for sponsoring this work.
+    * Add `--azureblob-no-check-container` to assume container exists (Nick Craig-Wood)
+    * Add `--use-server-modtime` support (Abdullah Saglam)
+    * Add support for custom upload headers (rkettelerij)
+    * Allow emulator account/key override (Roel Arents)
+    * Support simple "environment credentials" (Nathaniel Wesley Filardo)
+    * Ignore `AuthorizationFailure` when trying to create a create a container (Nick Craig-Wood)
+* Box
+    * Added note on Box API rate limits (Ole Frost)
+* Drive
+    * Handle shared drives with leading/trailing space in name (related to) (albertony)
+* FTP
+    * Update help text of implicit/explicit TLS options to refer to FTPS instead of FTP (ycdtosa)
+    * Improve performance to speed up `--files-from` and `NewObject` (Anthony Pessy)
+* HTTP
+    * Parse GET responses when `no_head` is set (Arnie97)
+    * Do not update object size based on `Range` requests (Arnie97)
+    * Support `Content-Range` response header (Arnie97)
+* Onedrive
+    * Document workaround for shared with me files (vanplus)
+* S3
+    * Add Liara LOS to provider list (MohammadReza)
+    * Add DigitalOcean Spaces regions `sfo3`, `fra1`, `syd1` (Jack)
+    * Avoid privileged `GetBucketLocation` to resolve s3 region (Anthony Pessy)
+    * Stop setting object and bucket ACL to `private` if it is an empty string (Philip Harvey)
+    * If bucket or object ACL is empty string then don't add `X-Amz-Acl:` header (Nick Craig-Wood)
+    * Reduce memory consumption for s3 objects (Erik Agterdenbos)
+    * Fix listing loop when using v2 listing on v1 server (Nick Craig-Wood)
+    * Fix nil pointer exception when using Versions (Nick Craig-Wood)
+    * Fix excess memory usage when using versions (Nick Craig-Wood)
+    * Ignore versionIDs from uploads unless using `--s3-versions` or `--s3-versions-at` (Nick Craig-Wood)
+* SFTP
+    * Add configuration options to set ssh Ciphers / MACs / KeyExchange (dgouju)
+    * Auto-detect shell type for fish (albertony)
+    * Fix NewObject with leading / (Nick Craig-Wood)
+* Smb
+    * Fix issue where spurious dot directory is created (albertony)
+* Storj
+    * Implement server side Copy (Kaloyan Raev)
+
 ## v1.60.1 - 2022-11-17
 
 [See commits](https://github.com/rclone/rclone/compare/v1.60.0...v1.60.1)

docs/content/commands/rclone_about.md

@@ -3,6 +3,7 @@ title: "rclone about"
 description: "Get quota information from the remote."
 slug: rclone_about
 url: /commands/rclone_about/
+versionIntroduced: v1.41
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/about/ and as part of making a release run "make commanddocs"
 ---
 # rclone about

docs/content/commands/rclone_authorize.md

@@ -3,6 +3,7 @@ title: "rclone authorize"
 description: "Remote authorization."
 slug: rclone_authorize
 url: /commands/rclone_authorize/
+versionIntroduced: v1.27
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/authorize/ and as part of making a release run "make commanddocs"
 ---
 # rclone authorize

docs/content/commands/rclone_backend.md

@@ -3,6 +3,7 @@ title: "rclone backend"
 description: "Run a backend-specific command."
 slug: rclone_backend
 url: /commands/rclone_backend/
+versionIntroduced: v1.52
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/backend/ and as part of making a release run "make commanddocs"
 ---
 # rclone backend

docs/content/commands/rclone_bisync.md

@@ -3,6 +3,7 @@ title: "rclone bisync"
 description: "Perform bidirectional synchronization between two paths."
 slug: rclone_bisync
 url: /commands/rclone_bisync/
+versionIntroduced: v1.58
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/bisync/ and as part of making a release run "make commanddocs"
 ---
 # rclone bisync

docs/content/commands/rclone_cat.md

@@ -3,6 +3,7 @@ title: "rclone cat"
 description: "Concatenates any files and sends them to stdout."
 slug: rclone_cat
 url: /commands/rclone_cat/
+versionIntroduced: v1.33
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/cat/ and as part of making a release run "make commanddocs"
 ---
 # rclone cat

docs/content/commands/rclone_checksum.md

@@ -3,6 +3,7 @@ title: "rclone checksum"
 description: "Checks the files in the source against a SUM file."
 slug: rclone_checksum
 url: /commands/rclone_checksum/
+versionIntroduced: v1.56
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/checksum/ and as part of making a release run "make commanddocs"
 ---
 # rclone checksum

docs/content/commands/rclone_cleanup.md

@@ -3,6 +3,7 @@ title: "rclone cleanup"
 description: "Clean up the remote if possible."
 slug: rclone_cleanup
 url: /commands/rclone_cleanup/
+versionIntroduced: v1.31
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/cleanup/ and as part of making a release run "make commanddocs"
 ---
 # rclone cleanup

docs/content/commands/rclone_config.md

@@ -3,6 +3,7 @@ title: "rclone config"
 description: "Enter an interactive configuration session."
 slug: rclone_config
 url: /commands/rclone_config/
+versionIntroduced: v1.39
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/config/ and as part of making a release run "make commanddocs"
 ---
 # rclone config

docs/content/commands/rclone_config_create.md

@@ -3,6 +3,7 @@ title: "rclone config create"
 description: "Create a new remote with name, type and options."
 slug: rclone_config_create
 url: /commands/rclone_config_create/
+versionIntroduced: v1.39
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/config/create/ and as part of making a release run "make commanddocs"
 ---
 # rclone config create
@@ -57,7 +58,7 @@ This will look something like (some irrelevant detail removed):
     "State": "*oauth-islocal,teamdrive,,",
     "Option": {
         "Name": "config_is_local",
-        "Help": "Use auto config?\n * Say Y if not sure\n * Say N if you are working on a remote or headless machine\n",
+        "Help": "Use web browser to automatically authenticate rclone with remote?\n * Say Y if the machine running rclone has a web browser you can use\n * Say N if running rclone on a (remote) machine without web browser access\nIf not sure try Y. If Y failed, try N.\n",
         "Default": true,
         "Examples": [
             {

docs/content/commands/rclone_config_delete.md

@@ -3,6 +3,7 @@ title: "rclone config delete"
 description: "Delete an existing remote."
 slug: rclone_config_delete
 url: /commands/rclone_config_delete/
+versionIntroduced: v1.39
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/config/delete/ and as part of making a release run "make commanddocs"
 ---
 # rclone config delete

docs/content/commands/rclone_config_dump.md

@@ -3,6 +3,7 @@ title: "rclone config dump"
 description: "Dump the config file as JSON."
 slug: rclone_config_dump
 url: /commands/rclone_config_dump/
+versionIntroduced: v1.39
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/config/dump/ and as part of making a release run "make commanddocs"
 ---
 # rclone config dump

docs/content/commands/rclone_config_file.md

@@ -3,6 +3,7 @@ title: "rclone config file"
 description: "Show path of configuration file in use."
 slug: rclone_config_file
 url: /commands/rclone_config_file/
+versionIntroduced: v1.38
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/config/file/ and as part of making a release run "make commanddocs"
 ---
 # rclone config file

docs/content/commands/rclone_config_password.md

@@ -3,6 +3,7 @@ title: "rclone config password"
 description: "Update password in an existing remote."
 slug: rclone_config_password
 url: /commands/rclone_config_password/
+versionIntroduced: v1.39
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/config/password/ and as part of making a release run "make commanddocs"
 ---
 # rclone config password

docs/content/commands/rclone_config_paths.md

@@ -3,6 +3,7 @@ title: "rclone config paths"
 description: "Show paths used for configuration, cache, temp etc."
 slug: rclone_config_paths
 url: /commands/rclone_config_paths/
+versionIntroduced: v1.57
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/config/paths/ and as part of making a release run "make commanddocs"
 ---
 # rclone config paths

docs/content/commands/rclone_config_providers.md

@@ -3,6 +3,7 @@ title: "rclone config providers"
 description: "List in JSON format all the providers and options."
 slug: rclone_config_providers
 url: /commands/rclone_config_providers/
+versionIntroduced: v1.39
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/config/providers/ and as part of making a release run "make commanddocs"
 ---
 # rclone config providers

docs/content/commands/rclone_config_show.md

@@ -3,6 +3,7 @@ title: "rclone config show"
 description: "Print (decrypted) config file, or the config for a single remote."
 slug: rclone_config_show
 url: /commands/rclone_config_show/
+versionIntroduced: v1.38
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/config/show/ and as part of making a release run "make commanddocs"
 ---
 # rclone config show

docs/content/commands/rclone_config_touch.md

@@ -3,6 +3,7 @@ title: "rclone config touch"
 description: "Ensure configuration file exists."
 slug: rclone_config_touch
 url: /commands/rclone_config_touch/
+versionIntroduced: v1.56
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/config/touch/ and as part of making a release run "make commanddocs"
 ---
 # rclone config touch

docs/content/commands/rclone_config_update.md

@@ -3,6 +3,7 @@ title: "rclone config update"
 description: "Update options in an existing remote."
 slug: rclone_config_update
 url: /commands/rclone_config_update/
+versionIntroduced: v1.39
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/config/update/ and as part of making a release run "make commanddocs"
 ---
 # rclone config update
@@ -57,7 +58,7 @@ This will look something like (some irrelevant detail removed):
     "State": "*oauth-islocal,teamdrive,,",
     "Option": {
         "Name": "config_is_local",
-        "Help": "Use auto config?\n * Say Y if not sure\n * Say N if you are working on a remote or headless machine\n",
+        "Help": "Use web browser to automatically authenticate rclone with remote?\n * Say Y if the machine running rclone has a web browser you can use\n * Say N if running rclone on a (remote) machine without web browser access\nIf not sure try Y. If Y failed, try N.\n",
         "Default": true,
         "Examples": [
             {

docs/content/commands/rclone_copyto.md

@@ -3,6 +3,7 @@ title: "rclone copyto"
 description: "Copy files from source to dest, skipping identical files."
 slug: rclone_copyto
 url: /commands/rclone_copyto/
+versionIntroduced: v1.35
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/copyto/ and as part of making a release run "make commanddocs"
 ---
 # rclone copyto

docs/content/commands/rclone_copyurl.md

@@ -3,6 +3,7 @@ title: "rclone copyurl"
 description: "Copy url content to dest."
 slug: rclone_copyurl
 url: /commands/rclone_copyurl/
+versionIntroduced: v1.43
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/copyurl/ and as part of making a release run "make commanddocs"
 ---
 # rclone copyurl

docs/content/commands/rclone_cryptcheck.md

@@ -3,6 +3,7 @@ title: "rclone cryptcheck"
 description: "Cryptcheck checks the integrity of a crypted remote."
 slug: rclone_cryptcheck
 url: /commands/rclone_cryptcheck/
+versionIntroduced: v1.36
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/cryptcheck/ and as part of making a release run "make commanddocs"
 ---
 # rclone cryptcheck

docs/content/commands/rclone_cryptdecode.md

@@ -3,6 +3,7 @@ title: "rclone cryptdecode"
 description: "Cryptdecode returns unencrypted file names."
 slug: rclone_cryptdecode
 url: /commands/rclone_cryptdecode/
+versionIntroduced: v1.38
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/cryptdecode/ and as part of making a release run "make commanddocs"
 ---
 # rclone cryptdecode

docs/content/commands/rclone_dedupe.md

@@ -3,6 +3,7 @@ title: "rclone dedupe"
 description: "Interactively find duplicate filenames and delete/rename them."
 slug: rclone_dedupe
 url: /commands/rclone_dedupe/
+versionIntroduced: v1.27
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/dedupe/ and as part of making a release run "make commanddocs"
 ---
 # rclone dedupe

docs/content/commands/rclone_delete.md

@@ -3,6 +3,7 @@ title: "rclone delete"
 description: "Remove the files in path."
 slug: rclone_delete
 url: /commands/rclone_delete/
+versionIntroduced: v1.27
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/delete/ and as part of making a release run "make commanddocs"
 ---
 # rclone delete

docs/content/commands/rclone_deletefile.md

@@ -3,6 +3,7 @@ title: "rclone deletefile"
 description: "Remove a single file from remote."
 slug: rclone_deletefile
 url: /commands/rclone_deletefile/
+versionIntroduced: v1.42
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/deletefile/ and as part of making a release run "make commanddocs"
 ---
 # rclone deletefile

docs/content/commands/rclone_genautocomplete.md

@@ -3,6 +3,7 @@ title: "rclone genautocomplete"
 description: "Output completion script for a given shell."
 slug: rclone_genautocomplete
 url: /commands/rclone_genautocomplete/
+versionIntroduced: v1.33
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/genautocomplete/ and as part of making a release run "make commanddocs"
 ---
 # rclone genautocomplete

docs/content/commands/rclone_gendocs.md

@@ -3,6 +3,7 @@ title: "rclone gendocs"
 description: "Output markdown docs for rclone to the directory supplied."
 slug: rclone_gendocs
 url: /commands/rclone_gendocs/
+versionIntroduced: v1.33
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/gendocs/ and as part of making a release run "make commanddocs"
 ---
 # rclone gendocs

docs/content/commands/rclone_hashsum.md

@@ -3,6 +3,7 @@ title: "rclone hashsum"
 description: "Produces a hashsum file for all the objects in the path."
 slug: rclone_hashsum
 url: /commands/rclone_hashsum/
+versionIntroduced: v1.41
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/hashsum/ and as part of making a release run "make commanddocs"
 ---
 # rclone hashsum

docs/content/commands/rclone_link.md

@@ -3,6 +3,7 @@ title: "rclone link"
 description: "Generate public link to file/folder."
 slug: rclone_link
 url: /commands/rclone_link/
+versionIntroduced: v1.41
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/link/ and as part of making a release run "make commanddocs"
 ---
 # rclone link

docs/content/commands/rclone_listremotes.md

@@ -3,6 +3,7 @@ title: "rclone listremotes"
 description: "List all the remotes in the config file."
 slug: rclone_listremotes
 url: /commands/rclone_listremotes/
+versionIntroduced: v1.34
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/listremotes/ and as part of making a release run "make commanddocs"
 ---
 # rclone listremotes

docs/content/commands/rclone_lsf.md

@@ -3,6 +3,7 @@ title: "rclone lsf"
 description: "List directories and objects in remote:path formatted for parsing."
 slug: rclone_lsf
 url: /commands/rclone_lsf/
+versionIntroduced: v1.40
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/lsf/ and as part of making a release run "make commanddocs"
 ---
 # rclone lsf

docs/content/commands/rclone_lsjson.md

@@ -3,6 +3,7 @@ title: "rclone lsjson"
 description: "List directories and objects in the path in JSON format."
 slug: rclone_lsjson
 url: /commands/rclone_lsjson/
+versionIntroduced: v1.37
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/lsjson/ and as part of making a release run "make commanddocs"
 ---
 # rclone lsjson
@@ -120,6 +121,7 @@ rclone lsjson remote:path [flags]
       --hash                    Include hashes in the output (may take longer)
       --hash-type stringArray   Show only this hash type (may be repeated)
   -h, --help                    help for lsjson
+  -M, --metadata                Add metadata to the listing
       --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

docs/content/commands/rclone_lsl.md

@@ -3,6 +3,7 @@ title: "rclone lsl"
 description: "List the objects in path with modification time, size and path."
 slug: rclone_lsl
 url: /commands/rclone_lsl/
+versionIntroduced: v1.02
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/lsl/ and as part of making a release run "make commanddocs"
 ---
 # rclone lsl

docs/content/commands/rclone_md5sum.md

@@ -3,6 +3,7 @@ title: "rclone md5sum"
 description: "Produces an md5sum file for all the objects in the path."
 slug: rclone_md5sum
 url: /commands/rclone_md5sum/
+versionIntroduced: v1.02
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/md5sum/ and as part of making a release run "make commanddocs"
 ---
 # rclone md5sum

docs/content/commands/rclone_mount.md

@@ -3,6 +3,7 @@ title: "rclone mount"
 description: "Mount the remote as file system on a mountpoint."
 slug: rclone_mount
 url: /commands/rclone_mount/
+versionIntroduced: v1.33
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/mount/ and as part of making a release run "make commanddocs"
 ---
 # rclone mount
@@ -722,14 +723,14 @@ rclone mount remote:path /path/to/mountpoint [flags]
       --allow-other                            Allow access to other users (not supported on Windows)
       --allow-root                             Allow access to root user (not supported on Windows)
       --async-read                             Use asynchronous reads (not supported on Windows) (default true)
-      --attr-timeout duration                  Time for which file/directory attributes are cached (default 1s)
+      --attr-timeout Duration                  Time for which file/directory attributes are cached (default 1s)
       --daemon                                 Run mount in background and exit parent process (as background output is suppressed, use --log-file with --log-format=pid,... to monitor) (not supported on Windows)
-      --daemon-timeout duration                Time limit for rclone to respond to kernel (not supported on Windows)
+      --daemon-timeout Duration                Time limit for rclone to respond to kernel (not supported on Windows) (default 0s)
-      --daemon-wait duration                   Time to wait for ready mount from daemon (maximum time on Linux, constant sleep time on OSX/BSD) (not supported on Windows) (default 1m0s)
+      --daemon-wait Duration                   Time to wait for ready mount from daemon (maximum time on Linux, constant sleep time on OSX/BSD) (not supported on Windows) (default 1m0s)
       --debug-fuse                             Debug the FUSE internals - needs -v
       --default-permissions                    Makes kernel enforce access control based on the file mode (not supported on Windows)
       --devname string                         Set the device name - default is remote:path
-      --dir-cache-time duration                Time to cache directory entries for (default 5m0s)
+      --dir-cache-time Duration                Time to cache directory entries for (default 5m0s)
       --dir-perms FileMode                     Directory permissions (default 0777)
       --file-perms FileMode                    File permissions (default 0666)
       --fuse-flag stringArray                  Flags or arguments to be passed direct to libfuse/WinFsp (repeat if required)
@@ -743,24 +744,24 @@ rclone mount remote:path /path/to/mountpoint [flags]
       --noappledouble                          Ignore Apple Double (._) and .DS_Store files (supported on OSX only) (default true)
       --noapplexattr                           Ignore all "com.apple.*" extended attributes (supported on OSX only)
   -o, --option stringArray                     Option for libfuse/WinFsp (repeat if required)
-      --poll-interval duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
+      --poll-interval Duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
       --read-only                              Only allow read-only access
       --uid uint32                             Override the uid field set by the filesystem (not supported on Windows) (default 1000)
       --umask int                              Override the permission bits set by the filesystem (not supported on Windows) (default 2)
-      --vfs-cache-max-age duration             Max age of objects in the cache (default 1h0m0s)
+      --vfs-cache-max-age Duration             Max age of objects in the cache (default 1h0m0s)
       --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-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-disk-space-total-size SizeSuffix   Specify the total space of disk (default off)
       --vfs-fast-fingerprint                   Use fast (less accurate) fingerprints for change detection
       --vfs-read-ahead SizeSuffix              Extra read ahead over --buffer-size when using cache-mode full
       --vfs-read-chunk-size SizeSuffix         Read the source objects in chunks (default 128Mi)
       --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)
-      --vfs-read-wait duration                 Time to wait for in-sequence read before seeking (default 20ms)
+      --vfs-read-wait Duration                 Time to wait for in-sequence read before seeking (default 20ms)
       --vfs-used-is-size rclone size           Use the rclone size algorithm for Used size
-      --vfs-write-back duration                Time to writeback files after last use when using cache (default 5s)
+      --vfs-write-back Duration                Time to writeback files after last use when using cache (default 5s)
-      --vfs-write-wait duration                Time to wait for in-sequence write before giving error (default 1s)
+      --vfs-write-wait Duration                Time to wait for in-sequence write before giving error (default 1s)
       --volname string                         Set the volume name (supported on Windows and OSX only)
       --write-back-cache                       Makes kernel buffer writes before sending them to rclone (without this, writethrough caching is used) (not supported on Windows)
 ```

docs/content/commands/rclone_move.md

@@ -3,6 +3,7 @@ title: "rclone move"
 description: "Move files from source to dest."
 slug: rclone_move
 url: /commands/rclone_move/
+versionIntroduced: v1.19
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/move/ and as part of making a release run "make commanddocs"
 ---
 # rclone move

docs/content/commands/rclone_moveto.md

@@ -3,6 +3,7 @@ title: "rclone moveto"
 description: "Move file or directory from source to dest."
 slug: rclone_moveto
 url: /commands/rclone_moveto/
+versionIntroduced: v1.35
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/moveto/ and as part of making a release run "make commanddocs"
 ---
 # rclone moveto

docs/content/commands/rclone_ncdu.md

@@ -3,6 +3,7 @@ title: "rclone ncdu"
 description: "Explore a remote with a text based user interface."
 slug: rclone_ncdu
 url: /commands/rclone_ncdu/
+versionIntroduced: v1.37
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/ncdu/ and as part of making a release run "make commanddocs"
 ---
 # rclone ncdu
@@ -29,11 +30,12 @@ press '?' to toggle the help on and off. The supported keys are:
      ↑,↓ or k,j to Move
      →,l to enter
      ←,h to return
-     c toggle counts
      g toggle graph
+     c toggle counts
      a toggle average size in directory
+     m toggle modified time
      u toggle human-readable format
-     n,s,C,A sort by name,size,count,average size
+     n,s,C,A,M sort by name,size,count,asize,mtime
      d delete file/directory
      v select file/directory
      V enter visual select mode

docs/content/commands/rclone_obscure.md

@@ -3,6 +3,7 @@ title: "rclone obscure"
 description: "Obscure password for use in the rclone config file."
 slug: rclone_obscure
 url: /commands/rclone_obscure/
+versionIntroduced: v1.36
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/obscure/ and as part of making a release run "make commanddocs"
 ---
 # rclone obscure

docs/content/commands/rclone_rc.md

@@ -3,6 +3,7 @@ title: "rclone rc"
 description: "Run a command against a running rclone."
 slug: rclone_rc
 url: /commands/rclone_rc/
+versionIntroduced: v1.40
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/rc/ and as part of making a release run "make commanddocs"
 ---
 # rclone rc

docs/content/commands/rclone_rcat.md

@@ -3,6 +3,7 @@ title: "rclone rcat"
 description: "Copies standard input to file on remote."
 slug: rclone_rcat
 url: /commands/rclone_rcat/
+versionIntroduced: v1.38
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/rcat/ and as part of making a release run "make commanddocs"
 ---
 # rclone rcat

docs/content/commands/rclone_rcd.md

@@ -3,6 +3,7 @@ title: "rclone rcd"
 description: "Run rclone listening to remote control commands only."
 slug: rclone_rcd
 url: /commands/rclone_rcd/
+versionIntroduced: v1.45
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/rcd/ and as part of making a release run "make commanddocs"
 ---
 # rclone rcd
@@ -22,6 +23,101 @@ the browser when rclone is run.
 
 See the [rc documentation](/rc/) for more info on the rc flags.
 
+## Server options
+
+Use `--addr` to specify which IP address and port the server should
+listen on, eg `--addr 1.2.3.4:8000` or `--addr :8080` to listen to all
+IPs.  By default it only listens on localhost.  You can use port
+:0 to let the OS choose an available port.
+
+If you set `--addr` to listen on a public or LAN accessible IP address
+then using Authentication is advised - see the next section for info.
+
+You can use a unix socket by setting the url to `unix:///path/to/socket`
+or just by using an absolute path name. Note that unix sockets bypass the
+authentication - this is expected to be done with file system permissions.
+
+`--addr` may be repeated to listen on multiple IPs/ports/sockets.
+
+`--server-read-timeout` and `--server-write-timeout` can be used to
+control the timeouts on the server.  Note that this is the total time
+for a transfer.
+
+`--max-header-bytes` controls the maximum number of bytes the server will
+accept in the HTTP header.
+
+`--baseurl` controls the URL prefix that rclone serves from.  By default
+rclone will serve from the root.  If you used `--baseurl "/rclone"` then
+rclone would serve from a URL starting with "/rclone/".  This is
+useful if you wish to proxy rclone serve.  Rclone automatically
+inserts leading and trailing "/" on `--baseurl`, so `--baseurl "rclone"`,
+`--baseurl "/rclone"` and `--baseurl "/rclone/"` are all treated
+identically.
+
+### TLS (SSL)
+
+By default this will serve over http.  If you want you can serve over
+https.  You will need to supply the `--cert` and `--key` flags.
+If you wish to do client side certificate validation then you will need to
+supply `--client-ca` also.
+
+`--cert` should be a either a PEM encoded certificate or a concatenation
+of that with the CA certificate.  `--key` should be the PEM encoded
+private key and `--client-ca` should be the PEM encoded client
+certificate authority certificate.
+
+--min-tls-version is minimum TLS version that is acceptable. Valid
+  values are "tls1.0", "tls1.1", "tls1.2" and "tls1.3" (default
+  "tls1.0").
+
+### Template
+
+`--template` allows a user to specify a custom markup template for HTTP
+and WebDAV serve functions.  The server exports the following markup
+to be used within the template to server pages:
+
+| Parameter   | Description |
+| :---------- | :---------- |
+| .Name       | The full path of a file/directory. |
+| .Title      | Directory listing of .Name |
+| .Sort       | The current sort used.  This is changeable via ?sort= parameter |
+|             | Sort Options: namedirfirst,name,size,time (default namedirfirst) |
+| .Order      | The current ordering used.  This is changeable via ?order= parameter |
+|             | Order Options: asc,desc (default asc) |
+| .Query      | Currently unused. |
+| .Breadcrumb | Allows for creating a relative navigation |
+|-- .Link     | The relative to the root link of the Text. |
+|-- .Text     | The Name of the directory. |
+| .Entries    | Information about a specific file/directory. |
+|-- .URL      | The 'url' of an entry.  |
+|-- .Leaf     | Currently same as 'URL' but intended to be 'just' the name. |
+|-- .IsDir    | Boolean for if an entry is a directory or not. |
+|-- .Size     | Size in Bytes of the entry. |
+|-- .ModTime  | The UTC timestamp of an entry. |
+
+### Authentication
+
+By default this will serve files without needing a login.
+
+You can either use an htpasswd file which can take lots of users, or
+set a single username and password with the `--user` and `--pass` flags.
+
+Use `--htpasswd /path/to/htpasswd` to provide an htpasswd file.  This is
+in standard apache format and supports MD5, SHA1 and BCrypt for basic
+authentication.  Bcrypt is recommended.
+
+To create an htpasswd file:
+
+    touch htpasswd
+    htpasswd -B htpasswd user
+    htpasswd -B htpasswd anotherUser
+
+The password file can be updated while rclone is running.
+
+Use `--realm` to set the authentication realm.
+
+Use `--salt` to change the password hashing salt from the default.
+
 
 ```
 rclone rcd <path to files to serve>* [flags]

docs/content/commands/rclone_rmdirs.md

@@ -3,6 +3,7 @@ title: "rclone rmdirs"
 description: "Remove empty directories under the path."
 slug: rclone_rmdirs
 url: /commands/rclone_rmdirs/
+versionIntroduced: v1.35
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/rmdirs/ and as part of making a release run "make commanddocs"
 ---
 # rclone rmdirs

docs/content/commands/rclone_selfupdate.md

@@ -3,6 +3,7 @@ title: "rclone selfupdate"
 description: "Update the rclone binary."
 slug: rclone_selfupdate
 url: /commands/rclone_selfupdate/
+versionIntroduced: v1.55
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/selfupdate/ and as part of making a release run "make commanddocs"
 ---
 # rclone selfupdate

docs/content/commands/rclone_serve.md

@@ -3,6 +3,7 @@ title: "rclone serve"
 description: "Serve a remote over a protocol."
 slug: rclone_serve
 url: /commands/rclone_serve/
+versionIntroduced: v1.39
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/ and as part of making a release run "make commanddocs"
 ---
 # rclone serve

docs/content/commands/rclone_serve_dlna.md

@@ -3,6 +3,7 @@ title: "rclone serve dlna"
 description: "Serve remote:path over DLNA"
 slug: rclone_serve_dlna
 url: /commands/rclone_serve_dlna/
+versionIntroduced: v1.46
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/dlna/ and as part of making a release run "make commanddocs"
 ---
 # rclone serve dlna
@@ -362,8 +363,8 @@ rclone serve dlna remote:path [flags]
 
 ```
       --addr string                            The ip:port or :port to bind the DLNA http server to (default ":7879")
-      --announce-interval duration             The interval between SSDP announcements (default 12m0s)
+      --announce-interval Duration             The interval between SSDP announcements (default 12m0s)
-      --dir-cache-time duration                Time to cache directory entries for (default 5m0s)
+      --dir-cache-time Duration                Time to cache directory entries for (default 5m0s)
       --dir-perms FileMode                     Directory permissions (default 0777)
       --file-perms FileMode                    File permissions (default 0666)
       --gid uint32                             Override the gid field set by the filesystem (not supported on Windows) (default 1000)
@@ -374,24 +375,24 @@ rclone serve dlna remote:path [flags]
       --no-checksum                            Don't compare checksums on up/download
       --no-modtime                             Don't read/write the modification time (can speed things up)
       --no-seek                                Don't allow seeking in files
-      --poll-interval duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
+      --poll-interval Duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
       --read-only                              Only allow read-only access
       --uid uint32                             Override the uid field set by the filesystem (not supported on Windows) (default 1000)
       --umask int                              Override the permission bits set by the filesystem (not supported on Windows) (default 2)
-      --vfs-cache-max-age duration             Max age of objects in the cache (default 1h0m0s)
+      --vfs-cache-max-age Duration             Max age of objects in the cache (default 1h0m0s)
       --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-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-disk-space-total-size SizeSuffix   Specify the total space of disk (default off)
       --vfs-fast-fingerprint                   Use fast (less accurate) fingerprints for change detection
       --vfs-read-ahead SizeSuffix              Extra read ahead over --buffer-size when using cache-mode full
       --vfs-read-chunk-size SizeSuffix         Read the source objects in chunks (default 128Mi)
       --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)
-      --vfs-read-wait duration                 Time to wait for in-sequence read before seeking (default 20ms)
+      --vfs-read-wait Duration                 Time to wait for in-sequence read before seeking (default 20ms)
       --vfs-used-is-size rclone size           Use the rclone size algorithm for Used size
-      --vfs-write-back duration                Time to writeback files after last use when using cache (default 5s)
+      --vfs-write-back Duration                Time to writeback files after last use when using cache (default 5s)
-      --vfs-write-wait duration                Time to wait for in-sequence write before giving error (default 1s)
+      --vfs-write-wait Duration                Time to wait for in-sequence write before giving error (default 1s)
 ```
 
 See the [global flags page](/flags/) for global options not listed here.

docs/content/commands/rclone_serve_docker.md

@@ -3,6 +3,7 @@ title: "rclone serve docker"
 description: "Serve any remote on docker's volume plugin API."
 slug: rclone_serve_docker
 url: /commands/rclone_serve_docker/
+versionIntroduced: v1.56
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/docker/ and as part of making a release run "make commanddocs"
 ---
 # rclone serve docker
@@ -381,15 +382,15 @@ rclone serve docker [flags]
       --allow-other                            Allow access to other users (not supported on Windows)
       --allow-root                             Allow access to root user (not supported on Windows)
       --async-read                             Use asynchronous reads (not supported on Windows) (default true)
-      --attr-timeout duration                  Time for which file/directory attributes are cached (default 1s)
+      --attr-timeout Duration                  Time for which file/directory attributes are cached (default 1s)
       --base-dir string                        Base directory for volumes (default "/var/lib/docker-volumes/rclone")
       --daemon                                 Run mount in background and exit parent process (as background output is suppressed, use --log-file with --log-format=pid,... to monitor) (not supported on Windows)
-      --daemon-timeout duration                Time limit for rclone to respond to kernel (not supported on Windows)
+      --daemon-timeout Duration                Time limit for rclone to respond to kernel (not supported on Windows) (default 0s)
-      --daemon-wait duration                   Time to wait for ready mount from daemon (maximum time on Linux, constant sleep time on OSX/BSD) (not supported on Windows) (default 1m0s)
+      --daemon-wait Duration                   Time to wait for ready mount from daemon (maximum time on Linux, constant sleep time on OSX/BSD) (not supported on Windows) (default 1m0s)
       --debug-fuse                             Debug the FUSE internals - needs -v
       --default-permissions                    Makes kernel enforce access control based on the file mode (not supported on Windows)
       --devname string                         Set the device name - default is remote:path
-      --dir-cache-time duration                Time to cache directory entries for (default 5m0s)
+      --dir-cache-time Duration                Time to cache directory entries for (default 5m0s)
       --dir-perms FileMode                     Directory permissions (default 0777)
       --file-perms FileMode                    File permissions (default 0666)
       --forget-state                           Skip restoring previous state
@@ -405,26 +406,26 @@ rclone serve docker [flags]
       --noappledouble                          Ignore Apple Double (._) and .DS_Store files (supported on OSX only) (default true)
       --noapplexattr                           Ignore all "com.apple.*" extended attributes (supported on OSX only)
   -o, --option stringArray                     Option for libfuse/WinFsp (repeat if required)
-      --poll-interval duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
+      --poll-interval Duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
       --read-only                              Only allow read-only access
       --socket-addr string                     Address <host:port> or absolute path (default: /run/docker/plugins/rclone.sock)
       --socket-gid int                         GID for unix socket (default: current process GID) (default 1000)
       --uid uint32                             Override the uid field set by the filesystem (not supported on Windows) (default 1000)
       --umask int                              Override the permission bits set by the filesystem (not supported on Windows) (default 2)
-      --vfs-cache-max-age duration             Max age of objects in the cache (default 1h0m0s)
+      --vfs-cache-max-age Duration             Max age of objects in the cache (default 1h0m0s)
       --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-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-disk-space-total-size SizeSuffix   Specify the total space of disk (default off)
       --vfs-fast-fingerprint                   Use fast (less accurate) fingerprints for change detection
       --vfs-read-ahead SizeSuffix              Extra read ahead over --buffer-size when using cache-mode full
       --vfs-read-chunk-size SizeSuffix         Read the source objects in chunks (default 128Mi)
       --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)
-      --vfs-read-wait duration                 Time to wait for in-sequence read before seeking (default 20ms)
+      --vfs-read-wait Duration                 Time to wait for in-sequence read before seeking (default 20ms)
       --vfs-used-is-size rclone size           Use the rclone size algorithm for Used size
-      --vfs-write-back duration                Time to writeback files after last use when using cache (default 5s)
+      --vfs-write-back Duration                Time to writeback files after last use when using cache (default 5s)
-      --vfs-write-wait duration                Time to wait for in-sequence write before giving error (default 1s)
+      --vfs-write-wait Duration                Time to wait for in-sequence write before giving error (default 1s)
       --volname string                         Set the volume name (supported on Windows and OSX only)
       --write-back-cache                       Makes kernel buffer writes before sending them to rclone (without this, writethrough caching is used) (not supported on Windows)
 ```

docs/content/commands/rclone_serve_ftp.md

@@ -3,6 +3,7 @@ title: "rclone serve ftp"
 description: "Serve remote:path over FTP."
 slug: rclone_serve_ftp
 url: /commands/rclone_serve_ftp/
+versionIntroduced: v1.44
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/ftp/ and as part of making a release run "make commanddocs"
 ---
 # rclone serve ftp
@@ -442,7 +443,7 @@ rclone serve ftp remote:path [flags]
       --addr string                            IPaddress:Port or :Port to bind server to (default "localhost:2121")
       --auth-proxy string                      A program to use to create the backend from the auth
       --cert string                            TLS PEM key (concatenation of certificate and CA certificate)
-      --dir-cache-time duration                Time to cache directory entries for (default 5m0s)
+      --dir-cache-time Duration                Time to cache directory entries for (default 5m0s)
       --dir-perms FileMode                     Directory permissions (default 0777)
       --file-perms FileMode                    File permissions (default 0666)
       --gid uint32                             Override the gid field set by the filesystem (not supported on Windows) (default 1000)
@@ -453,26 +454,26 @@ rclone serve ftp remote:path [flags]
       --no-seek                                Don't allow seeking in files
       --pass string                            Password for authentication (empty value allow every password)
       --passive-port string                    Passive port range to use (default "30000-32000")
-      --poll-interval duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
+      --poll-interval Duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
       --public-ip string                       Public IP address to advertise for passive connections
       --read-only                              Only allow read-only access
       --uid uint32                             Override the uid field set by the filesystem (not supported on Windows) (default 1000)
       --umask int                              Override the permission bits set by the filesystem (not supported on Windows) (default 2)
       --user string                            User name for authentication (default "anonymous")
-      --vfs-cache-max-age duration             Max age of objects in the cache (default 1h0m0s)
+      --vfs-cache-max-age Duration             Max age of objects in the cache (default 1h0m0s)
       --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-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-disk-space-total-size SizeSuffix   Specify the total space of disk (default off)
       --vfs-fast-fingerprint                   Use fast (less accurate) fingerprints for change detection
       --vfs-read-ahead SizeSuffix              Extra read ahead over --buffer-size when using cache-mode full
       --vfs-read-chunk-size SizeSuffix         Read the source objects in chunks (default 128Mi)
       --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)
-      --vfs-read-wait duration                 Time to wait for in-sequence read before seeking (default 20ms)
+      --vfs-read-wait Duration                 Time to wait for in-sequence read before seeking (default 20ms)
       --vfs-used-is-size rclone size           Use the rclone size algorithm for Used size
-      --vfs-write-back duration                Time to writeback files after last use when using cache (default 5s)
+      --vfs-write-back Duration                Time to writeback files after last use when using cache (default 5s)
-      --vfs-write-wait duration                Time to wait for in-sequence write before giving error (default 1s)
+      --vfs-write-wait Duration                Time to wait for in-sequence write before giving error (default 1s)
 ```
 
 See the [global flags page](/flags/) for global options not listed here.

docs/content/commands/rclone_serve_http.md

@@ -3,6 +3,7 @@ title: "rclone serve http"
 description: "Serve the remote over HTTP."
 slug: rclone_serve_http
 url: /commands/rclone_serve_http/
+versionIntroduced: v1.39
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/http/ and as part of making a release run "make commanddocs"
 ---
 # rclone serve http
@@ -33,6 +34,12 @@ IPs.  By default it only listens on localhost.  You can use port
 If you set `--addr` to listen on a public or LAN accessible IP address
 then using Authentication is advised - see the next section for info.
 
+You can use a unix socket by setting the url to `unix:///path/to/socket`
+or just by using an absolute path name. Note that unix sockets bypass the
+authentication - this is expected to be done with file system permissions.
+
+`--addr` may be repeated to listen on multiple IPs/ports/sockets.
+
 `--server-read-timeout` and `--server-write-timeout` can be used to
 control the timeouts on the server.  Note that this is the total time
 for a transfer.
@@ -48,7 +55,7 @@ inserts leading and trailing "/" on `--baseurl`, so `--baseurl "rclone"`,
 `--baseurl "/rclone"` and `--baseurl "/rclone/"` are all treated
 identically.
 
-### SSL/TLS
+### TLS (SSL)
 
 By default this will serve over http.  If you want you can serve over
 https.  You will need to supply the `--cert` and `--key` flags.
@@ -438,47 +445,47 @@ rclone serve http remote:path [flags]
 ## Options
 
 ```
-      --addr string                            IPaddress:Port or :Port to bind server to (default "127.0.0.1:8080")
+      --addr stringArray                       IPaddress:Port or :Port to bind server to (default [127.0.0.1:8080])
       --baseurl string                         Prefix for URLs - leave blank for root
-      --cert string                            SSL PEM key (concatenation of certificate and CA certificate)
+      --cert string                            TLS PEM key (concatenation of certificate and CA certificate)
       --client-ca string                       Client certificate authority to verify clients with
-      --dir-cache-time duration                Time to cache directory entries for (default 5m0s)
+      --dir-cache-time Duration                Time to cache directory entries for (default 5m0s)
       --dir-perms FileMode                     Directory permissions (default 0777)
       --file-perms FileMode                    File permissions (default 0666)
       --gid uint32                             Override the gid field set by the filesystem (not supported on Windows) (default 1000)
   -h, --help                                   help for http
       --htpasswd string                        A htpasswd file - if not provided no authentication is done
-      --key string                             SSL PEM Private key
+      --key string                             TLS PEM Private key
       --max-header-bytes int                   Maximum size of request header (default 4096)
       --min-tls-version string                 Minimum TLS version that is acceptable (default "tls1.0")
       --no-checksum                            Don't compare checksums on up/download
       --no-modtime                             Don't read/write the modification time (can speed things up)
       --no-seek                                Don't allow seeking in files
       --pass string                            Password for authentication
-      --poll-interval duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
+      --poll-interval Duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
       --read-only                              Only allow read-only access
       --realm string                           Realm for authentication
       --salt string                            Password hashing salt (default "dlPL2MqE")
-      --server-read-timeout duration           Timeout for server reading data (default 1h0m0s)
+      --server-read-timeout Duration           Timeout for server reading data (default 1h0m0s)
-      --server-write-timeout duration          Timeout for server writing data (default 1h0m0s)
+      --server-write-timeout Duration          Timeout for server writing data (default 1h0m0s)
       --template string                        User-specified template
       --uid uint32                             Override the uid field set by the filesystem (not supported on Windows) (default 1000)
       --umask int                              Override the permission bits set by the filesystem (not supported on Windows) (default 2)
       --user string                            User name for authentication
-      --vfs-cache-max-age duration             Max age of objects in the cache (default 1h0m0s)
+      --vfs-cache-max-age Duration             Max age of objects in the cache (default 1h0m0s)
       --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-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-disk-space-total-size SizeSuffix   Specify the total space of disk (default off)
       --vfs-fast-fingerprint                   Use fast (less accurate) fingerprints for change detection
       --vfs-read-ahead SizeSuffix              Extra read ahead over --buffer-size when using cache-mode full
       --vfs-read-chunk-size SizeSuffix         Read the source objects in chunks (default 128Mi)
       --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)
-      --vfs-read-wait duration                 Time to wait for in-sequence read before seeking (default 20ms)
+      --vfs-read-wait Duration                 Time to wait for in-sequence read before seeking (default 20ms)
       --vfs-used-is-size rclone size           Use the rclone size algorithm for Used size
-      --vfs-write-back duration                Time to writeback files after last use when using cache (default 5s)
+      --vfs-write-back Duration                Time to writeback files after last use when using cache (default 5s)
-      --vfs-write-wait duration                Time to wait for in-sequence write before giving error (default 1s)
+      --vfs-write-wait Duration                Time to wait for in-sequence write before giving error (default 1s)
 ```
 
 See the [global flags page](/flags/) for global options not listed here.

docs/content/commands/rclone_serve_restic.md

@@ -3,6 +3,7 @@ title: "rclone serve restic"
 description: "Serve the remote for restic's REST API."
 slug: rclone_serve_restic
 url: /commands/rclone_serve_restic/
+versionIntroduced: v1.40
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/restic/ and as part of making a release run "make commanddocs"
 ---
 # rclone serve restic
@@ -96,13 +97,19 @@ with a path of `/<username>/`.
 ## Server options
 
 Use `--addr` to specify which IP address and port the server should
-listen on, e.g. `--addr 1.2.3.4:8000` or `--addr :8080` to
+listen on, eg `--addr 1.2.3.4:8000` or `--addr :8080` to listen to all
-listen to all IPs.  By default it only listens on localhost.  You can use port
+IPs.  By default it only listens on localhost.  You can use port
 :0 to let the OS choose an available port.
 
 If you set `--addr` to listen on a public or LAN accessible IP address
 then using Authentication is advised - see the next section for info.
 
+You can use a unix socket by setting the url to `unix:///path/to/socket`
+or just by using an absolute path name. Note that unix sockets bypass the
+authentication - this is expected to be done with file system permissions.
+
+`--addr` may be repeated to listen on multiple IPs/ports/sockets.
+
 `--server-read-timeout` and `--server-write-timeout` can be used to
 control the timeouts on the server.  Note that this is the total time
 for a transfer.
@@ -118,28 +125,21 @@ inserts leading and trailing "/" on `--baseurl`, so `--baseurl "rclone"`,
 `--baseurl "/rclone"` and `--baseurl "/rclone/"` are all treated
 identically.
 
-`--template` allows a user to specify a custom markup template for HTTP
+### TLS (SSL)
-and WebDAV serve functions.  The server exports the following markup
-to be used within the template to server pages:
 
-| Parameter   | Description |
+By default this will serve over http.  If you want you can serve over
-| :---------- | :---------- |
+https.  You will need to supply the `--cert` and `--key` flags.
-| .Name       | The full path of a file/directory. |
+If you wish to do client side certificate validation then you will need to
-| .Title      | Directory listing of .Name |
+supply `--client-ca` also.
-| .Sort       | The current sort used.  This is changeable via ?sort= parameter |
+
-|             | Sort Options: namedirfirst,name,size,time (default namedirfirst) |
+`--cert` should be a either a PEM encoded certificate or a concatenation
-| .Order      | The current ordering used.  This is changeable via ?order= parameter |
+of that with the CA certificate.  `--key` should be the PEM encoded
-|             | Order Options: asc,desc (default asc) |
+private key and `--client-ca` should be the PEM encoded client
-| .Query      | Currently unused. |
+certificate authority certificate.
-| .Breadcrumb | Allows for creating a relative navigation |
+
-|-- .Link     | The relative to the root link of the Text. |
+--min-tls-version is minimum TLS version that is acceptable. Valid
-|-- .Text     | The Name of the directory. |
+  values are "tls1.0", "tls1.1", "tls1.2" and "tls1.3" (default
-| .Entries    | Information about a specific file/directory. |
+  "tls1.0").
-|-- .URL      | The 'url' of an entry.  |
-|-- .Leaf     | Currently same as 'URL' but intended to be 'just' the name. |
-|-- .IsDir    | Boolean for if an entry is a directory or not. |
-|-- .Size     | Size in Bytes of the entry. |
-|-- .ModTime  | The UTC timestamp of an entry. |
 
 ### Authentication
 
@@ -162,21 +162,7 @@ The password file can be updated while rclone is running.
 
 Use `--realm` to set the authentication realm.
 
-### SSL/TLS
+Use `--salt` to change the password hashing salt from the default.
-
-By default this will serve over HTTP.  If you want you can serve over
-HTTPS.  You will need to supply the `--cert` and `--key` flags.
-If you wish to do client side certificate validation then you will need to
-supply `--client-ca` also.
-
-`--cert` should be either a PEM encoded certificate or a concatenation
-of that with the CA certificate.  `--key` should be the PEM encoded
-private key and `--client-ca` should be the PEM encoded client
-certificate authority certificate.
-
---min-tls-version is minimum TLS version that is acceptable. Valid
-  values are "tls1.0", "tls1.1", "tls1.2" and "tls1.3" (default
-  "tls1.0").
 
 
 ```
@@ -186,24 +172,24 @@ rclone serve restic remote:path [flags]
 ## Options
 
 ```
-      --addr string                     IPaddress:Port or :Port to bind server to (default "localhost:8080")
+      --addr stringArray                IPaddress:Port or :Port to bind server to (default [127.0.0.1:8080])
       --append-only                     Disallow deletion of repository data
       --baseurl string                  Prefix for URLs - leave blank for root
       --cache-objects                   Cache listed objects (default true)
-      --cert string                     SSL PEM key (concatenation of certificate and CA certificate)
+      --cert string                     TLS PEM key (concatenation of certificate and CA certificate)
       --client-ca string                Client certificate authority to verify clients with
   -h, --help                            help for restic
-      --htpasswd string                 htpasswd file - if not provided no authentication is done
+      --htpasswd string                 A htpasswd file - if not provided no authentication is done
-      --key string                      SSL PEM Private key
+      --key string                      TLS PEM Private key
       --max-header-bytes int            Maximum size of request header (default 4096)
       --min-tls-version string          Minimum TLS version that is acceptable (default "tls1.0")
       --pass string                     Password for authentication
       --private-repos                   Users can only access their private repo
-      --realm string                    Realm for authentication (default "rclone")
+      --realm string                    Realm for authentication
-      --server-read-timeout duration    Timeout for server reading data (default 1h0m0s)
+      --salt string                     Password hashing salt (default "dlPL2MqE")
-      --server-write-timeout duration   Timeout for server writing data (default 1h0m0s)
+      --server-read-timeout Duration    Timeout for server reading data (default 1h0m0s)
+      --server-write-timeout Duration   Timeout for server writing data (default 1h0m0s)
       --stdio                           Run an HTTP2 server on stdin/stdout
-      --template string                 User-specified template
       --user string                     User name for authentication
 ```
 

docs/content/commands/rclone_serve_sftp.md

@@ -3,6 +3,7 @@ title: "rclone serve sftp"
 description: "Serve the remote over SFTP."
 slug: rclone_serve_sftp
 url: /commands/rclone_serve_sftp/
+versionIntroduced: v1.48
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/sftp/ and as part of making a release run "make commanddocs"
 ---
 # rclone serve sftp
@@ -474,7 +475,7 @@ rclone serve sftp remote:path [flags]
       --addr string                            IPaddress:Port or :Port to bind server to (default "localhost:2022")
       --auth-proxy string                      A program to use to create the backend from the auth
       --authorized-keys string                 Authorized keys file (default "~/.ssh/authorized_keys")
-      --dir-cache-time duration                Time to cache directory entries for (default 5m0s)
+      --dir-cache-time Duration                Time to cache directory entries for (default 5m0s)
       --dir-perms FileMode                     Directory permissions (default 0777)
       --file-perms FileMode                    File permissions (default 0666)
       --gid uint32                             Override the gid field set by the filesystem (not supported on Windows) (default 1000)
@@ -485,26 +486,26 @@ rclone serve sftp remote:path [flags]
       --no-modtime                             Don't read/write the modification time (can speed things up)
       --no-seek                                Don't allow seeking in files
       --pass string                            Password for authentication
-      --poll-interval duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
+      --poll-interval Duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
       --read-only                              Only allow read-only access
       --stdio                                  Run an sftp server on stdin/stdout
       --uid uint32                             Override the uid field set by the filesystem (not supported on Windows) (default 1000)
       --umask int                              Override the permission bits set by the filesystem (not supported on Windows) (default 2)
       --user string                            User name for authentication
-      --vfs-cache-max-age duration             Max age of objects in the cache (default 1h0m0s)
+      --vfs-cache-max-age Duration             Max age of objects in the cache (default 1h0m0s)
       --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-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-disk-space-total-size SizeSuffix   Specify the total space of disk (default off)
       --vfs-fast-fingerprint                   Use fast (less accurate) fingerprints for change detection
       --vfs-read-ahead SizeSuffix              Extra read ahead over --buffer-size when using cache-mode full
       --vfs-read-chunk-size SizeSuffix         Read the source objects in chunks (default 128Mi)
       --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)
-      --vfs-read-wait duration                 Time to wait for in-sequence read before seeking (default 20ms)
+      --vfs-read-wait Duration                 Time to wait for in-sequence read before seeking (default 20ms)
       --vfs-used-is-size rclone size           Use the rclone size algorithm for Used size
-      --vfs-write-back duration                Time to writeback files after last use when using cache (default 5s)
+      --vfs-write-back Duration                Time to writeback files after last use when using cache (default 5s)
-      --vfs-write-wait duration                Time to wait for in-sequence write before giving error (default 1s)
+      --vfs-write-wait Duration                Time to wait for in-sequence write before giving error (default 1s)
 ```
 
 See the [global flags page](/flags/) for global options not listed here.

docs/content/commands/rclone_serve_webdav.md

@@ -3,6 +3,7 @@ title: "rclone serve webdav"
 description: "Serve remote:path over WebDAV."
 slug: rclone_serve_webdav
 url: /commands/rclone_serve_webdav/
+versionIntroduced: v1.39
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/webdav/ and as part of making a release run "make commanddocs"
 ---
 # rclone serve webdav
@@ -31,13 +32,19 @@ to see the full list.
 ## Server options
 
 Use `--addr` to specify which IP address and port the server should
-listen on, e.g. `--addr 1.2.3.4:8000` or `--addr :8080` to
+listen on, eg `--addr 1.2.3.4:8000` or `--addr :8080` to listen to all
-listen to all IPs.  By default it only listens on localhost.  You can use port
+IPs.  By default it only listens on localhost.  You can use port
 :0 to let the OS choose an available port.
 
 If you set `--addr` to listen on a public or LAN accessible IP address
 then using Authentication is advised - see the next section for info.
 
+You can use a unix socket by setting the url to `unix:///path/to/socket`
+or just by using an absolute path name. Note that unix sockets bypass the
+authentication - this is expected to be done with file system permissions.
+
+`--addr` may be repeated to listen on multiple IPs/ports/sockets.
+
 `--server-read-timeout` and `--server-write-timeout` can be used to
 control the timeouts on the server.  Note that this is the total time
 for a transfer.
@@ -53,6 +60,24 @@ inserts leading and trailing "/" on `--baseurl`, so `--baseurl "rclone"`,
 `--baseurl "/rclone"` and `--baseurl "/rclone/"` are all treated
 identically.
 
+### TLS (SSL)
+
+By default this will serve over http.  If you want you can serve over
+https.  You will need to supply the `--cert` and `--key` flags.
+If you wish to do client side certificate validation then you will need to
+supply `--client-ca` also.
+
+`--cert` should be a either a PEM encoded certificate or a concatenation
+of that with the CA certificate.  `--key` should be the PEM encoded
+private key and `--client-ca` should be the PEM encoded client
+certificate authority certificate.
+
+--min-tls-version is minimum TLS version that is acceptable. Valid
+  values are "tls1.0", "tls1.1", "tls1.2" and "tls1.3" (default
+  "tls1.0").
+
+### Template
+
 `--template` allows a user to specify a custom markup template for HTTP
 and WebDAV serve functions.  The server exports the following markup
 to be used within the template to server pages:
@@ -97,21 +122,7 @@ The password file can be updated while rclone is running.
 
 Use `--realm` to set the authentication realm.
 
-### SSL/TLS
+Use `--salt` to change the password hashing salt from the default.
-
-By default this will serve over HTTP.  If you want you can serve over
-HTTPS.  You will need to supply the `--cert` and `--key` flags.
-If you wish to do client side certificate validation then you will need to
-supply `--client-ca` also.
-
-`--cert` should be either a PEM encoded certificate or a concatenation
-of that with the CA certificate.  `--key` should be the PEM encoded
-private key and `--client-ca` should be the PEM encoded client
-certificate authority certificate.
-
---min-tls-version is minimum TLS version that is acceptable. Valid
-  values are "tls1.0", "tls1.1", "tls1.2" and "tls1.3" (default
-  "tls1.0").
 
 ## VFS - Virtual File System
 
@@ -520,49 +531,50 @@ rclone serve webdav remote:path [flags]
 ## Options
 
 ```
-      --addr string                            IPaddress:Port or :Port to bind server to (default "localhost:8080")
+      --addr stringArray                       IPaddress:Port or :Port to bind server to (default [127.0.0.1:8080])
       --auth-proxy string                      A program to use to create the backend from the auth
       --baseurl string                         Prefix for URLs - leave blank for root
-      --cert string                            SSL PEM key (concatenation of certificate and CA certificate)
+      --cert string                            TLS PEM key (concatenation of certificate and CA certificate)
       --client-ca string                       Client certificate authority to verify clients with
-      --dir-cache-time duration                Time to cache directory entries for (default 5m0s)
+      --dir-cache-time Duration                Time to cache directory entries for (default 5m0s)
       --dir-perms FileMode                     Directory permissions (default 0777)
       --disable-dir-list                       Disable HTML directory list on GET request for a directory
       --etag-hash string                       Which hash to use for the ETag, or auto or blank for off
       --file-perms FileMode                    File permissions (default 0666)
       --gid uint32                             Override the gid field set by the filesystem (not supported on Windows) (default 1000)
   -h, --help                                   help for webdav
-      --htpasswd string                        htpasswd file - if not provided no authentication is done
+      --htpasswd string                        A htpasswd file - if not provided no authentication is done
-      --key string                             SSL PEM Private key
+      --key string                             TLS PEM Private key
       --max-header-bytes int                   Maximum size of request header (default 4096)
       --min-tls-version string                 Minimum TLS version that is acceptable (default "tls1.0")
       --no-checksum                            Don't compare checksums on up/download
       --no-modtime                             Don't read/write the modification time (can speed things up)
       --no-seek                                Don't allow seeking in files
       --pass string                            Password for authentication
-      --poll-interval duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
+      --poll-interval Duration                 Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable) (default 1m0s)
       --read-only                              Only allow read-only access
-      --realm string                           Realm for authentication (default "rclone")
+      --realm string                           Realm for authentication
-      --server-read-timeout duration           Timeout for server reading data (default 1h0m0s)
+      --salt string                            Password hashing salt (default "dlPL2MqE")
-      --server-write-timeout duration          Timeout for server writing data (default 1h0m0s)
+      --server-read-timeout Duration           Timeout for server reading data (default 1h0m0s)
+      --server-write-timeout Duration          Timeout for server writing data (default 1h0m0s)
       --template string                        User-specified template
       --uid uint32                             Override the uid field set by the filesystem (not supported on Windows) (default 1000)
       --umask int                              Override the permission bits set by the filesystem (not supported on Windows) (default 2)
       --user string                            User name for authentication
-      --vfs-cache-max-age duration             Max age of objects in the cache (default 1h0m0s)
+      --vfs-cache-max-age Duration             Max age of objects in the cache (default 1h0m0s)
       --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-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-disk-space-total-size SizeSuffix   Specify the total space of disk (default off)
       --vfs-fast-fingerprint                   Use fast (less accurate) fingerprints for change detection
       --vfs-read-ahead SizeSuffix              Extra read ahead over --buffer-size when using cache-mode full
       --vfs-read-chunk-size SizeSuffix         Read the source objects in chunks (default 128Mi)
       --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)
-      --vfs-read-wait duration                 Time to wait for in-sequence read before seeking (default 20ms)
+      --vfs-read-wait Duration                 Time to wait for in-sequence read before seeking (default 20ms)
       --vfs-used-is-size rclone size           Use the rclone size algorithm for Used size
-      --vfs-write-back duration                Time to writeback files after last use when using cache (default 5s)
+      --vfs-write-back Duration                Time to writeback files after last use when using cache (default 5s)
-      --vfs-write-wait duration                Time to wait for in-sequence write before giving error (default 1s)
+      --vfs-write-wait Duration                Time to wait for in-sequence write before giving error (default 1s)
 ```
 
 See the [global flags page](/flags/) for global options not listed here.

docs/content/commands/rclone_settier.md

@@ -3,6 +3,7 @@ title: "rclone settier"
 description: "Changes storage class/tier of objects in remote."
 slug: rclone_settier
 url: /commands/rclone_settier/
+versionIntroduced: v1.44
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/settier/ and as part of making a release run "make commanddocs"
 ---
 # rclone settier

docs/content/commands/rclone_sha1sum.md

@@ -3,6 +3,7 @@ title: "rclone sha1sum"
 description: "Produces an sha1sum file for all the objects in the path."
 slug: rclone_sha1sum
 url: /commands/rclone_sha1sum/
+versionIntroduced: v1.27
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/sha1sum/ and as part of making a release run "make commanddocs"
 ---
 # rclone sha1sum

docs/content/commands/rclone_size.md

@@ -3,6 +3,7 @@ title: "rclone size"
 description: "Prints the total size and number of objects in remote:path."
 slug: rclone_size
 url: /commands/rclone_size/
+versionIntroduced: v1.23
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/size/ and as part of making a release run "make commanddocs"
 ---
 # rclone size

docs/content/commands/rclone_test.md

@@ -3,6 +3,7 @@ title: "rclone test"
 description: "Run a test command"
 slug: rclone_test
 url: /commands/rclone_test/
+versionIntroduced: v1.55
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/test/ and as part of making a release run "make commanddocs"
 ---
 # rclone test

docs/content/commands/rclone_test_changenotify.md

@@ -3,6 +3,7 @@ title: "rclone test changenotify"
 description: "Log any change notify requests for the remote passed in."
 slug: rclone_test_changenotify
 url: /commands/rclone_test_changenotify/
+versionIntroduced: v1.56
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/test/changenotify/ and as part of making a release run "make commanddocs"
 ---
 # rclone test changenotify
@@ -17,7 +18,7 @@ rclone test changenotify remote: [flags]
 
 ```
   -h, --help                     help for changenotify
-      --poll-interval duration   Time to wait between polling for changes (default 10s)
+      --poll-interval Duration   Time to wait between polling for changes (default 10s)
 ```
 
 See the [global flags page](/flags/) for global options not listed here.

docs/content/commands/rclone_test_histogram.md

@@ -3,6 +3,7 @@ title: "rclone test histogram"
 description: "Makes a histogram of file name characters."
 slug: rclone_test_histogram
 url: /commands/rclone_test_histogram/
+versionIntroduced: v1.55
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/test/histogram/ and as part of making a release run "make commanddocs"
 ---
 # rclone test histogram

docs/content/commands/rclone_test_info.md

@@ -3,6 +3,7 @@ title: "rclone test info"
 description: "Discovers file name or other limitations for paths."
 slug: rclone_test_info
 url: /commands/rclone_test_info/
+versionIntroduced: v1.55
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/test/info/ and as part of making a release run "make commanddocs"
 ---
 # rclone test info
@@ -32,7 +33,7 @@ rclone test info [remote:path]+ [flags]
       --check-normalization    Check UTF-8 Normalization
       --check-streaming        Check uploads with indeterminate file size
   -h, --help                   help for info
-      --upload-wait duration   Wait after writing a file
+      --upload-wait Duration   Wait after writing a file (default 0s)
       --write-json string      Write results to file
 ```
 

docs/content/commands/rclone_test_makefile.md

@@ -3,6 +3,7 @@ title: "rclone test makefile"
 description: "Make files with random contents of the size given"
 slug: rclone_test_makefile
 url: /commands/rclone_test_makefile/
+versionIntroduced: v1.59
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/test/makefile/ and as part of making a release run "make commanddocs"
 ---
 # rclone test makefile

docs/content/commands/rclone_test_makefiles.md

@@ -3,6 +3,7 @@ title: "rclone test makefiles"
 description: "Make a random file hierarchy in a directory"
 slug: rclone_test_makefiles
 url: /commands/rclone_test_makefiles/
+versionIntroduced: v1.55
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/test/makefiles/ and as part of making a release run "make commanddocs"
 ---
 # rclone test makefiles
@@ -21,6 +22,7 @@ rclone test makefiles <dir> [flags]
       --files int                  Number of files to create (default 1000)
       --files-per-directory int    Average number of files per directory (default 10)
   -h, --help                       help for makefiles
+      --max-depth int              Maximum depth of directory hierarchy (default 10)
       --max-file-size SizeSuffix   Maximum size of files to create (default 100)
       --max-name-length int        Maximum size of file names (default 12)
       --min-file-size SizeSuffix   Minimum size of file to create

docs/content/commands/rclone_test_memory.md

@@ -3,6 +3,7 @@ title: "rclone test memory"
 description: "Load all the objects at remote:path into memory and report memory stats."
 slug: rclone_test_memory
 url: /commands/rclone_test_memory/
+versionIntroduced: v1.55
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/test/memory/ and as part of making a release run "make commanddocs"
 ---
 # rclone test memory

docs/content/commands/rclone_touch.md

@@ -3,6 +3,7 @@ title: "rclone touch"
 description: "Create new file or change file modification time."
 slug: rclone_touch
 url: /commands/rclone_touch/
+versionIntroduced: v1.39
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/touch/ and as part of making a release run "make commanddocs"
 ---
 # rclone touch

docs/content/commands/rclone_tree.md

@@ -3,6 +3,7 @@ title: "rclone tree"
 description: "List the contents of the remote in a tree like fashion."
 slug: rclone_tree
 url: /commands/rclone_tree/
+versionIntroduced: v1.38
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/tree/ and as part of making a release run "make commanddocs"
 ---
 # rclone tree

docs/content/commands/rclone_version.md

@@ -3,6 +3,7 @@ title: "rclone version"
 description: "Show the version number."
 slug: rclone_version
 url: /commands/rclone_version/
+versionIntroduced: v1.33
 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/version/ and as part of making a release run "make commanddocs"
 ---
 # rclone version

docs/content/flags.md

@@ -27,10 +27,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
-      --color                                Define when colors (and other ANSI codes) should be shown AUTO|ALWAYS|NEVER (default AUTO)
+      --color string                         When to show colors (and other ANSI codes) AUTO|NEVER|ALWAYS (default "AUTO")
       --compare-dest stringArray             Include additional comma separated server-side paths during comparison
       --config string                        Config file (default "$HOME/.config/rclone/rclone.conf")
-      --contimeout duration                  Connect timeout (default 1m0s)
+      --contimeout Duration                  Connect timeout (default 1m0s)
       --copy-dest stringArray                Implies --compare-dest but also copies files from paths into destination
       --cpuprofile string                    Write cpu profile to file
       --cutoff-mode string                   Mode to stop transfers when reaching the max transfer limit HARD|SOFT|CAUTIOUS (default "HARD")
@@ -48,16 +48,16 @@ These flags are available for every command.
       --dump-headers                         Dump HTTP headers - may contain sensitive info
       --error-on-no-transfer                 Sets exit code 9 if no files are transferred, useful in scripts
       --exclude stringArray                  Exclude files matching pattern
-      --exclude-from stringArray             Read exclude patterns from file (use - to read from stdin)
+      --exclude-from stringArray             Read file exclude patterns from file (use - to read from stdin)
       --exclude-if-present stringArray       Exclude directories if filename is present
-      --expect-continue-timeout duration     Timeout when using expect / 100-continue in HTTP (default 1s)
+      --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 (use - to read from stdin)
       --files-from-raw stringArray           Read list of source-file names from file without any processing of lines (use - to read from stdin)
-  -f, --filter stringArray                   Add a file-filtering rule
+  -f, --filter stringArray                   Add a file filtering rule
-      --filter-from stringArray              Read filtering patterns from a file (use - to read from stdin)
+      --filter-from stringArray              Read file filtering patterns from a file (use - to read from stdin)
-      --fs-cache-expire-duration duration    Cache remotes for this long (0 to disable caching) (default 5m0s)
+      --fs-cache-expire-duration Duration    Cache remotes for this long (0 to disable caching) (default 5m0s)
-      --fs-cache-expire-interval duration    Interval to check for expired remotes (default 1m0s)
+      --fs-cache-expire-interval Duration    Interval to check for expired remotes (default 1m0s)
       --header stringArray                   Set HTTP header for all transactions
       --header-download stringArray          Set HTTP header for download transactions
       --header-upload stringArray            Set HTTP header for upload transactions
@@ -71,9 +71,9 @@ These flags are available for every command.
   -I, --ignore-times                         Don't skip files that match size and time - transfer all files
       --immutable                            Do not modify files, fail if existing files have been modified
       --include stringArray                  Include files matching pattern
-      --include-from stringArray             Read include patterns from file (use - to read from stdin)
+      --include-from stringArray             Read file include patterns from file (use - to read from stdin)
   -i, --interactive                          Enable interactive mode
-      --kv-lock-time duration                Maximum time to keep key-value database locked by process (default 1s)
+      --kv-lock-time Duration                Maximum time to keep key-value database locked by process (default 1s)
       --log-file string                      Log everything to this file
       --log-format string                    Comma separated list of log format options (default "date,time")
       --log-level string                     Log level DEBUG|INFO|NOTICE|ERROR (default "NOTICE")
@@ -83,16 +83,22 @@ 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-duration Duration                Maximum duration rclone will transfer data for (default 0s)
       --max-size SizeSuffix                  Only transfer files smaller than this in KiB or suffix B|K|M|G|T|P (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)
       --memprofile string                    Write memory profile to file
   -M, --metadata                             If set, preserve metadata when copying objects
+      --metadata-exclude stringArray         Exclude metadatas matching pattern
+      --metadata-exclude-from stringArray    Read metadata exclude patterns from file (use - to read from stdin)
+      --metadata-filter stringArray          Add a metadata filtering rule
+      --metadata-filter-from stringArray     Read metadata filtering patterns from a file (use - to read from stdin)
+      --metadata-include stringArray         Include metadatas matching pattern
+      --metadata-include-from stringArray    Read metadata include patterns from file (use - to read from stdin)
       --metadata-set stringArray             Add metadata key=value when uploading
       --min-age Duration                     Only transfer files older than this in s or suffix ms|s|m|h|d|w|M|y (default off)
       --min-size SizeSuffix                  Only transfer files bigger than this in KiB or suffix B|K|M|G|T|P (default off)
-      --modify-window duration               Max time diff to be considered the same (default 1ns)
+      --modify-window Duration               Max time diff to be considered the same (default 1ns)
       --multi-thread-cutoff SizeSuffix       Use multi-thread downloads for files above this size (default 250Mi)
       --multi-thread-streams int             Max number of streams to use for multi-thread downloads (default 4)
       --no-check-certificate                 Do not verify the server SSL certificate (insecure)
@@ -108,25 +114,26 @@ These flags are available for every command.
       --progress-terminal-title              Show progress on the terminal title (requires -P/--progress)
   -q, --quiet                                Print as little stuff as possible
       --rc                                   Enable the remote control server
-      --rc-addr string                       IPaddress:Port or :Port to bind server to (default "localhost:5572")
+      --rc-addr stringArray                  IPaddress:Port or :Port to bind server to (default [localhost:5572])
       --rc-allow-origin string               Set the allowed origin for CORS
       --rc-baseurl string                    Prefix for URLs - leave blank for root
-      --rc-cert string                       SSL PEM key (concatenation of certificate and CA certificate)
+      --rc-cert string                       TLS PEM key (concatenation of certificate and CA certificate)
       --rc-client-ca string                  Client certificate authority to verify clients with
       --rc-enable-metrics                    Enable prometheus metrics on /metrics
       --rc-files string                      Path to local files to serve on the HTTP server
-      --rc-htpasswd string                   htpasswd file - if not provided no authentication is done
+      --rc-htpasswd string                   A htpasswd file - if not provided no authentication is done
-      --rc-job-expire-duration duration      Expire finished async jobs older than this value (default 1m0s)
+      --rc-job-expire-duration Duration      Expire finished async jobs older than this value (default 1m0s)
-      --rc-job-expire-interval duration      Interval to check for expired async jobs (default 10s)
+      --rc-job-expire-interval Duration      Interval to check for expired async jobs (default 10s)
-      --rc-key string                        SSL PEM Private key
+      --rc-key string                        TLS PEM Private key
       --rc-max-header-bytes int              Maximum size of request header (default 4096)
       --rc-min-tls-version string            Minimum TLS version that is acceptable (default "tls1.0")
       --rc-no-auth                           Don't require auth for certain methods
       --rc-pass string                       Password for authentication
-      --rc-realm string                      Realm for authentication (default "rclone")
+      --rc-realm string                      Realm for authentication
+      --rc-salt string                       Password hashing salt (default "dlPL2MqE")
       --rc-serve                             Enable the serving of remote objects
-      --rc-server-read-timeout duration      Timeout for server reading data (default 1h0m0s)
+      --rc-server-read-timeout Duration      Timeout for server reading data (default 1h0m0s)
-      --rc-server-write-timeout duration     Timeout for server writing data (default 1h0m0s)
+      --rc-server-write-timeout Duration     Timeout for server writing data (default 1h0m0s)
       --rc-template string                   User-specified template
       --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")
@@ -136,10 +143,10 @@ These flags are available for every command.
       --rc-web-gui-update                    Check and update to latest version of web gui
       --refresh-times                        Refresh the modtime of remote files
       --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)
+      --retries-sleep Duration               Interval between retrying operations if they fail, e.g. 500ms, 60s, 5m (0 to disable) (default 0s)
       --server-side-across-configs           Allow server-side operations (e.g. copy) to work across different configs
       --size-only                            Skip based on size only, not mod-time or checksum
-      --stats duration                       Interval between printing stats, e.g. 500ms, 60s, 5m (0 to disable) (default 1m0s)
+      --stats Duration                       Interval between printing stats, e.g. 500ms, 60s, 5m (0 to disable) (default 1m0s)
       --stats-file-name-length int           Max file name length in stats (0 for no limit) (default 45)
       --stats-log-level string               Log level to show --stats output DEBUG|INFO|NOTICE|ERROR (default "INFO")
       --stats-one-line                       Make the stats fit on one line
@@ -152,7 +159,7 @@ These flags are available for every command.
       --syslog                               Use Syslog for logging
       --syslog-facility string               Facility for syslog, e.g. KERN,USER,... (default "DAEMON")
       --temp-dir string                      Directory rclone will use for temporary files (default "/tmp")
-      --timeout duration                     IO idle timeout (default 5m0s)
+      --timeout Duration                     IO idle timeout (default 5m0s)
       --tpslimit float                       Limit HTTP transactions per second to this
       --tpslimit-burst int                   Max burst of transactions for --tpslimit (default 1)
       --track-renames                        When synchronizing, track file renames and do a server-side move if possible
@@ -163,7 +170,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 (default "rclone/v1.60.0")
+      --user-agent string                    Set the user-agent to a specified string (default "rclone/v1.61.0")
   -v, --verbose count                        Print lots more stuff (repeat for more)
 ```
 
@@ -183,27 +190,37 @@ and may be set in the config file.
       --acd-upload-wait-per-gb Duration                Additional time per GiB to wait after a failed complete upload to see if it appears (default 3m0s)
       --alias-remote string                            Remote or path to alias
       --azureblob-access-tier string                   Access tier of blob: hot, cool or archive
-      --azureblob-account string                     Storage Account Name
+      --azureblob-account string                       Azure Storage Account Name
       --azureblob-archive-tier-delete                  Delete archive tier blobs before overwriting
       --azureblob-chunk-size SizeSuffix                Upload chunk size (default 4Mi)
+      --azureblob-client-certificate-password string   Password for the certificate file (optional) (obscured)
+      --azureblob-client-certificate-path string       Path to a PEM or PKCS12 certificate file including the private key
+      --azureblob-client-id string                     The ID of the client in use
+      --azureblob-client-secret string                 One of the service principal's client secrets
+      --azureblob-client-send-certificate-chain        Send the certificate chain when using certificate auth
       --azureblob-disable-checksum                     Don't store MD5 checksum with object metadata
       --azureblob-encoding MultiEncoder                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
+      --azureblob-env-auth                             Read credentials from runtime (environment variables, CLI or MSI)
+      --azureblob-key string                           Storage Account Shared Key
       --azureblob-list-chunk int                       Size of blob list (default 5000)
       --azureblob-memory-pool-flush-time Duration      How often internal memory buffer pools will be flushed (default 1m0s)
       --azureblob-memory-pool-use-mmap                 Whether to use mmap buffers in internal memory pool
       --azureblob-msi-client-id string                 Object ID of the user-assigned MSI to use, if any
       --azureblob-msi-mi-res-id string                 Azure resource ID of the user-assigned MSI to use, if any
       --azureblob-msi-object-id string                 Object ID of the user-assigned MSI to use, if any
+      --azureblob-no-check-container                   If set, don't attempt to check the container exists or create it
       --azureblob-no-head-object                       If set, do not do HEAD before GET when getting objects
+      --azureblob-password string                      The user's password (obscured)
       --azureblob-public-access string                 Public access level of a container: blob or container
       --azureblob-sas-url string                       SAS URL for container level access only
       --azureblob-service-principal-file string        Path to file containing credentials for use with a service principal
+      --azureblob-tenant string                        ID of the service principal's tenant. Also called its directory ID
       --azureblob-upload-concurrency int               Concurrency for multipart uploads (default 16)
       --azureblob-upload-cutoff string                 Cutoff for switching to chunked upload (<= 256 MiB) (deprecated)
       --azureblob-use-emulator                         Uses local storage emulator if provided as 'true'
       --azureblob-use-msi                              Use a managed service identity to authenticate (only works in Azure)
+      --azureblob-username string                      User name (usually an email address)
       --b2-account string                              Account ID or Application Key ID
       --b2-chunk-size SizeSuffix                       Upload chunk size (default 96Mi)
       --b2-copy-cutoff SizeSuffix                      Cutoff for switching to multipart copy (default 4Gi)
@@ -546,6 +563,7 @@ and may be set in the config file.
       --s3-max-upload-parts int                        Maximum number of parts in a multipart upload (default 10000)
       --s3-memory-pool-flush-time Duration             How often internal memory buffer pools will be flushed (default 1m0s)
       --s3-memory-pool-use-mmap                        Whether to use mmap buffers in internal memory pool
+      --s3-might-gzip Tristate                         Set this if the backend might gzip objects (default unset)
       --s3-no-check-bucket                             If set, don't attempt to check the bucket exists or create it
       --s3-no-head                                     If set, don't HEAD uploaded objects to check integrity
       --s3-no-head-object                              If set, do not do HEAD before GET when getting objects
@@ -582,17 +600,20 @@ and may be set in the config file.
       --seafile-user string                            User name (usually email address)
       --sftp-ask-password                              Allow asking for SFTP password when needed
       --sftp-chunk-size SizeSuffix                     Upload and download chunk size (default 32Ki)
+      --sftp-ciphers SpaceSepList                      Space separated list of ciphers to be used for session encryption, ordered by preference
       --sftp-concurrency int                           The maximum number of outstanding requests for one file (default 64)
       --sftp-disable-concurrent-reads                  If set don't use concurrent reads
       --sftp-disable-concurrent-writes                 If set don't use concurrent writes
       --sftp-disable-hashcheck                         Disable the execution of SSH commands to determine if remote file hashing is available
       --sftp-host string                               SSH host to connect to
       --sftp-idle-timeout Duration                     Max time before closing idle connections (default 1m0s)
+      --sftp-key-exchange SpaceSepList                 Space separated list of key exchange algorithms, ordered by preference
       --sftp-key-file string                           Path to PEM-encoded private key file
       --sftp-key-file-pass string                      The passphrase to decrypt the PEM-encoded private key file (obscured)
       --sftp-key-pem string                            Raw PEM-encoded private key
       --sftp-key-use-agent                             When set forces the usage of the ssh-agent
       --sftp-known-hosts-file string                   Optional path to known_hosts file
+      --sftp-macs SpaceSepList                         Space separated list of MACs (message authentication code) algorithms, ordered by preference
       --sftp-md5sum-command string                     The command used to read md5 hashes
       --sftp-pass string                               SSH password, leave blank to use ssh-agent (obscured)
       --sftp-path-override string                      Override path used by SSH shell commands

docs/content/ftp.md

@@ -217,7 +217,7 @@ Use Implicit FTPS (FTP over TLS).
 When using implicit FTP over TLS the client connects using TLS
 right from the start which breaks compatibility with
 non-TLS-aware servers. This is usually served over port 990 rather
-than port 21. Cannot be used in combination with explicit FTP.
+than port 21. Cannot be used in combination with explicit FTPS.
 
 Properties:
 
@@ -232,7 +232,7 @@ Use Explicit FTPS (FTP over TLS).
 
 When using explicit FTP over TLS the client explicitly requests
 security from the server in order to upgrade a plain text connection
-to an encrypted one. Cannot be used in combination with implicit FTP.
+to an encrypted one. Cannot be used in combination with implicit FTPS.
 
 Properties:
 

docs/content/mailru.md

@@ -191,6 +191,11 @@ Properties:
 
 Password.
 
+This must be an app password - rclone will not work with your normal
+password. See the Configuration section in the docs for how to make an
+app password.
+
+
 **NB** Input to this must be obscured - see [rclone obscure](/commands/rclone_obscure/).
 
 Properties:

docs/content/rc.md

@@ -616,6 +616,14 @@ See the [config providers](/commands/rclone_config_providers/) command for more
 
 **Authentication is required for this call.**
 
+### config/setpath: Set the path of the config file {#config-setpath}
+
+Parameters:
+
+- path - path to the config file to use
+
+**Authentication is required for this call.**
+
 ### config/update: update the config for a remote. {#config-update}
 
 This takes the following parameters:
@@ -909,6 +917,22 @@ Parameters:
 
 - rate - int
 
+### debug/set-gc-percent: Call runtime/debug.SetGCPercent for setting the garbage collection target percentage. {#debug-set-gc-percent}
+
+SetGCPercent sets the garbage collection target percentage: a collection is triggered
+when the ratio of freshly allocated data to live data remaining after the previous collection
+reaches this percentage. SetGCPercent returns the previous setting. The initial setting is the
+value of the GOGC environment variable at startup, or 100 if the variable is not set.
+
+This setting may be effectively reduced in order to maintain a memory limit.
+A negative percentage effectively disables garbage collection, unless the memory limit is reached.
+
+See https://pkg.go.dev/runtime/debug#SetMemoryLimit for more details.
+
+Parameters:
+
+- gc-percent - int
+
 ### debug/set-mutex-profile-fraction: Set runtime.SetMutexProfileFraction for mutex profiling. {#debug-set-mutex-profile-fraction}
 
 SetMutexProfileFraction controls the fraction of mutex contention
@@ -930,6 +954,38 @@ Results:
 
 - previousRate - int
 
+### debug/set-soft-memory-limit: Call runtime/debug.SetMemoryLimit for setting a soft memory limit for the runtime. {#debug-set-soft-memory-limit}
+
+SetMemoryLimit provides the runtime with a soft memory limit.
+
+The runtime undertakes several processes to try to respect this memory limit, including
+adjustments to the frequency of garbage collections and returning memory to the underlying
+system more aggressively. This limit will be respected even if GOGC=off (or, if SetGCPercent(-1) is executed).
+
+The input limit is provided as bytes, and includes all memory mapped, managed, and not
+released by the Go runtime. Notably, it does not account for space used by the Go binary
+and memory external to Go, such as memory managed by the underlying system on behalf of
+the process, or memory managed by non-Go code inside the same process.
+Examples of excluded memory sources include: OS kernel memory held on behalf of the process,
+memory allocated by C code, and memory mapped by syscall.Mmap (because it is not managed by the Go runtime).
+
+A zero limit or a limit that's lower than the amount of memory used by the Go runtime may cause
+the garbage collector to run nearly continuously. However, the application may still make progress.
+
+The memory limit is always respected by the Go runtime, so to effectively disable this behavior,
+set the limit very high. math.MaxInt64 is the canonical value for disabling the limit, but values
+much greater than the available memory on the underlying system work just as well.
+
+See https://go.dev/doc/gc-guide for a detailed guide explaining the soft memory limit in more detail,
+as well as a variety of common use-cases and scenarios.
+
+SetMemoryLimit returns the previously set memory limit. A negative input does not adjust the limit,
+and allows for retrieval of the currently set memory limit.
+
+Parameters:
+
+- mem-limit - int
+
 ### fscache/clear: Clear the Fs cache. {#fscache-clear}
 
 This clears the fs cache. This is where remotes created from backends

docs/content/s3.md

@@ -643,7 +643,7 @@ A simple solution is to set the `--s3-upload-cutoff 0` and force all the files t
 {{< rem autogenerated options start" - DO NOT EDIT - instead edit fs.RegInfo in backend/s3/s3.go then run make backenddocs" >}}
 ### Standard options
 
-Here are the Standard options specific to s3 (Amazon S3 Compliant Storage Providers including AWS, Alibaba, Ceph, China Mobile, Cloudflare, ArvanCloud, DigitalOcean, Dreamhost, Huawei OBS, IBM COS, IDrive e2, IONOS Cloud, Lyve Cloud, Minio, Netease, RackCorp, Scaleway, SeaweedFS, StackPath, Storj, Tencent COS, Qiniu and Wasabi).
+Here are the Standard options specific to s3 (Amazon S3 Compliant Storage Providers including AWS, Alibaba, Ceph, China Mobile, Cloudflare, ArvanCloud, DigitalOcean, Dreamhost, Huawei OBS, IBM COS, IDrive e2, IONOS Cloud, Liara, Lyve Cloud, Minio, Netease, RackCorp, Scaleway, SeaweedFS, StackPath, Storj, Tencent COS, Qiniu and Wasabi).
 
 #### --s3-provider
 
@@ -682,6 +682,8 @@ Properties:
         - IONOS Cloud
     - "LyveCloud"
         - Seagate Lyve Cloud
+    - "Liara"
+        - Liara Object Storage
     - "Minio"
         - Minio Object Storage
     - "Netease"
@@ -1033,7 +1035,7 @@ Properties:
 
 - Config:      region
 - Env Var:     RCLONE_S3_REGION
-- Provider:    !AWS,Alibaba,ChinaMobile,Cloudflare,IONOS,ArvanCloud,Qiniu,RackCorp,Scaleway,Storj,TencentCOS,HuaweiOBS,IDrive
+- Provider:    !AWS,Alibaba,ChinaMobile,Cloudflare,IONOS,ArvanCloud,Liara,Qiniu,RackCorp,Scaleway,Storj,TencentCOS,HuaweiOBS,IDrive
 - Type:        string
 - Required:    false
 - Examples:
@@ -1312,6 +1314,22 @@ Properties:
 
 #### --s3-endpoint
 
+Endpoint for Liara Object Storage API.
+
+Properties:
+
+- Config:      endpoint
+- Env Var:     RCLONE_S3_ENDPOINT
+- Provider:    Liara
+- Type:        string
+- Required:    false
+- Examples:
+    - "storage.iran.liara.space"
+        - The default endpoint
+        - Iran
+
+#### --s3-endpoint
+
 Endpoint for OSS API.
 
 Properties:
@@ -1612,7 +1630,7 @@ Properties:
 
 - Config:      endpoint
 - Env Var:     RCLONE_S3_ENDPOINT
-- Provider:    !AWS,IBMCOS,IDrive,IONOS,TencentCOS,HuaweiOBS,Alibaba,ChinaMobile,ArvanCloud,Scaleway,StackPath,Storj,RackCorp,Qiniu
+- Provider:    !AWS,IBMCOS,IDrive,IONOS,TencentCOS,HuaweiOBS,Alibaba,ChinaMobile,Liara,ArvanCloud,Scaleway,StackPath,Storj,RackCorp,Qiniu
 - Type:        string
 - Required:    false
 - Examples:
@@ -1639,15 +1657,33 @@ Properties:
     - "s3.ap-southeast-1.lyvecloud.seagate.com"
         - Seagate Lyve Cloud AP Southeast 1 (Singapore)
     - "s3.wasabisys.com"
-        - Wasabi US East endpoint
+        - Wasabi US East 1 (N. Virginia)
+    - "s3.us-east-2.wasabisys.com"
+        - Wasabi US East 2 (N. Virginia)
+    - "s3.us-central-1.wasabisys.com"
+        - Wasabi US Central 1 (Texas)
     - "s3.us-west-1.wasabisys.com"
-        - Wasabi US West endpoint
+        - Wasabi US West 1 (Oregon)
+    - "s3.ca-central-1.wasabisys.com"
+        - Wasabi CA Central 1 (Toronto)
     - "s3.eu-central-1.wasabisys.com"
-        - Wasabi EU Central endpoint
+        - Wasabi EU Central 1 (Amsterdam)
+    - "s3.eu-central-2.wasabisys.com"
+        - Wasabi EU Central 2 (Frankfurt)
+    - "s3.eu-west-1.wasabisys.com"
+        - Wasabi EU West 1 (London)
+    - "s3.eu-west-2.wasabisys.com"
+        - Wasabi EU West 2 (Paris)
     - "s3.ap-northeast-1.wasabisys.com"
         - Wasabi AP Northeast 1 (Tokyo) endpoint
     - "s3.ap-northeast-2.wasabisys.com"
         - Wasabi AP Northeast 2 (Osaka) endpoint
+    - "s3.ap-southeast-1.wasabisys.com"
+        - Wasabi AP Southeast 1 (Singapore)
+    - "s3.ap-southeast-2.wasabisys.com"
+        - Wasabi AP Southeast 2 (Sydney)
+    - "storage.iran.liara.space"
+        - Liara Iran endpoint
     - "s3.ir-thr-at1.arvanstorage.com"
         - ArvanCloud Tehran Iran (Asiatech) endpoint
 
@@ -1980,7 +2016,7 @@ Properties:
 
 - Config:      location_constraint
 - Env Var:     RCLONE_S3_LOCATION_CONSTRAINT
-- Provider:    !AWS,Alibaba,HuaweiOBS,ChinaMobile,Cloudflare,IBMCOS,IDrive,IONOS,ArvanCloud,Qiniu,RackCorp,Scaleway,StackPath,Storj,TencentCOS
+- Provider:    !AWS,Alibaba,HuaweiOBS,ChinaMobile,Cloudflare,IBMCOS,IDrive,IONOS,Liara,ArvanCloud,Qiniu,RackCorp,Scaleway,StackPath,Storj,TencentCOS
 - Type:        string
 - Required:    false
 
@@ -1995,6 +2031,10 @@ For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview
 Note that this ACL is applied when server-side copying objects as S3
 doesn't copy the ACL from the source but rather writes a fresh one.
 
+If the acl is an empty string then no X-Amz-Acl: header is added and
+the default (private) will be used.
+
+
 Properties:
 
 - Config:      acl
@@ -2155,6 +2195,21 @@ Properties:
 
 #### --s3-storage-class
 
+The storage class to use when storing new objects in Liara
+
+Properties:
+
+- Config:      storage_class
+- Env Var:     RCLONE_S3_STORAGE_CLASS
+- Provider:    Liara
+- Type:        string
+- Required:    false
+- Examples:
+    - "STANDARD"
+        - Standard storage class
+
+#### --s3-storage-class
+
 The storage class to use when storing new objects in ArvanCloud.
 
 Properties:
@@ -2233,7 +2288,7 @@ Properties:
 
 ### Advanced options
 
-Here are the Advanced options specific to s3 (Amazon S3 Compliant Storage Providers including AWS, Alibaba, Ceph, China Mobile, Cloudflare, ArvanCloud, Digital Ocean, Dreamhost, Huawei OBS, IBM COS, IDrive e2, IONOS Cloud, Lyve Cloud, Minio, Netease, RackCorp, Scaleway, SeaweedFS, StackPath, Storj, Tencent COS, Qiniu and Wasabi).
+Here are the Advanced options specific to s3 (Amazon S3 Compliant Storage Providers including AWS, Alibaba, Ceph, China Mobile, Cloudflare, ArvanCloud, DigitalOcean, Dreamhost, Huawei OBS, IBM COS, IDrive e2, IONOS Cloud, Liara, Lyve Cloud, Minio, Netease, RackCorp, Scaleway, SeaweedFS, StackPath, Storj, Tencent COS, Qiniu and Wasabi).
 
 #### --s3-bucket-acl
 
@@ -2244,6 +2299,10 @@ For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview
 Note that this ACL is applied when only when creating buckets.  If it
 isn't set then "acl" is used instead.
 
+If the "acl" and "bucket_acl" are empty strings then no X-Amz-Acl:
+header is added and the default (private) will be used.
+
+
 Properties:
 
 - Config:      bucket_acl
@@ -2866,6 +2925,37 @@ Properties:
 - Type:        bool
 - Default:     false
 
+#### --s3-might-gzip
+
+Set this if the backend might gzip objects.
+
+Normally providers will not alter objects when they are downloaded. If
+an object was not uploaded with `Content-Encoding: gzip` then it won't
+be set on download.
+
+However some providers may gzip objects even if they weren't uploaded
+with `Content-Encoding: gzip` (eg Cloudflare).
+
+A symptom of this would be receiving errors like
+
+    ERROR corrupted on transfer: sizes differ NNN vs MMM
+
+If you set this flag and rclone downloads an object with
+Content-Encoding: gzip set and chunked transfer encoding, then rclone
+will decompress the object on the fly.
+
+If this is set to unset (the default) then rclone will choose
+according to the provider setting what to apply, but you can override
+rclone's choice here.
+
+
+Properties:
+
+- Config:      might_gzip
+- Env Var:     RCLONE_S3_MIGHT_GZIP
+- Type:        Tristate
+- Default:     unset
+
 #### --s3-no-system-metadata
 
 Suppress setting and reading of system metadata

docs/content/sftp.md

@@ -528,6 +528,9 @@ This enables the use of the following insecure ciphers and key exchange methods:
 
 Those algorithms are insecure and may allow plaintext data to be recovered by an attacker.
 
+This must be false if you use either ciphers or key_exchange advanced options.
+
+
 Properties:
 
 - Config:      use_insecure_cipher
@@ -860,6 +863,64 @@ Properties:
 - Type:        SpaceSepList
 - Default:     
 
+#### --sftp-ciphers
+
+Space separated list of ciphers to be used for session encryption, ordered by preference.
+
+At least one must match with server configuration. This can be checked for example using ssh -Q cipher.
+
+This must not be set if use_insecure_cipher is true.
+
+Example:
+
+    aes128-ctr aes192-ctr aes256-ctr aes128-gcm@openssh.com aes256-gcm@openssh.com
+
+
+Properties:
+
+- Config:      ciphers
+- Env Var:     RCLONE_SFTP_CIPHERS
+- Type:        SpaceSepList
+- Default:     
+
+#### --sftp-key-exchange
+
+Space separated list of key exchange algorithms, ordered by preference.
+
+At least one must match with server configuration. This can be checked for example using ssh -Q kex.
+
+This must not be set if use_insecure_cipher is true.
+
+Example:
+
+    sntrup761x25519-sha512@openssh.com curve25519-sha256 curve25519-sha256@libssh.org ecdh-sha2-nistp256
+
+
+Properties:
+
+- Config:      key_exchange
+- Env Var:     RCLONE_SFTP_KEY_EXCHANGE
+- Type:        SpaceSepList
+- Default:     
+
+#### --sftp-macs
+
+Space separated list of MACs (message authentication code) algorithms, ordered by preference.
+
+At least one must match with server configuration. This can be checked for example using ssh -Q mac.
+
+Example:
+
+    umac-64-etm@openssh.com umac-128-etm@openssh.com hmac-sha2-256-etm@openssh.com
+
+
+Properties:
+
+- Config:      macs
+- Env Var:     RCLONE_SFTP_MACS
+- Type:        SpaceSepList
+- Default:     
+
 {{< rem autogenerated options stop >}}
 
 ## Limitations

go.mod

@@ -14,6 +14,7 @@ require (
 	github.com/aalpar/deheap v0.0.0-20210914013432-0cc84d79dec3
 	github.com/abbot/go-http-auth v0.4.0
 	github.com/anacrolix/dms v1.5.0
+	github.com/anacrolix/log v0.13.1
 	github.com/artyom/mtab v1.0.0
 	github.com/atotto/clipboard v0.1.4
 	github.com/aws/aws-sdk-go v1.44.145
@@ -48,6 +49,7 @@ require (
 	github.com/putdotio/go-putio/putio v0.0.0-20200123120452-16d982cac2b8
 	github.com/rclone/ftp v0.0.0-20221014110213-e44dedbc76c6
 	github.com/rfjakob/eme v1.1.2
+	github.com/rivo/uniseg v0.2.0
 	github.com/shirou/gopsutil/v3 v3.22.10
 	github.com/sirupsen/logrus v1.9.0
 	github.com/skratchdot/open-golang v0.0.0-20200116055534-eef842397966
@@ -78,7 +80,6 @@ require (
 	cloud.google.com/go/compute/metadata v0.2.1 // indirect
 	github.com/Azure/azure-sdk-for-go/sdk/internal v1.0.1 // indirect
 	github.com/AzureAD/microsoft-authentication-library-for-go v0.7.0 // indirect
-	github.com/anacrolix/log v0.13.1 // indirect
 	github.com/beorn7/perks v1.0.1 // indirect
 	github.com/calebcase/tmpfile v1.0.3 // indirect
 	github.com/cespare/xxhash/v2 v2.1.2 // indirect
@@ -116,7 +117,6 @@ require (
 	github.com/prometheus/client_model v0.3.0 // indirect
 	github.com/prometheus/common v0.37.0 // indirect
 	github.com/prometheus/procfs v0.8.0 // indirect
-	github.com/rivo/uniseg v0.2.0 // indirect
 	github.com/russross/blackfriday/v2 v2.1.0 // indirect
 	github.com/sony/gobreaker v0.5.0 // indirect
 	github.com/spacemonkeygo/monkit/v3 v3.0.17 // indirect

go.sum

@@ -1033,7 +1033,6 @@ golang.org/x/net v0.0.0-20220909164309-bea034e7d591/go.mod h1:YDH+HFinaLZZlnHAfS
 golang.org/x/net v0.0.0-20221012135044-0b7e1fb9d458/go.mod h1:YDH+HFinaLZZlnHAfSS6ZXJJ9M9t4Dl22yv3iI2vPwk=
 golang.org/x/net v0.0.0-20221014081412-f15817d10f9b/go.mod h1:YDH+HFinaLZZlnHAfSS6ZXJJ9M9t4Dl22yv3iI2vPwk=
 golang.org/x/net v0.1.0/go.mod h1:Cx3nUiGt4eDBEyega/BKRp+/AlGL8hYe7U9odMt2Cco=
-golang.org/x/net v0.2.0 h1:sZfSu1wtKLGlWI4ZZayP0ck9Y73K1ynO6gqzTdBVdPU=
 golang.org/x/net v0.2.0/go.mod h1:KqCZLdyyvdV855qA2rE3GC2aiw5xGR5TEjj8smXukLY=
 golang.org/x/net v0.4.0 h1:Q5QPcMlvfxFTAPV0+07Xz/MpK9NTXu2VDUuy0FeMfaU=
 golang.org/x/net v0.4.0/go.mod h1:MBQ8lrhLObU/6UmLb4fmbmk5OcyYmqtbGd/9yIeKjEE=
@@ -1175,7 +1174,6 @@ golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBc
 golang.org/x/sys v0.0.0-20220728004956-3c1f35247d10/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.1.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.2.0 h1:ljd4t30dBnAvMZaQCevtY0xLLD0A+bRZXbgLMLU1F/A=
 golang.org/x/sys v0.2.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.3.0 h1:w8ZOecv6NaNa/zC8944JTU3vz4u6Lagfk4RPQxv92NQ=
 golang.org/x/sys v0.3.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
@@ -1183,7 +1181,6 @@ golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9sn
 golang.org/x/term v0.0.0-20201210144234-2321bbc49cbf/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
 golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
 golang.org/x/term v0.1.0/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
-golang.org/x/term v0.2.0 h1:z85xZCsEl7bi/KwbNADeBYoOP0++7W1ipu+aGnpwzRM=
 golang.org/x/term v0.2.0/go.mod h1:TVmDHMZPmdnySmBfhjOoOdhjzdE1h4u1VwSiw2l1Nuc=
 golang.org/x/term v0.3.0 h1:qoo4akIqOcDME5bhc/NgxUdovd6BSS2uMsVjB56q1xI=
 golang.org/x/term v0.3.0/go.mod h1:q750SLmJuPmVoN1blW3UFBPREJfb1KmY3vwxfr+nFDA=
@@ -1197,7 +1194,6 @@ golang.org/x/text v0.3.5/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
 golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
 golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ=
 golang.org/x/text v0.3.8/go.mod h1:E6s5w1FMmriuDzIBO73fBruAKo1PCIq6d2Q6DHfQ8WQ=
-golang.org/x/text v0.4.0 h1:BrVqGRd7+k1DiOgtnFvAkoQEWQvBc25ouMJM6429SFg=
 golang.org/x/text v0.4.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=
 golang.org/x/text v0.5.0 h1:OLmvp0KP+FVG99Ct/qFiL/Fhk4zp4QQnZ7b2U+5piUM=
 golang.org/x/text v0.5.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=