jgaunt/rclone
1
0
Fork 0
mirror of https://github.com/rclone/rclone.git synced 2025-12-11 05:43:15 +00:00
Code Issues Projects Releases Wiki Activity

Version v1.56.1

Browse Source
This commit is contained in:
Nick Craig-Wood
2021-09-19 12:15:09 +01:00
parent b9cf451177
commit 86f13fa46b
6 changed files with 345 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files

76
MANUAL.html generated
View File

@@ -17,7 +17,7 @@
<header id="title-block-header"> <header id="title-block-header">
<h1 class="title">rclone(1) User Manual</h1> <h1 class="title">rclone(1) User Manual</h1>
<p class="author">Nick Craig-Wood</p> <p class="author">Nick Craig-Wood</p>
<p class="date">Jul 20, 2021</p> <p class="date">Sep 19, 2021</p>
</header> </header>
<h1 id="rclone-syncs-your-files-to-cloud-storage">Rclone syncs your files to cloud storage</h1> <h1 id="rclone-syncs-your-files-to-cloud-storage">Rclone syncs your files to cloud storage</h1>
<p><img width="50%" src="https://rclone.org/img/logo_on_light__horizontal_color.svg" alt="rclone logo" style="float:right; padding: 5px;" ></p> <p><img width="50%" src="https://rclone.org/img/logo_on_light__horizontal_color.svg" alt="rclone logo" style="float:right; padding: 5px;" ></p>
@@ -7243,7 +7243,7 @@ Showing nodes accounting for 1537.03kB, 100% of 1537.03kB total
--use-json-log Use json log format. --use-json-log Use json log format.
--use-mmap Use mmap allocator (see docs). --use-mmap Use mmap allocator (see docs).
--use-server-modtime Use server modified time instead of object metadata --use-server-modtime Use server modified time instead of object metadata
--user-agent string Set the user-agent to a specified string. The default is rclone/ version (default &quot;rclone/v1.56.0&quot;) --user-agent string Set the user-agent to a specified string. The default is rclone/ version (default &quot;rclone/v1.56.1&quot;)
-v, --verbose count Print lots more stuff (repeat for more)</code></pre> -v, --verbose count Print lots more stuff (repeat for more)</code></pre>
<h2 id="backend-flags">Backend Flags</h2> <h2 id="backend-flags">Backend Flags</h2>
<p>These flags are available for every command. They control the backends and may be set in the config file.</p> <p>These flags are available for every command. They control the backends and may be set in the config file.</p>
@@ -8500,7 +8500,7 @@ e) Edit this remote
d) Delete this remote d) Delete this remote
y/e/d&gt; </code></pre> y/e/d&gt; </code></pre>
<h3 id="modified-time">Modified time</h3> <h3 id="modified-time">Modified time</h3>
<p>The modified time is stored as metadata on the object as <code>X-Amz-Meta-Mtime</code> as floating point since the epoch accurate to 1 ns.</p> <p>The modified time is stored as metadata on the object as <code>X-Amz-Meta-Mtime</code> as floating point since the epoch, accurate to 1 ns.</p>
<p>If the modification time needs to be updated rclone will attempt to perform a server side copy to update the modification if the object can be copied in a single part. In the case the object is larger than 5Gb or is in Glacier or Glacier Deep Archive storage the object will be uploaded rather than copied.</p> <p>If the modification time needs to be updated rclone will attempt to perform a server side copy to update the modification if the object can be copied in a single part. In the case the object is larger than 5Gb or is in Glacier or Glacier Deep Archive storage the object will be uploaded rather than copied.</p>
<p>Note that reading this from the object takes an additional <code>HEAD</code> request as the metadata isn't returned in object listings.</p> <p>Note that reading this from the object takes an additional <code>HEAD</code> request as the metadata isn't returned in object listings.</p>
<h3 id="reducing-costs">Reducing costs</h3> <h3 id="reducing-costs">Reducing costs</h3>
@@ -9520,6 +9520,10 @@ y/e/d&gt; </code></pre>
<ul> <ul>
<li>Wasabi EU Central endpoint</li> <li>Wasabi EU Central endpoint</li>
</ul></li> </ul></li>
<li>"s3.ap-northeast-1.wasabisys.com"
<ul>
<li>Wasabi AP Northeast endpoint</li>
</ul></li>
</ul></li> </ul></li>
</ul> </ul>
<h4 id="s3-location-constraint">--s3-location-constraint</h4> <h4 id="s3-location-constraint">--s3-location-constraint</h4>
@@ -14409,7 +14413,7 @@ client_secret&gt; # Can be left blank
scope&gt; # Select your scope, 1 for example scope&gt; # Select your scope, 1 for example
root_folder_id&gt; # Can be left blank root_folder_id&gt; # Can be left blank
service_account_file&gt; /home/foo/myJSONfile.json # This is where the JSON file goes! service_account_file&gt; /home/foo/myJSONfile.json # This is where the JSON file goes!
y/n&gt; # Auto config, y y/n&gt; # Auto config, n
</code></pre> </code></pre>
<h5 id="verify-that-its-working">4. Verify that it's working</h5> <h5 id="verify-that-its-working">4. Verify that it's working</h5>
<ul> <ul>
@@ -14422,7 +14426,7 @@ y/n&gt; # Auto config, y
<li><code>gdrive:backup</code> - use the remote called gdrive, work in the folder named backup.</li> <li><code>gdrive:backup</code> - use the remote called gdrive, work in the folder named backup.</li>
</ul></li> </ul></li>
</ul> </ul>
<p>Note: in case you configured a specific root folder on gdrive and rclone is unable to access the contents of that folder when using <code>--drive-impersonate</code>, do this instead: - in the gdrive web interface, share your root folder with the user/email of the new Service Account you created/selected at step #1 - use rclone without specifying the <code>--drive-impersonate</code> option, like this: <code>rclone -v foo@example.com lsf gdrive:backup</code></p> <p>Note: in case you configured a specific root folder on gdrive and rclone is unable to access the contents of that folder when using <code>--drive-impersonate</code>, do this instead: - in the gdrive web interface, share your root folder with the user/email of the new Service Account you created/selected at step #1 - use rclone without specifying the <code>--drive-impersonate</code> option, like this: <code>rclone -v lsf gdrive:backup</code></p>
<h3 id="shared-drives-team-drives">Shared drives (team drives)</h3> <h3 id="shared-drives-team-drives">Shared drives (team drives)</h3>
<p>If you want to configure the remote to point to a Google Shared Drive (previously known as Team Drives) then answer <code>y</code> to the question <code>Configure this as a Shared Drive (Team Drive)?</code>.</p> <p>If you want to configure the remote to point to a Google Shared Drive (previously known as Team Drives) then answer <code>y</code> to the question <code>Configure this as a Shared Drive (Team Drive)?</code>.</p>
<p>This will fetch the list of Shared Drives from google and allow you to configure which one you want to use. You can also type in a Shared Drive ID if you prefer.</p> <p>This will fetch the list of Shared Drives from google and allow you to configure which one you want to use. You can also type in a Shared Drive ID if you prefer.</p>
@@ -17187,7 +17191,7 @@ y/e/d&gt; y</code></pre>
<ol type="1"> <ol type="1">
<li>Open https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade and then click <code>New registration</code>.</li> <li>Open https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade and then click <code>New registration</code>.</li>
<li>Enter a name for your app, choose account type <code>Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)</code>, select <code>Web</code> in <code>Redirect URI</code>, then type (do not copy and paste) <code>http://localhost:53682/</code> and click Register. Copy and keep the <code>Application (client) ID</code> under the app name for later use.</li> <li>Enter a name for your app, choose account type <code>Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)</code>, select <code>Web</code> in <code>Redirect URI</code>, then type (do not copy and paste) <code>http://localhost:53682/</code> and click Register. Copy and keep the <code>Application (client) ID</code> under the app name for later use.</li>
<li>Under <code>manage</code> select <code>Certificates &amp; secrets</code>, click <code>New client secret</code>. Copy and keep that secret for later use.</li> <li>Under <code>manage</code> select <code>Certificates &amp; secrets</code>, click <code>New client secret</code>. Enter a description (can be anything) and set <code>Expires</code> to 24 months. Copy and keep that secret <em>Value</em> for later use (you <em>won't</em> be able to see this value afterwards).</li>
<li>Under <code>manage</code> select <code>API permissions</code>, click <code>Add a permission</code> and select <code>Microsoft Graph</code> then select <code>delegated permissions</code>.</li> <li>Under <code>manage</code> select <code>API permissions</code>, click <code>Add a permission</code> and select <code>Microsoft Graph</code> then select <code>delegated permissions</code>.</li>
<li>Search and select the following permissions: <code>Files.Read</code>, <code>Files.ReadWrite</code>, <code>Files.Read.All</code>, <code>Files.ReadWrite.All</code>, <code>offline_access</code>, <code>User.Read</code>. Once selected click <code>Add permissions</code> at the bottom.</li> <li>Search and select the following permissions: <code>Files.Read</code>, <code>Files.ReadWrite</code>, <code>Files.Read.All</code>, <code>Files.ReadWrite.All</code>, <code>offline_access</code>, <code>User.Read</code>. Once selected click <code>Add permissions</code> at the bottom.</li>
</ol> </ol>
@@ -17557,6 +17561,8 @@ Description: Using application &#39;rclone&#39; is currently not supported for y
Code: AADSTS50076 Code: AADSTS50076
Description: Due to a configuration change made by your administrator, or because you moved to a new location, you must use multi-factor authentication to access &#39;...&#39;.</code></pre> Description: Due to a configuration change made by your administrator, or because you moved to a new location, you must use multi-factor authentication to access &#39;...&#39;.</code></pre>
<p>If you see the error above after enabling multi-factor authentication for your account, you can fix it by refreshing your OAuth refresh token. To do that, run <code>rclone config</code>, and choose to edit your OneDrive backend. Then, you don't need to actually make any changes until you reach this question: <code>Already have a token - refresh?</code>. For this question, answer <code>y</code> and go through the process to refresh your token, just like the first time the backend is configured. After this, rclone should work again for this backend.</p> <p>If you see the error above after enabling multi-factor authentication for your account, you can fix it by refreshing your OAuth refresh token. To do that, run <code>rclone config</code>, and choose to edit your OneDrive backend. Then, you don't need to actually make any changes until you reach this question: <code>Already have a token - refresh?</code>. For this question, answer <code>y</code> and go through the process to refresh your token, just like the first time the backend is configured. After this, rclone should work again for this backend.</p>
<h4 id="invalid-request-when-making-public-links">Invalid request when making public links</h4>
<p>On Sharepoint and OneDrive for Business, <code>rclone link</code> may return an "Invalid request" error. A possible cause is that the organisation admin didn't allow public links to be made for the organisation/sharepoint library. To fix the permissions as an admin, take a look at the docs: <a href="https://docs.microsoft.com/en-us/sharepoint/turn-external-sharing-on-or-off">1</a>, <a href="https://support.microsoft.com/en-us/office/set-up-and-manage-access-requests-94b26e0b-2822-49d4-929a-8455698654b3">2</a>.</p>
<h1 id="opendrive">OpenDrive</h1> <h1 id="opendrive">OpenDrive</h1>
<p>Paths are specified as <code>remote:path</code></p> <p>Paths are specified as <code>remote:path</code></p>
<p>Paths may be as deep as required, e.g. <code>remote:directory/subdirectory</code>.</p> <p>Paths may be as deep as required, e.g. <code>remote:directory/subdirectory</code>.</p>
@@ -21308,6 +21314,64 @@ $ tree /tmp/b
<li>"error": return an error based on option value</li> <li>"error": return an error based on option value</li>
</ul> </ul>
<h1 id="changelog">Changelog</h1> <h1 id="changelog">Changelog</h1>
<h2 id="v1.56.1---2021-09-19">v1.56.1 - 2021-09-19</h2>
<p><a href="https://github.com/rclone/rclone/compare/v1.56.0...v1.56.1">See commits</a></p>
<ul>
<li>Bug Fixes
<ul>
<li>accounting: Fix maximum bwlimit by scaling scale max token bucket size (Nick Craig-Wood)</li>
<li>rc: Fix speed does not update in core/stats (negative0)</li>
<li>selfupdate: Fix --quiet option, not quite quiet (yedamo)</li>
<li>serve http: Fix <code>serve http</code> exiting directly after starting (Cnly)</li>
<li>build
<ul>
<li>Apply gofmt from golang 1.17 (Ivan Andreev)</li>
<li>Update Go to 1.16 and NDK to 22b for android/any (x0b)</li>
</ul></li>
</ul></li>
<li>Mount
<ul>
<li>Fix <code>--daemon</code> mode (Ivan Andreev)</li>
</ul></li>
<li>VFS
<ul>
<li>Fix duplicates on rename (Nick Craig-Wood)</li>
<li>Fix crash when truncating a just uploaded object (Nick Craig-Wood)</li>
<li>Fix issue where empty dirs would build up in cache meta dir (albertony)</li>
</ul></li>
<li>Drive
<ul>
<li>Fix instructions for auto config (Greg Sadetsky)</li>
<li>Fix lsf example without drive-impersonate (Greg Sadetsky)</li>
</ul></li>
<li>Onedrive
<ul>
<li>Handle HTTP 400 better in PublicLink (Alex Chen)</li>
<li>Clarification of the process for creating custom client_id (Mariano Absatz)</li>
</ul></li>
<li>Pcloud
<ul>
<li>Return an early error when Put is called with an unknown size (Nick Craig-Wood)</li>
<li>Try harder to delete a failed upload (Nick Craig-Wood)</li>
</ul></li>
<li>S3
<ul>
<li>Add Wasabi's AP-Northeast endpoint info (hota)</li>
<li>Fix typo in s3 documentation (Greg Sadetsky)</li>
</ul></li>
<li>Seafile
<ul>
<li>Fix 2fa config state machine (Fred)</li>
</ul></li>
<li>SFTP
<ul>
<li>Remove spurious error message on <code>--sftp-disable-concurrent-reads</code> (Nick Craig-Wood)</li>
</ul></li>
<li>Sugarsync
<ul>
<li>Fix initial connection after config re-arrangement (Nick Craig-Wood)</li>
</ul></li>
</ul>
<h2 id="v1.56.0---2021-07-20">v1.56.0 - 2021-07-20</h2> <h2 id="v1.56.0---2021-07-20">v1.56.0 - 2021-07-20</h2>
<p><a href="https://github.com/rclone/rclone/compare/v1.55.0...v1.56.0">See commits</a></p> <p><a href="https://github.com/rclone/rclone/compare/v1.55.0...v1.56.0">See commits</a></p>
<ul> <ul>

60
MANUAL.md generated
View File

@@ -1,6 +1,6 @@
% rclone(1) User Manual % rclone(1) User Manual
% Nick Craig-Wood % Nick Craig-Wood
% Jul 20, 2021 % Sep 19, 2021
# Rclone syncs your files to cloud storage # Rclone syncs your files to cloud storage
@@ -12650,7 +12650,7 @@ These flags are available for every command.
--use-json-log Use json log format. --use-json-log Use json log format.
--use-mmap Use mmap allocator (see docs). --use-mmap Use mmap allocator (see docs).
--use-server-modtime Use server modified time instead of object metadata --use-server-modtime Use server modified time instead of object metadata
--user-agent string Set the user-agent to a specified string. The default is rclone/ version (default "rclone/v1.56.0") --user-agent string Set the user-agent to a specified string. The default is rclone/ version (default "rclone/v1.56.1")
-v, --verbose count Print lots more stuff (repeat for more) -v, --verbose count Print lots more stuff (repeat for more)
``` ```
@@ -14452,7 +14452,7 @@ y/e/d>
### Modified time ### ### Modified time ###
The modified time is stored as metadata on the object as The modified time is stored as metadata on the object as
`X-Amz-Meta-Mtime` as floating point since the epoch accurate to 1 ns. `X-Amz-Meta-Mtime` as floating point since the epoch, accurate to 1 ns.
If the modification time needs to be updated rclone will attempt to perform a server If the modification time needs to be updated rclone will attempt to perform a server
side copy to update the modification if the object can be copied in a single part. side copy to update the modification if the object can be copied in a single part.
@@ -15249,6 +15249,8 @@ Required when using an S3 clone.
- Wasabi US West endpoint - Wasabi US West endpoint
- "s3.eu-central-1.wasabisys.com" - "s3.eu-central-1.wasabisys.com"
- Wasabi EU Central endpoint - Wasabi EU Central endpoint
- "s3.ap-northeast-1.wasabisys.com"
- Wasabi AP Northeast endpoint
#### --s3-location-constraint #### --s3-location-constraint
@@ -21789,7 +21791,7 @@ client_secret> # Can be left blank
scope> # Select your scope, 1 for example scope> # Select your scope, 1 for example
root_folder_id> # Can be left blank root_folder_id> # Can be left blank
service_account_file> /home/foo/myJSONfile.json # This is where the JSON file goes! service_account_file> /home/foo/myJSONfile.json # This is where the JSON file goes!
y/n> # Auto config, y y/n> # Auto config, n
``` ```
@@ -21806,7 +21808,7 @@ the folder named backup.
Note: in case you configured a specific root folder on gdrive and rclone is unable to access the contents of that folder when using `--drive-impersonate`, do this instead: Note: in case you configured a specific root folder on gdrive and rclone is unable to access the contents of that folder when using `--drive-impersonate`, do this instead:
- in the gdrive web interface, share your root folder with the user/email of the new Service Account you created/selected at step #1 - in the gdrive web interface, share your root folder with the user/email of the new Service Account you created/selected at step #1
- use rclone without specifying the `--drive-impersonate` option, like this: - use rclone without specifying the `--drive-impersonate` option, like this:
`rclone -v foo@example.com lsf gdrive:backup` `rclone -v lsf gdrive:backup`
### Shared drives (team drives) ### ### Shared drives (team drives) ###
@@ -25525,7 +25527,7 @@ Client ID and Key by following the steps below:
1. Open https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade and then click `New registration`. 1. Open https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade and then click `New registration`.
2. Enter a name for your app, choose account type `Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)`, select `Web` in `Redirect URI`, then type (do not copy and paste) `http://localhost:53682/` and click Register. Copy and keep the `Application (client) ID` under the app name for later use. 2. Enter a name for your app, choose account type `Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)`, select `Web` in `Redirect URI`, then type (do not copy and paste) `http://localhost:53682/` and click Register. Copy and keep the `Application (client) ID` under the app name for later use.
3. Under `manage` select `Certificates & secrets`, click `New client secret`. Copy and keep that secret for later use. 3. Under `manage` select `Certificates & secrets`, click `New client secret`. Enter a description (can be anything) and set `Expires` to 24 months. Copy and keep that secret _Value_ for later use (you _won't_ be able to see this value afterwards).
4. Under `manage` select `API permissions`, click `Add a permission` and select `Microsoft Graph` then select `delegated permissions`. 4. Under `manage` select `API permissions`, click `Add a permission` and select `Microsoft Graph` then select `delegated permissions`.
5. Search and select the following permissions: `Files.Read`, `Files.ReadWrite`, `Files.Read.All`, `Files.ReadWrite.All`, `offline_access`, `User.Read`. Once selected click `Add permissions` at the bottom. 5. Search and select the following permissions: `Files.Read`, `Files.ReadWrite`, `Files.Read.All`, `Files.ReadWrite.All`, `offline_access`, `User.Read`. Once selected click `Add permissions` at the bottom.
@@ -25980,6 +25982,15 @@ Description: Due to a configuration change made by your administrator, or becaus
If you see the error above after enabling multi-factor authentication for your account, you can fix it by refreshing your OAuth refresh token. To do that, run `rclone config`, and choose to edit your OneDrive backend. Then, you don't need to actually make any changes until you reach this question: `Already have a token - refresh?`. For this question, answer `y` and go through the process to refresh your token, just like the first time the backend is configured. After this, rclone should work again for this backend. If you see the error above after enabling multi-factor authentication for your account, you can fix it by refreshing your OAuth refresh token. To do that, run `rclone config`, and choose to edit your OneDrive backend. Then, you don't need to actually make any changes until you reach this question: `Already have a token - refresh?`. For this question, answer `y` and go through the process to refresh your token, just like the first time the backend is configured. After this, rclone should work again for this backend.
#### Invalid request when making public links ####
On Sharepoint and OneDrive for Business, `rclone link` may return an "Invalid
request" error. A possible cause is that the organisation admin didn't allow
public links to be made for the organisation/sharepoint library. To fix the
permissions as an admin, take a look at the docs:
[1](https://docs.microsoft.com/en-us/sharepoint/turn-external-sharing-on-or-off),
[2](https://support.microsoft.com/en-us/office/set-up-and-manage-access-requests-94b26e0b-2822-49d4-929a-8455698654b3).
# OpenDrive # OpenDrive
Paths are specified as `remote:path` Paths are specified as `remote:path`
@@ -30700,6 +30711,43 @@ Options:
# Changelog # Changelog
## v1.56.1 - 2021-09-19
[See commits](https://github.com/rclone/rclone/compare/v1.56.0...v1.56.1)
* Bug Fixes
* accounting: Fix maximum bwlimit by scaling scale max token bucket size (Nick Craig-Wood)
* rc: Fix speed does not update in core/stats (negative0)
* selfupdate: Fix --quiet option, not quite quiet (yedamo)
* serve http: Fix `serve http` exiting directly after starting (Cnly)
* build
* Apply gofmt from golang 1.17 (Ivan Andreev)
* Update Go to 1.16 and NDK to 22b for android/any (x0b)
* Mount
* Fix `--daemon` mode (Ivan Andreev)
* VFS
* Fix duplicates on rename (Nick Craig-Wood)
* Fix crash when truncating a just uploaded object (Nick Craig-Wood)
* Fix issue where empty dirs would build up in cache meta dir (albertony)
* Drive
* Fix instructions for auto config (Greg Sadetsky)
* Fix lsf example without drive-impersonate (Greg Sadetsky)
* Onedrive
* Handle HTTP 400 better in PublicLink (Alex Chen)
* Clarification of the process for creating custom client_id (Mariano Absatz)
* Pcloud
* Return an early error when Put is called with an unknown size (Nick Craig-Wood)
* Try harder to delete a failed upload (Nick Craig-Wood)
* S3
* Add Wasabi's AP-Northeast endpoint info (hota)
* Fix typo in s3 documentation (Greg Sadetsky)
* Seafile
* Fix 2fa config state machine (Fred)
* SFTP
* Remove spurious error message on `--sftp-disable-concurrent-reads` (Nick Craig-Wood)
* Sugarsync
* Fix initial connection after config re-arrangement (Nick Craig-Wood)
## v1.56.0 - 2021-07-20 ## v1.56.0 - 2021-07-20
[See commits](https://github.com/rclone/rclone/compare/v1.55.0...v1.56.0) [See commits](https://github.com/rclone/rclone/compare/v1.55.0...v1.56.0)

71
MANUAL.txt generated
View File

@@ -1,6 +1,6 @@
rclone(1) User Manual rclone(1) User Manual
Nick Craig-Wood Nick Craig-Wood
Jul 20, 2021 Sep 19, 2021
@@ -12805,7 +12805,7 @@ These flags are available for every command.
--use-json-log Use json log format. --use-json-log Use json log format.
--use-mmap Use mmap allocator (see docs). --use-mmap Use mmap allocator (see docs).
--use-server-modtime Use server modified time instead of object metadata --use-server-modtime Use server modified time instead of object metadata
--user-agent string Set the user-agent to a specified string. The default is rclone/ version (default "rclone/v1.56.0") --user-agent string Set the user-agent to a specified string. The default is rclone/ version (default "rclone/v1.56.1")
-v, --verbose count Print lots more stuff (repeat for more) -v, --verbose count Print lots more stuff (repeat for more)
@@ -14561,7 +14561,7 @@ This will guide you through an interactive setup process.
Modified time Modified time
The modified time is stored as metadata on the object as The modified time is stored as metadata on the object as
X-Amz-Meta-Mtime as floating point since the epoch accurate to 1 ns. X-Amz-Meta-Mtime as floating point since the epoch, accurate to 1 ns.
If the modification time needs to be updated rclone will attempt to If the modification time needs to be updated rclone will attempt to
perform a server side copy to update the modification if the object can perform a server side copy to update the modification if the object can
@@ -15362,6 +15362,8 @@ Endpoint for S3 API. Required when using an S3 clone.
- Wasabi US West endpoint - Wasabi US West endpoint
- "s3.eu-central-1.wasabisys.com" - "s3.eu-central-1.wasabisys.com"
- Wasabi EU Central endpoint - Wasabi EU Central endpoint
- "s3.ap-northeast-1.wasabisys.com"
- Wasabi AP Northeast endpoint
--s3-location-constraint --s3-location-constraint
@@ -21842,7 +21844,7 @@ There's a few steps we need to go through to accomplish this:
scope> # Select your scope, 1 for example scope> # Select your scope, 1 for example
root_folder_id> # Can be left blank root_folder_id> # Can be left blank
service_account_file> /home/foo/myJSONfile.json # This is where the JSON file goes! service_account_file> /home/foo/myJSONfile.json # This is where the JSON file goes!
y/n> # Auto config, y y/n> # Auto config, n
4. Verify that it's working 4. Verify that it's working
@@ -21860,8 +21862,7 @@ is unable to access the contents of that folder when using
--drive-impersonate, do this instead: - in the gdrive web interface, --drive-impersonate, do this instead: - in the gdrive web interface,
share your root folder with the user/email of the new Service Account share your root folder with the user/email of the new Service Account
you created/selected at step #1 - use rclone without specifying the you created/selected at step #1 - use rclone without specifying the
--drive-impersonate option, like this: --drive-impersonate option, like this: rclone -v lsf gdrive:backup
rclone -v foo@example.com lsf gdrive:backup
Shared drives (team drives) Shared drives (team drives)
@@ -25623,7 +25624,9 @@ you can get your own Client ID and Key by following the steps below:
http://localhost:53682/ and click Register. Copy and keep the http://localhost:53682/ and click Register. Copy and keep the
Application (client) ID under the app name for later use. Application (client) ID under the app name for later use.
3. Under manage select Certificates & secrets, click New client secret. 3. Under manage select Certificates & secrets, click New client secret.
Copy and keep that secret for later use. Enter a description (can be anything) and set Expires to 24 months.
Copy and keep that secret _Value_ for later use (you _won't_ be able
to see this value afterwards).
4. Under manage select API permissions, click Add a permission and 4. Under manage select API permissions, click Add a permission and
select Microsoft Graph then select delegated permissions. select Microsoft Graph then select delegated permissions.
5. Search and select the following permissions: Files.Read, 5. Search and select the following permissions: Files.Read,
@@ -26099,6 +26102,14 @@ and go through the process to refresh your token, just like the first
time the backend is configured. After this, rclone should work again for time the backend is configured. After this, rclone should work again for
this backend. this backend.
Invalid request when making public links
On Sharepoint and OneDrive for Business, rclone link may return an
"Invalid request" error. A possible cause is that the organisation admin
didn't allow public links to be made for the organisation/sharepoint
library. To fix the permissions as an admin, take a look at the docs: 1,
2.
OPENDRIVE OPENDRIVE
@@ -30844,6 +30855,52 @@ Options:
CHANGELOG CHANGELOG
v1.56.1 - 2021-09-19
See commits
- Bug Fixes
- accounting: Fix maximum bwlimit by scaling scale max token
bucket size (Nick Craig-Wood)
- rc: Fix speed does not update in core/stats (negative0)
- selfupdate: Fix --quiet option, not quite quiet (yedamo)
- serve http: Fix serve http exiting directly after starting
(Cnly)
- build
- Apply gofmt from golang 1.17 (Ivan Andreev)
- Update Go to 1.16 and NDK to 22b for android/any (x0b)
- Mount
- Fix --daemon mode (Ivan Andreev)
- VFS
- Fix duplicates on rename (Nick Craig-Wood)
- Fix crash when truncating a just uploaded object (Nick
Craig-Wood)
- Fix issue where empty dirs would build up in cache meta dir
(albertony)
- Drive
- Fix instructions for auto config (Greg Sadetsky)
- Fix lsf example without drive-impersonate (Greg Sadetsky)
- Onedrive
- Handle HTTP 400 better in PublicLink (Alex Chen)
- Clarification of the process for creating custom client_id
(Mariano Absatz)
- Pcloud
- Return an early error when Put is called with an unknown size
(Nick Craig-Wood)
- Try harder to delete a failed upload (Nick Craig-Wood)
- S3
- Add Wasabi's AP-Northeast endpoint info (hota)
- Fix typo in s3 documentation (Greg Sadetsky)
- Seafile
- Fix 2fa config state machine (Fred)
- SFTP
- Remove spurious error message on --sftp-disable-concurrent-reads
(Nick Craig-Wood)
- Sugarsync
- Fix initial connection after config re-arrangement (Nick
Craig-Wood)
v1.56.0 - 2021-07-20 v1.56.0 - 2021-07-20
See commits See commits

37
docs/content/changelog.md
View File

@@ -5,6 +5,43 @@ description: "Rclone Changelog"
# Changelog # Changelog
## v1.56.1 - 2021-09-19
[See commits](https://github.com/rclone/rclone/compare/v1.56.0...v1.56.1)
* Bug Fixes
* accounting: Fix maximum bwlimit by scaling scale max token bucket size (Nick Craig-Wood)
* rc: Fix speed does not update in core/stats (negative0)
* selfupdate: Fix --quiet option, not quite quiet (yedamo)
* serve http: Fix `serve http` exiting directly after starting (Cnly)
* build
* Apply gofmt from golang 1.17 (Ivan Andreev)
* Update Go to 1.16 and NDK to 22b for android/any (x0b)
* Mount
* Fix `--daemon` mode (Ivan Andreev)
* VFS
* Fix duplicates on rename (Nick Craig-Wood)
* Fix crash when truncating a just uploaded object (Nick Craig-Wood)
* Fix issue where empty dirs would build up in cache meta dir (albertony)
* Drive
* Fix instructions for auto config (Greg Sadetsky)
* Fix lsf example without drive-impersonate (Greg Sadetsky)
* Onedrive
* Handle HTTP 400 better in PublicLink (Alex Chen)
* Clarification of the process for creating custom client_id (Mariano Absatz)
* Pcloud
* Return an early error when Put is called with an unknown size (Nick Craig-Wood)
* Try harder to delete a failed upload (Nick Craig-Wood)
* S3
* Add Wasabi's AP-Northeast endpoint info (hota)
* Fix typo in s3 documentation (Greg Sadetsky)
* Seafile
* Fix 2fa config state machine (Fred)
* SFTP
* Remove spurious error message on `--sftp-disable-concurrent-reads` (Nick Craig-Wood)
* Sugarsync
* Fix initial connection after config re-arrangement (Nick Craig-Wood)
## v1.56.0 - 2021-07-20 ## v1.56.0 - 2021-07-20
[See commits](https://github.com/rclone/rclone/compare/v1.55.0...v1.56.0) [See commits](https://github.com/rclone/rclone/compare/v1.55.0...v1.56.0)

2
docs/content/flags.md
View File

@@ -154,7 +154,7 @@ These flags are available for every command.
--use-json-log Use json log format. --use-json-log Use json log format.
--use-mmap Use mmap allocator (see docs). --use-mmap Use mmap allocator (see docs).
--use-server-modtime Use server modified time instead of object metadata --use-server-modtime Use server modified time instead of object metadata
--user-agent string Set the user-agent to a specified string. The default is rclone/ version (default "rclone/v1.56.0") --user-agent string Set the user-agent to a specified string. The default is rclone/ version (default "rclone/v1.56.1")
-v, --verbose count Print lots more stuff (repeat for more) -v, --verbose count Print lots more stuff (repeat for more)
``` ```

126
rclone.1 generated
View File

@@ -1,7 +1,7 @@
.\"t .\"t
.\" Automatically generated by Pandoc 2.5 .\" Automatically generated by Pandoc 2.5
.\" .\"
.TH "rclone" "1" "Jul 20, 2021" "User Manual" "" .TH "rclone" "1" "Sep 19, 2021" "User Manual" ""
.hy .hy
.SH Rclone syncs your files to cloud storage .SH Rclone syncs your files to cloud storage
.PP .PP
@@ -17104,7 +17104,7 @@ These flags are available for every command.
\-\-use\-json\-log Use json log format. \-\-use\-json\-log Use json log format.
\-\-use\-mmap Use mmap allocator (see docs). \-\-use\-mmap Use mmap allocator (see docs).
\-\-use\-server\-modtime Use server modified time instead of object metadata \-\-use\-server\-modtime Use server modified time instead of object metadata
\-\-user\-agent string Set the user\-agent to a specified string. The default is rclone/ version (default \[dq]rclone/v1.56.0\[dq]) \-\-user\-agent string Set the user\-agent to a specified string. The default is rclone/ version (default \[dq]rclone/v1.56.1\[dq])
\-v, \-\-verbose count Print lots more stuff (repeat for more) \-v, \-\-verbose count Print lots more stuff (repeat for more)
\f[R] \f[R]
.fi .fi
@@ -19284,8 +19284,8 @@ y/e/d>
.SS Modified time .SS Modified time
.PP .PP
The modified time is stored as metadata on the object as The modified time is stored as metadata on the object as
\f[C]X\-Amz\-Meta\-Mtime\f[R] as floating point since the epoch accurate \f[C]X\-Amz\-Meta\-Mtime\f[R] as floating point since the epoch,
to 1 ns. accurate to 1 ns.
.PP .PP
If the modification time needs to be updated rclone will attempt to If the modification time needs to be updated rclone will attempt to
perform a server side copy to update the modification if the object can perform a server side copy to update the modification if the object can
@@ -20954,6 +20954,12 @@ Wasabi US West endpoint
.IP \[bu] 2 .IP \[bu] 2
Wasabi EU Central endpoint Wasabi EU Central endpoint
.RE .RE
.IP \[bu] 2
\[dq]s3.ap\-northeast\-1.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
Wasabi AP Northeast endpoint
.RE
.RE .RE
.SS \-\-s3\-location\-constraint .SS \-\-s3\-location\-constraint
.PP .PP
@@ -29567,7 +29573,7 @@ client_secret> # Can be left blank
scope> # Select your scope, 1 for example scope> # Select your scope, 1 for example
root_folder_id> # Can be left blank root_folder_id> # Can be left blank
service_account_file> /home/foo/myJSONfile.json # This is where the JSON file goes! service_account_file> /home/foo/myJSONfile.json # This is where the JSON file goes!
y/n> # Auto config, y y/n> # Auto config, n
\f[R] \f[R]
.fi .fi
.SS 4. Verify that it\[aq]s working .SS 4. Verify that it\[aq]s working
@@ -29594,7 +29600,7 @@ is unable to access the contents of that folder when using
interface, share your root folder with the user/email of the new Service interface, share your root folder with the user/email of the new Service
Account you created/selected at step #1 \- use rclone without specifying Account you created/selected at step #1 \- use rclone without specifying
the \f[C]\-\-drive\-impersonate\f[R] option, like this: the \f[C]\-\-drive\-impersonate\f[R] option, like this:
\f[C]rclone \-v foo\[at]example.com lsf gdrive:backup\f[R] \f[C]rclone \-v lsf gdrive:backup\f[R]
.SS Shared drives (team drives) .SS Shared drives (team drives)
.PP .PP
If you want to configure the remote to point to a Google Shared Drive If you want to configure the remote to point to a Google Shared Drive
@@ -34601,7 +34607,10 @@ for later use.
.IP "3." 3 .IP "3." 3
Under \f[C]manage\f[R] select \f[C]Certificates & secrets\f[R], click Under \f[C]manage\f[R] select \f[C]Certificates & secrets\f[R], click
\f[C]New client secret\f[R]. \f[C]New client secret\f[R].
Copy and keep that secret for later use. Enter a description (can be anything) and set \f[C]Expires\f[R] to 24
months.
Copy and keep that secret \f[I]Value\f[R] for later use (you
\f[I]won\[aq]t\f[R] be able to see this value afterwards).
.IP "4." 3 .IP "4." 3
Under \f[C]manage\f[R] select \f[C]API permissions\f[R], click Under \f[C]manage\f[R] select \f[C]API permissions\f[R], click
\f[C]Add a permission\f[R] and select \f[C]Microsoft Graph\f[R] then \f[C]Add a permission\f[R] and select \f[C]Microsoft Graph\f[R] then
@@ -35313,6 +35322,15 @@ this question: \f[C]Already have a token \- refresh?\f[R].
For this question, answer \f[C]y\f[R] and go through the process to For this question, answer \f[C]y\f[R] and go through the process to
refresh your token, just like the first time the backend is configured. refresh your token, just like the first time the backend is configured.
After this, rclone should work again for this backend. After this, rclone should work again for this backend.
.SS Invalid request when making public links
.PP
On Sharepoint and OneDrive for Business, \f[C]rclone link\f[R] may
return an \[dq]Invalid request\[dq] error.
A possible cause is that the organisation admin didn\[aq]t allow public
links to be made for the organisation/sharepoint library.
To fix the permissions as an admin, take a look at the docs:
1 (https://docs.microsoft.com/en-us/sharepoint/turn-external-sharing-on-or-off),
2 (https://support.microsoft.com/en-us/office/set-up-and-manage-access-requests-94b26e0b-2822-49d4-929a-8455698654b3).
.SH OpenDrive .SH OpenDrive
.PP .PP
Paths are specified as \f[C]remote:path\f[R] Paths are specified as \f[C]remote:path\f[R]
@@ -41865,6 +41883,100 @@ Options:
.IP \[bu] 2 .IP \[bu] 2
\[dq]error\[dq]: return an error based on option value \[dq]error\[dq]: return an error based on option value
.SH Changelog .SH Changelog
.SS v1.56.1 \- 2021\-09\-19
.PP
See commits (https://github.com/rclone/rclone/compare/v1.56.0...v1.56.1)
.IP \[bu] 2
Bug Fixes
.RS 2
.IP \[bu] 2
accounting: Fix maximum bwlimit by scaling scale max token bucket size
(Nick Craig\-Wood)
.IP \[bu] 2
rc: Fix speed does not update in core/stats (negative0)
.IP \[bu] 2
selfupdate: Fix \-\-quiet option, not quite quiet (yedamo)
.IP \[bu] 2
serve http: Fix \f[C]serve http\f[R] exiting directly after starting
(Cnly)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
Apply gofmt from golang 1.17 (Ivan Andreev)
.IP \[bu] 2
Update Go to 1.16 and NDK to 22b for android/any (x0b)
.RE
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
Fix \f[C]\-\-daemon\f[R] mode (Ivan Andreev)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
Fix duplicates on rename (Nick Craig\-Wood)
.IP \[bu] 2
Fix crash when truncating a just uploaded object (Nick Craig\-Wood)
.IP \[bu] 2
Fix issue where empty dirs would build up in cache meta dir (albertony)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
Fix instructions for auto config (Greg Sadetsky)
.IP \[bu] 2
Fix lsf example without drive\-impersonate (Greg Sadetsky)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
Handle HTTP 400 better in PublicLink (Alex Chen)
.IP \[bu] 2
Clarification of the process for creating custom client_id (Mariano
Absatz)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
Return an early error when Put is called with an unknown size (Nick
Craig\-Wood)
.IP \[bu] 2
Try harder to delete a failed upload (Nick Craig\-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
Add Wasabi\[aq]s AP\-Northeast endpoint info (hota)
.IP \[bu] 2
Fix typo in s3 documentation (Greg Sadetsky)
.RE
.IP \[bu] 2
Seafile
.RS 2
.IP \[bu] 2
Fix 2fa config state machine (Fred)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
Remove spurious error message on
\f[C]\-\-sftp\-disable\-concurrent\-reads\f[R] (Nick Craig\-Wood)
.RE
.IP \[bu] 2
Sugarsync
.RS 2
.IP \[bu] 2
Fix initial connection after config re\-arrangement (Nick Craig\-Wood)
.RE
.SS v1.56.0 \- 2021\-07\-20 .SS v1.56.0 \- 2021\-07\-20
.PP .PP
See commits (https://github.com/rclone/rclone/compare/v1.55.0...v1.56.0) See commits (https://github.com/rclone/rclone/compare/v1.55.0...v1.56.0)