Version v1.63.1

This commit is contained in:
Nick Craig-Wood 2023-07-17 14:28:15 +01:00
parent 7aa097c8ad
commit bd1fbcae12
6 changed files with 537 additions and 233 deletions

426
MANUAL.html generated

File diff suppressed because it is too large Load Diff

104
MANUAL.md generated
View File

@ -1,6 +1,6 @@
% rclone(1) User Manual
% Nick Craig-Wood
% Jun 30, 2023
% Jul 17, 2023
# Rclone syncs your files to cloud storage
@ -18,7 +18,7 @@
Rclone is a command-line program to manage files on cloud storage. It
is a feature-rich alternative to cloud vendors' web storage
interfaces. [Over 40 cloud storage products](#providers) support
interfaces. [Over 70 cloud storage products](#providers) support
rclone including S3 object stores, business & consumer file storage
services, as well as standard transfer protocols.
@ -2723,6 +2723,40 @@ See the [global flags page](https://rclone.org/flags/) for global options not li
* [rclone config](https://rclone.org/commands/rclone_config/) - Enter an interactive configuration session.
# rclone config redacted
Print redacted (decrypted) config file, or the redacted config for a single remote.
# Synopsis
This prints a redacted copy of the config file, either the
whole config file or for a given remote.
The config file will be redacted by replacing all passwords and other
sensitive info with XXX.
This makes the config file suitable for posting online for support.
It should be double checked before posting as the redaction may not be perfect.
```
rclone config redacted [<remote>] [flags]
```
# Options
```
-h, --help help for redacted
```
See the [global flags page](https://rclone.org/flags/) for global options not listed here.
# SEE ALSO
* [rclone config](https://rclone.org/commands/rclone_config/) - Enter an interactive configuration session.
# rclone config show
Print (decrypted) config file, or the config for a single remote.
@ -11852,7 +11886,7 @@ all files on `remote:` excluding those in root directory `dir` and sub
directories.
E.g. on Microsoft Windows `rclone ls remote: --exclude "*\[{JP,KR,HK}\]*"`
lists the files in `remote:` with `[JP]` or `[KR]` or `[HK]` in
lists the files in `remote:` without `[JP]` or `[KR]` or `[HK]` in
their name. Quotes prevent the shell from interpreting the `\`
characters.`\` characters escape the `[` and `]` so an rclone filter
treats them literally rather than as a character-range. The `{` and `}`
@ -15194,7 +15228,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.63.0")
--user-agent string Set the user-agent to a specified string (default "rclone/v1.63.1")
-v, --verbose count Print lots more stuff (repeat for more)
```
@ -27890,7 +27924,7 @@ to be the same account as the Dropbox you want to access)
6. Switch to the `Permissions` tab. Enable at least the following permissions: `account_info.read`, `files.metadata.write`, `files.content.write`, `files.content.read`, `sharing.write`. The `files.metadata.read` and `sharing.read` checkboxes will be marked too. Click `Submit`
7. Switch to the `Settings` tab. Fill `OAuth2 - Redirect URIs` as `http://localhost:53682/`
7. Switch to the `Settings` tab. Fill `OAuth2 - Redirect URIs` as `http://localhost:53682/` and click on `Add`
8. Find the `App key` and `App secret` values on the `Settings` tab. Use these values in rclone config to add a new remote or edit an existing remote. The `App key` setting corresponds to `client_id` in rclone config, the `App secret` corresponds to `client_secret`
@ -30874,7 +30908,7 @@ be the same account as the Google Drive you want to access)
"Google Drive API".
4. Click "Credentials" in the left-side panel (not "Create
credentials", which opens the wizard), then "Create credentials"
credentials", which opens the wizard).
5. If you already configured an "Oauth Consent Screen", then skip
to the next step; if not, click on "CONFIGURE CONSENT SCREEN" button
@ -33696,8 +33730,6 @@ y/e/d> y
[Mail.ru Cloud](https://cloud.mail.ru/) is a cloud storage provided by a Russian internet company [Mail.Ru Group](https://mail.ru). The official desktop client is [Disk-O:](https://disk-o.cloud/en), available on Windows and Mac OS.
Currently it is recommended to disable 2FA on Mail.ru accounts intended for rclone until it gets eventually implemented.
## Features highlights
- Paths may be as deep as required, e.g. `remote:directory/subdirectory`
@ -43570,6 +43602,27 @@ Options:
# Changelog
## v1.63.1 - 2023-07-17
[See commits](https://github.com/rclone/rclone/compare/v1.63.0...v1.63.1)
* Bug Fixes
* build: Fix macos builds for versions < 12 (Anagh Kumar Baranwal)
* dirtree: Fix performance with large directories of directories and `--fast-list` (Nick Craig-Wood)
* operations
* Fix deadlock when using `lsd`/`ls` with `--progress` (Nick Craig-Wood)
* Fix `.rclonelink` files not being converted back to symlinks (Nick Craig-Wood)
* doc fixes (Dean Attali, Mahad, Nick Craig-Wood, Sawada Tsunayoshi, Vladislav Vorobev)
* Local
* Fix partial directory read for corrupted filesystem (Nick Craig-Wood)
* Box
* Fix reconnect failing with HTTP 400 Bad Request (albertony)
* Smb
* Fix "Statfs failed: bucket or container name is needed" when mounting (Nick Craig-Wood)
* WebDAV
* Nextcloud: fix must use /dav/files/USER endpoint not /webdav error (Paul)
* Nextcloud chunking: add more guidance for the user to check the config (darix)
## v1.63.0 - 2023-06-30
[See commits](https://github.com/rclone/rclone/compare/v1.62.0...v1.63.0)
@ -49233,32 +49286,43 @@ put them back in again.` >}}
* zzq <i@zhangzqs.cn>
* mac-15 <usman.ilamdin@phpstudios.com>
# Contact the rclone project #
# Contact the rclone project
## Forum ##
## Forum
Forum for questions and general discussion:
* https://forum.rclone.org
- https://forum.rclone.org
## GitHub repository ##
## Business support
For business support or sponsorship enquiries please see:
- https://rclone.com/
- sponsorship@rclone.com
## GitHub repository
The project's repository is located at:
* https://github.com/rclone/rclone
- https://github.com/rclone/rclone
There you can file bug reports or contribute with pull requests.
## Twitter ##
## Twitter
You can also follow me on twitter for rclone announcements:
You can also follow Nick on twitter for rclone announcements:
* [@njcw](https://twitter.com/njcw)
- [@njcw](https://twitter.com/njcw)
## Email ##
## Email
Or if all else fails or you want to ask something private or
confidential email [Nick Craig-Wood](mailto:nick@craig-wood.com).
Please don't email me requests for help - those are better directed to
the forum. Thanks!
confidential
- info@rclone.com
Please don't email requests for help to this address - those are
better directed to the forum unless you'd like to sign up for business
support.

91
MANUAL.txt generated
View File

@ -1,6 +1,6 @@
rclone(1) User Manual
Nick Craig-Wood
Jun 30, 2023
Jul 17, 2023
Rclone syncs your files to cloud storage
@ -16,7 +16,7 @@ About rclone
Rclone is a command-line program to manage files on cloud storage. It is
a feature-rich alternative to cloud vendors' web storage interfaces.
Over 40 cloud storage products support rclone including S3 object
Over 70 cloud storage products support rclone including S3 object
stores, business & consumer file storage services, as well as standard
transfer protocols.
@ -2481,6 +2481,36 @@ SEE ALSO
- rclone config - Enter an interactive configuration session.
rclone config redacted
Print redacted (decrypted) config file, or the redacted config for a
single remote.
Synopsis
This prints a redacted copy of the config file, either the whole config
file or for a given remote.
The config file will be redacted by replacing all passwords and other
sensitive info with XXX.
This makes the config file suitable for posting online for support.
It should be double checked before posting as the redaction may not be
perfect.
rclone config redacted [<remote>] [flags]
Options
-h, --help help for redacted
See the global flags page for global options not listed here.
SEE ALSO
- rclone config - Enter an interactive configuration session.
rclone config show
Print (decrypted) config file, or the config for a single remote.
@ -11395,7 +11425,7 @@ all files on remote: excluding those in root directory dir and sub
directories.
E.g. on Microsoft Windows rclone ls remote: --exclude "*\[{JP,KR,HK}\]*"
lists the files in remote: with [JP] or [KR] or [HK] in their name.
lists the files in remote: without [JP] or [KR] or [HK] in their name.
Quotes prevent the shell from interpreting the \ characters.\ characters
escape the [ and ] so an rclone filter treats them literally rather than
as a character-range. The { and } define an rclone pattern list. For
@ -14738,7 +14768,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.63.0")
--user-agent string Set the user-agent to a specified string (default "rclone/v1.63.1")
-v, --verbose count Print lots more stuff (repeat for more)
Backend Flags
@ -27240,7 +27270,7 @@ Here is how to create your own Dropbox App ID for rclone:
Click Submit
7. Switch to the Settings tab. Fill OAuth2 - Redirect URIs as
http://localhost:53682/
http://localhost:53682/ and click on Add
8. Find the App key and App secret values on the Settings tab. Use
these values in rclone config to add a new remote or edit an
@ -30238,7 +30268,7 @@ Here is how to create your own Google Drive client ID for rclone:
"Google Drive API".
4. Click "Credentials" in the left-side panel (not "Create
credentials", which opens the wizard), then "Create credentials"
credentials", which opens the wizard).
5. If you already configured an "Oauth Consent Screen", then skip to
the next step; if not, click on "CONFIGURE CONSENT SCREEN" button
@ -33101,9 +33131,6 @@ Mail.ru Cloud is a cloud storage provided by a Russian internet company
Mail.Ru Group. The official desktop client is Disk-O:, available on
Windows and Mac OS.
Currently it is recommended to disable 2FA on Mail.ru accounts intended
for rclone until it gets eventually implemented.
Features highlights
- Paths may be as deep as required, e.g. remote:directory/subdirectory
@ -43068,6 +43095,35 @@ Options:
Changelog
v1.63.1 - 2023-07-17
See commits
- Bug Fixes
- build: Fix macos builds for versions < 12 (Anagh Kumar Baranwal)
- dirtree: Fix performance with large directories of directories
and --fast-list (Nick Craig-Wood)
- operations
- Fix deadlock when using lsd/ls with --progress (Nick
Craig-Wood)
- Fix .rclonelink files not being converted back to symlinks
(Nick Craig-Wood)
- doc fixes (Dean Attali, Mahad, Nick Craig-Wood, Sawada
Tsunayoshi, Vladislav Vorobev)
- Local
- Fix partial directory read for corrupted filesystem (Nick
Craig-Wood)
- Box
- Fix reconnect failing with HTTP 400 Bad Request (albertony)
- Smb
- Fix "Statfs failed: bucket or container name is needed" when
mounting (Nick Craig-Wood)
- WebDAV
- Nextcloud: fix must use /dav/files/USER endpoint not /webdav
error (Paul)
- Nextcloud chunking: add more guidance for the user to check the
config (darix)
v1.63.0 - 2023-06-30
See commits
@ -50160,6 +50216,13 @@ Forum for questions and general discussion:
- https://forum.rclone.org
Business support
For business support or sponsorship enquiries please see:
- https://rclone.com/
- sponsorship@rclone.com
GitHub repository
The project's repository is located at:
@ -50170,12 +50233,16 @@ There you can file bug reports or contribute with pull requests.
Twitter
You can also follow me on twitter for rclone announcements:
You can also follow Nick on twitter for rclone announcements:
- [@njcw](https://twitter.com/njcw)
Email
Or if all else fails or you want to ask something private or
confidential email Nick Craig-Wood. Please don't email me requests for
help - those are better directed to the forum. Thanks!
confidential
- info@rclone.com
Please don't email requests for help to this address - those are better
directed to the forum unless you'd like to sign up for business support.

View File

@ -5,6 +5,27 @@ description: "Rclone Changelog"
# Changelog
## v1.63.1 - 2023-07-17
[See commits](https://github.com/rclone/rclone/compare/v1.63.0...v1.63.1)
* Bug Fixes
* build: Fix macos builds for versions < 12 (Anagh Kumar Baranwal)
* dirtree: Fix performance with large directories of directories and `--fast-list` (Nick Craig-Wood)
* operations
* Fix deadlock when using `lsd`/`ls` with `--progress` (Nick Craig-Wood)
* Fix `.rclonelink` files not being converted back to symlinks (Nick Craig-Wood)
* doc fixes (Dean Attali, Mahad, Nick Craig-Wood, Sawada Tsunayoshi, Vladislav Vorobev)
* Local
* Fix partial directory read for corrupted filesystem (Nick Craig-Wood)
* Box
* Fix reconnect failing with HTTP 400 Bad Request (albertony)
* Smb
* Fix "Statfs failed: bucket or container name is needed" when mounting (Nick Craig-Wood)
* WebDAV
* Nextcloud: fix must use /dav/files/USER endpoint not /webdav error (Paul)
* Nextcloud chunking: add more guidance for the user to check the config (darix)
## v1.63.0 - 2023-06-30
[See commits](https://github.com/rclone/rclone/compare/v1.62.0...v1.63.0)

View File

@ -174,7 +174,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.63.0")
--user-agent string Set the user-agent to a specified string (default "rclone/v1.63.1")
-v, --verbose count Print lots more stuff (repeat for more)
```

126
rclone.1 generated
View File

@ -1,7 +1,7 @@
.\"t
.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "rclone" "1" "Jun 30, 2023" "User Manual" ""
.TH "rclone" "1" "Jul 17, 2023" "User Manual" ""
.hy
.SH Rclone syncs your files to cloud storage
.PP
@ -24,7 +24,7 @@ Donate. (https://rclone.org/donate/)
Rclone is a command-line program to manage files on cloud storage.
It is a feature-rich alternative to cloud vendors\[aq] web storage
interfaces.
Over 40 cloud storage products support rclone including S3 object
Over 70 cloud storage products support rclone including S3 object
stores, business & consumer file storage services, as well as standard
transfer protocols.
.PP
@ -3456,6 +3456,42 @@ not listed here.
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config/) - Enter an
interactive configuration session.
.SH rclone config redacted
.PP
Print redacted (decrypted) config file, or the redacted config for a
single remote.
.SH Synopsis
.PP
This prints a redacted copy of the config file, either the whole config
file or for a given remote.
.PP
The config file will be redacted by replacing all passwords and other
sensitive info with XXX.
.PP
This makes the config file suitable for posting online for support.
.PP
It should be double checked before posting as the redaction may not be
perfect.
.IP
.nf
\f[C]
rclone config redacted [<remote>] [flags]
\f[R]
.fi
.SH Options
.IP
.nf
\f[C]
-h, --help help for redacted
\f[R]
.fi
.PP
See the global flags page (https://rclone.org/flags/) for global options
not listed here.
.SH SEE ALSO
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config/) - Enter an
interactive configuration session.
.SH rclone config show
.PP
Print (decrypted) config file, or the config for a single remote.
@ -14827,7 +14863,7 @@ directory \f[C]dir\f[R] and sub directories.
E.g.
on Microsoft Windows
\f[C]rclone ls remote: --exclude \[dq]*\[rs][{JP,KR,HK}\[rs]]*\[dq]\f[R]
lists the files in \f[C]remote:\f[R] with \f[C][JP]\f[R] or
lists the files in \f[C]remote:\f[R] without \f[C][JP]\f[R] or
\f[C][KR]\f[R] or \f[C][HK]\f[R] in their name.
Quotes prevent the shell from interpreting the \f[C]\[rs]\f[R]
characters.\f[C]\[rs]\f[R] characters escape the \f[C][\f[R] and
@ -20812,7 +20848,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 \[dq]rclone/v1.63.0\[dq])
--user-agent string Set the user-agent to a specified string (default \[dq]rclone/v1.63.1\[dq])
-v, --verbose count Print lots more stuff (repeat for more)
\f[R]
.fi
@ -38345,7 +38381,7 @@ Click \f[C]Submit\f[R]
.IP "7." 3
Switch to the \f[C]Settings\f[R] tab.
Fill \f[C]OAuth2 - Redirect URIs\f[R] as
\f[C]http://localhost:53682/\f[R]
\f[C]http://localhost:53682/\f[R] and click on \f[C]Add\f[R]
.IP "8." 3
Find the \f[C]App key\f[R] and \f[C]App secret\f[R] values on the
\f[C]Settings\f[R] tab.
@ -42452,8 +42488,7 @@ Under \[dq]ENABLE APIS AND SERVICES\[dq] search for \[dq]Drive\[dq], and
enable the \[dq]Google Drive API\[dq].
.IP " 4." 4
Click \[dq]Credentials\[dq] in the left-side panel (not \[dq]Create
credentials\[dq], which opens the wizard), then \[dq]Create
credentials\[dq]
credentials\[dq], which opens the wizard).
.IP " 5." 4
If you already configured an \[dq]Oauth Consent Screen\[dq], then skip
to the next step; if not, click on \[dq]CONFIGURE CONSENT SCREEN\[dq]
@ -46075,9 +46110,6 @@ Mail.ru Cloud (https://cloud.mail.ru/) is a cloud storage provided by a
Russian internet company Mail.Ru Group (https://mail.ru).
The official desktop client is Disk-O: (https://disk-o.cloud/en),
available on Windows and Mac OS.
.PP
Currently it is recommended to disable 2FA on Mail.ru accounts intended
for rclone until it gets eventually implemented.
.SS Features highlights
.IP \[bu] 2
Paths may be as deep as required, e.g.
@ -59481,6 +59513,60 @@ Options:
.IP \[bu] 2
\[dq]error\[dq]: return an error based on option value
.SH Changelog
.SS v1.63.1 - 2023-07-17
.PP
See commits (https://github.com/rclone/rclone/compare/v1.63.0...v1.63.1)
.IP \[bu] 2
Bug Fixes
.RS 2
.IP \[bu] 2
build: Fix macos builds for versions < 12 (Anagh Kumar Baranwal)
.IP \[bu] 2
dirtree: Fix performance with large directories of directories and
\f[C]--fast-list\f[R] (Nick Craig-Wood)
.IP \[bu] 2
operations
.RS 2
.IP \[bu] 2
Fix deadlock when using \f[C]lsd\f[R]/\f[C]ls\f[R] with
\f[C]--progress\f[R] (Nick Craig-Wood)
.IP \[bu] 2
Fix \f[C].rclonelink\f[R] files not being converted back to symlinks
(Nick Craig-Wood)
.RE
.IP \[bu] 2
doc fixes (Dean Attali, Mahad, Nick Craig-Wood, Sawada Tsunayoshi,
Vladislav Vorobev)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
Fix partial directory read for corrupted filesystem (Nick Craig-Wood)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
Fix reconnect failing with HTTP 400 Bad Request (albertony)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
Fix \[dq]Statfs failed: bucket or container name is needed\[dq] when
mounting (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
Nextcloud: fix must use /dav/files/USER endpoint not /webdav error
(Paul)
.IP \[bu] 2
Nextcloud chunking: add more guidance for the user to check the config
(darix)
.RE
.SS v1.63.0 - 2023-06-30
.PP
See commits (https://github.com/rclone/rclone/compare/v1.62.0...v1.63.0)
@ -73417,6 +73503,13 @@ mac-15 <usman.ilamdin@phpstudios.com>
Forum for questions and general discussion:
.IP \[bu] 2
https://forum.rclone.org
.SS Business support
.PP
For business support or sponsorship enquiries please see:
.IP \[bu] 2
https://rclone.com/
.IP \[bu] 2
sponsorship\[at]rclone.com
.SS GitHub repository
.PP
The project\[aq]s repository is located at:
@ -73426,15 +73519,18 @@ https://github.com/rclone/rclone
There you can file bug reports or contribute with pull requests.
.SS Twitter
.PP
You can also follow me on twitter for rclone announcements:
You can also follow Nick on twitter for rclone announcements:
.IP \[bu] 2
[\[at]njcw](https://twitter.com/njcw)
.SS Email
.PP
Or if all else fails or you want to ask something private or
confidential email Nick Craig-Wood (mailto:nick@craig-wood.com).
Please don\[aq]t email me requests for help - those are better directed
to the forum.
Thanks!
confidential
.IP \[bu] 2
info\[at]rclone.com
.PP
Please don\[aq]t email requests for help to this address - those are
better directed to the forum unless you\[aq]d like to sign up for
business support.
.SH AUTHORS
Nick Craig-Wood.