TrueCloudLab/rclone
16
0
Fork 2
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions

Version v1.68.2
Some checks failed
build / other_os (push) Has been skipped
Details
build / linux (push) Has been skipped
Details
build / go1.21 (push) Has been skipped
Details
build / go1.22 (push) Has been skipped
Details
build / linux_386 (push) Has been skipped
Details
build / lint (push) Has been skipped
Details
build / android-all (push) Has been skipped
Details
build / windows (push) Has been cancelled
Details
build / mac_amd64 (push) Has been cancelled
Details
build / mac_arm64 (push) Has been cancelled
Details

Browse source
This commit is contained in:
Nick Craig-Wood 2024-11-15 12:20:50 +00:00
parent c0fc4fe0ca
commit f2d16ab4c5
7 changed files with 281 additions and 31 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

57
MANUAL.html generated
View file

@ -81,7 +81,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">Sep 24, 2024</p> <p class="date">Nov 15, 2024</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>
@ -8323,12 +8323,14 @@ file2.avi</code></pre>
<p>Adds path/file names to an rclone command based on rules in a named file. The file contains a list of remarks and pattern rules. Include rules start with <code>+</code> and exclude rules with <code>-</code>. <code>!</code> clears existing rules. Rules are processed in the order they are defined.</p> <p>Adds path/file names to an rclone command based on rules in a named file. The file contains a list of remarks and pattern rules. Include rules start with <code>+</code> and exclude rules with <code>-</code>. <code>!</code> clears existing rules. Rules are processed in the order they are defined.</p>
<p>This flag can be repeated. See above for the order filter flags are processed in.</p> <p>This flag can be repeated. See above for the order filter flags are processed in.</p>
<p>Arrange the order of filter rules with the most restrictive first and work down.</p> <p>Arrange the order of filter rules with the most restrictive first and work down.</p>
<p>Lines starting with # or ; are ignored, and can be used to write comments. Inline comments are not supported. <em>Use <code>-vv --dump filters</code> to see how they appear in the final regexp.</em></p>
<p>E.g. for <code>filter-file.txt</code>:</p> <p>E.g. for <code>filter-file.txt</code>:</p>
<pre><code># a sample filter rule file <pre><code># a sample filter rule file
- secret*.jpg - secret*.jpg
+ *.jpg + *.jpg
+ *.png + *.png
+ file2.avi + file2.avi
- /dir/tmp/** # WARNING! This text will be treated as part of the path.
- /dir/Trash/** - /dir/Trash/**
+ /dir/** + /dir/**
# exclude everything else # exclude everything else
@ -10418,7 +10420,7 @@ Showing nodes accounting for 1537.03kB, 100% of 1537.03kB total
<tr class="odd"> <tr class="odd">
<td>pCloud</td> <td>pCloud</td>
<td style="text-align: center;">MD5, SHA1 ⁷</td> <td style="text-align: center;">MD5, SHA1 ⁷</td>
<td style="text-align: center;">R</td> <td style="text-align: center;">R/W</td>
<td style="text-align: center;">No</td> <td style="text-align: center;">No</td>
<td style="text-align: center;">No</td> <td style="text-align: center;">No</td>
<td style="text-align: center;">W</td> <td style="text-align: center;">W</td>
@ -11968,7 +11970,7 @@ Showing nodes accounting for 1537.03kB, 100% of 1537.03kB total
--tpslimit float Limit HTTP transactions per second to this --tpslimit float Limit HTTP transactions per second to this
--tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --tpslimit-burst int Max burst of transactions for --tpslimit (default 1)
--use-cookies Enable session cookiejar --use-cookies Enable session cookiejar
--user-agent string Set the user-agent to a specified string (default &quot;rclone/v1.68.1&quot;)</code></pre> --user-agent string Set the user-agent to a specified string (default &quot;rclone/v1.68.2&quot;)</code></pre>
<h2 id="performance">Performance</h2> <h2 id="performance">Performance</h2>
<p>Flags helpful for increasing performance.</p> <p>Flags helpful for increasing performance.</p>
<pre><code> --buffer-size SizeSuffix In memory buffer size when reading files for each --transfer (default 16Mi) <pre><code> --buffer-size SizeSuffix In memory buffer size when reading files for each --transfer (default 16Mi)
@ -17168,7 +17170,7 @@ acl = private
upload_cutoff = 5M upload_cutoff = 5M
chunk_size = 5M chunk_size = 5M
copy_cutoff = 5M</code></pre> copy_cutoff = 5M</code></pre>
<p><a href="https://www.online.net/en/storage/c14-cold-storage">C14 Cold Storage</a> is the low-cost S3 Glacier alternative from Scaleway and it works the same way as on S3 by accepting the "GLACIER" <code>storage_class</code>. So you can configure your remote with the <code>storage_class = GLACIER</code> option to upload directly to C14. Don't forget that in this state you can't read files back after, you will need to restore them to "STANDARD" storage_class first before being able to read them (see "restore" section above)</p> <p><a href="https://www.scaleway.com/en/glacier-cold-storage/">Scaleway Glacier</a> is the low-cost S3 Glacier alternative from Scaleway and it works the same way as on S3 by accepting the "GLACIER" <code>storage_class</code>. So you can configure your remote with the <code>storage_class = GLACIER</code> option to upload directly to Scaleway Glacier. Don't forget that in this state you can't read files back after, you will need to restore them to "STANDARD" storage_class first before being able to read them (see "restore" section above)</p>
<h3 id="lyve">Seagate Lyve Cloud</h3> <h3 id="lyve">Seagate Lyve Cloud</h3>
<p><a href="https://www.seagate.com/gb/en/services/cloud/storage/">Seagate Lyve Cloud</a> is an S3 compatible object storage platform from <a href="https://seagate.com/">Seagate</a> intended for enterprise use.</p> <p><a href="https://www.seagate.com/gb/en/services/cloud/storage/">Seagate Lyve Cloud</a> is an S3 compatible object storage platform from <a href="https://seagate.com/">Seagate</a> intended for enterprise use.</p>
<p>Here is a config run through for a remote called <code>remote</code> - you may choose a different name of course. Note that to create an access key and secret key you will need to create a service account first.</p> <p>Here is a config run through for a remote called <code>remote</code> - you may choose a different name of course. Note that to create an access key and secret key you will need to create a service account first.</p>
@ -24613,7 +24615,7 @@ rclone backend copyid drive: ID1 path1 ID2 path2</code></pre>
<li><p>Click on the "+ CREATE CREDENTIALS" button at the top of the screen, then select "OAuth client ID".</p></li> <li><p>Click on the "+ CREATE CREDENTIALS" button at the top of the screen, then select "OAuth client ID".</p></li>
<li><p>Choose an application type of "Desktop app" and click "Create". (the default name is fine)</p></li> <li><p>Choose an application type of "Desktop app" and click "Create". (the default name is fine)</p></li>
<li><p>It will show you a client ID and client secret. Make a note of these.</p> <li><p>It will show you a client ID and client secret. Make a note of these.</p>
<p>(If you selected "External" at Step 5 continue to Step 9. If you chose "Internal" you don't need to publish and can skip straight to Step 10 but your destination drive must be part of the same Google Workspace.)</p></li> <p>(If you selected "External" at Step 5 continue to Step 10. If you chose "Internal" you don't need to publish and can skip straight to Step 11 but your destination drive must be part of the same Google Workspace.)</p></li>
<li><p>Go to "Oauth consent screen" and then click "PUBLISH APP" button and confirm. You will also want to add yourself as a test user.</p></li> <li><p>Go to "Oauth consent screen" and then click "PUBLISH APP" button and confirm. You will also want to add yourself as a test user.</p></li>
<li><p>Provide the noted client ID and client secret to rclone.</p></li> <li><p>Provide the noted client ID and client secret to rclone.</p></li>
</ol> </ol>
@ -36964,6 +36966,51 @@ $ tree /tmp/c
<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-1">Changelog</h1> <h1 id="changelog-1">Changelog</h1>
<h2 id="v1.68.2---2024-11-15">v1.68.2 - 2024-11-15</h2>
<p><a href="https://github.com/rclone/rclone/compare/v1.68.1...v1.68.2">See commits</a></p>
<ul>
<li>Security fixes
<ul>
<li>local backend: CVE-2024-52522: fix permission and ownership on symlinks with <code>--links</code> and <code>--metadata</code> (Nick Craig-Wood)
<ul>
<li>Only affects users using <code>--metadata</code> and <code>--links</code> and copying files to the local backend</li>
<li>See https://github.com/rclone/rclone/security/advisories/GHSA-hrxh-9w67-g4cv</li>
</ul></li>
<li>build: bump github.com/golang-jwt/jwt/v4 from 4.5.0 to 4.5.1 (dependabot)
<ul>
<li>This is an issue in a dependency which is used for JWT certificates</li>
<li>See https://github.com/golang-jwt/jwt/security/advisories/GHSA-29wx-vh33-7x7r</li>
</ul></li>
</ul></li>
<li>Bug Fixes
<ul>
<li>accounting: Fix wrong message on SIGUSR2 to enable/disable bwlimit (Nick Craig-Wood)</li>
<li>bisync: Fix output capture restoring the wrong output for logrus (Dimitrios Slamaris)</li>
<li>dlna: Fix loggingResponseWriter disregarding log level (Simon Bos)</li>
<li>serve s3: Fix excess locking which was making serve s3 single threaded (Nick Craig-Wood)</li>
<li>doc fixes (Nick Craig-Wood, tgfisher, Alexandre Hamez, Randy Bush)</li>
</ul></li>
<li>Local
<ul>
<li>Fix permission and ownership on symlinks with <code>--links</code> and <code>--metadata</code> (Nick Craig-Wood)</li>
<li>Fix <code>--copy-links</code> on macOS when cloning (nielash)</li>
</ul></li>
<li>Onedrive
<ul>
<li>Fix Retry-After handling to look at 503 errors also (Nick Craig-Wood)</li>
</ul></li>
<li>Pikpak
<ul>
<li>Fix cid/gcid calculations for fs.OverrideRemote (wiserain)</li>
<li>Fix fatal crash on startup with token that can't be refreshed (Nick Craig-Wood)</li>
</ul></li>
<li>S3
<ul>
<li>Fix crash when using <code>--s3-download-url</code> after migration to SDKv2 (Nick Craig-Wood)</li>
<li>Storj provider: fix server-side copy of files bigger than 5GB (Kaloyan Raev)</li>
<li>Fix multitenant multipart uploads with CEPH (Nick Craig-Wood)</li>
</ul></li>
</ul>
<h2 id="v1.68.1---2024-09-24">v1.68.1 - 2024-09-24</h2> <h2 id="v1.68.1---2024-09-24">v1.68.1 - 2024-09-24</h2>
<p><a href="https://github.com/rclone/rclone/compare/v1.68.0...v1.68.1">See commits</a></p> <p><a href="https://github.com/rclone/rclone/compare/v1.68.0...v1.68.1">See commits</a></p>
<ul> <ul>

47
MANUAL.md generated
View file

@ -1,6 +1,6 @@
% rclone(1) User Manual % rclone(1) User Manual
% Nick Craig-Wood % Nick Craig-Wood
% Sep 24, 2024 % Nov 15, 2024
# Rclone syncs your files to cloud storage # Rclone syncs your files to cloud storage
@ -16970,6 +16970,8 @@ processed in.
Arrange the order of filter rules with the most restrictive first and Arrange the order of filter rules with the most restrictive first and
work down. work down.
Lines starting with # or ; are ignored, and can be used to write comments. Inline comments are not supported. _Use `-vv --dump filters` to see how they appear in the final regexp._
E.g. for `filter-file.txt`: E.g. for `filter-file.txt`:
# a sample filter rule file # a sample filter rule file
@ -16977,6 +16979,7 @@ E.g. for `filter-file.txt`:
+ *.jpg + *.jpg
+ *.png + *.png
+ file2.avi + file2.avi
- /dir/tmp/** # WARNING! This text will be treated as part of the path.
- /dir/Trash/** - /dir/Trash/**
+ /dir/** + /dir/**
# exclude everything else # exclude everything else
@ -19787,7 +19790,7 @@ Here is an overview of the major features of each cloud storage system.
| OpenDrive | MD5 | R/W | Yes | Partial ⁸ | - | - | | OpenDrive | MD5 | R/W | Yes | Partial ⁸ | - | - |
| OpenStack Swift | MD5 | R/W | No | No | R/W | - | | OpenStack Swift | MD5 | R/W | No | No | R/W | - |
| Oracle Object Storage | MD5 | R/W | No | No | R/W | - | | Oracle Object Storage | MD5 | R/W | No | No | R/W | - |
| pCloud | MD5, SHA1 ⁷ | R | No | No | W | - | | pCloud | MD5, SHA1 ⁷ | R/W | No | No | W | - |
| PikPak | MD5 | R | No | No | R | - | | PikPak | MD5 | R | No | No | R | - |
| Pixeldrain | SHA256 | R/W | No | No | R | RW | | Pixeldrain | SHA256 | R/W | No | No | R | RW |
| premiumize.me | - | - | Yes | No | R | - | | premiumize.me | - | - | Yes | No | R | - |
@ -20494,7 +20497,7 @@ Flags for general networking and HTTP stuff.
--tpslimit float Limit HTTP transactions per second to this --tpslimit float Limit HTTP transactions per second to this
--tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --tpslimit-burst int Max burst of transactions for --tpslimit (default 1)
--use-cookies Enable session cookiejar --use-cookies Enable session cookiejar
--user-agent string Set the user-agent to a specified string (default "rclone/v1.68.1") --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2")
``` ```
@ -27833,8 +27836,8 @@ chunk_size = 5M
copy_cutoff = 5M copy_cutoff = 5M
``` ```
[C14 Cold Storage](https://www.online.net/en/storage/c14-cold-storage) is the low-cost S3 Glacier alternative from Scaleway and it works the same way as on S3 by accepting the "GLACIER" `storage_class`. [Scaleway Glacier](https://www.scaleway.com/en/glacier-cold-storage/) is the low-cost S3 Glacier alternative from Scaleway and it works the same way as on S3 by accepting the "GLACIER" `storage_class`.
So you can configure your remote with the `storage_class = GLACIER` option to upload directly to C14. Don't forget that in this state you can't read files back after, you will need to restore them to "STANDARD" storage_class first before being able to read them (see "restore" section above) So you can configure your remote with the `storage_class = GLACIER` option to upload directly to Scaleway Glacier. Don't forget that in this state you can't read files back after, you will need to restore them to "STANDARD" storage_class first before being able to read them (see "restore" section above)
### Seagate Lyve Cloud {#lyve} ### Seagate Lyve Cloud {#lyve}
@ -37898,9 +37901,9 @@ then select "OAuth client ID".
9. It will show you a client ID and client secret. Make a note of these. 9. It will show you a client ID and client secret. Make a note of these.
(If you selected "External" at Step 5 continue to Step 9. (If you selected "External" at Step 5 continue to Step 10.
If you chose "Internal" you don't need to publish and can skip straight to If you chose "Internal" you don't need to publish and can skip straight to
Step 10 but your destination drive must be part of the same Google Workspace.) Step 11 but your destination drive must be part of the same Google Workspace.)
10. Go to "Oauth consent screen" and then click "PUBLISH APP" button and confirm. 10. Go to "Oauth consent screen" and then click "PUBLISH APP" button and confirm.
You will also want to add yourself as a test user. You will also want to add yourself as a test user.
@ -54612,6 +54615,36 @@ Options:
# Changelog # Changelog
## v1.68.2 - 2024-11-15
[See commits](https://github.com/rclone/rclone/compare/v1.68.1...v1.68.2)
* Security fixes
* local backend: CVE-2024-52522: fix permission and ownership on symlinks with `--links` and `--metadata` (Nick Craig-Wood)
* Only affects users using `--metadata` and `--links` and copying files to the local backend
* See https://github.com/rclone/rclone/security/advisories/GHSA-hrxh-9w67-g4cv
* build: bump github.com/golang-jwt/jwt/v4 from 4.5.0 to 4.5.1 (dependabot)
* This is an issue in a dependency which is used for JWT certificates
* See https://github.com/golang-jwt/jwt/security/advisories/GHSA-29wx-vh33-7x7r
* Bug Fixes
* accounting: Fix wrong message on SIGUSR2 to enable/disable bwlimit (Nick Craig-Wood)
* bisync: Fix output capture restoring the wrong output for logrus (Dimitrios Slamaris)
* dlna: Fix loggingResponseWriter disregarding log level (Simon Bos)
* serve s3: Fix excess locking which was making serve s3 single threaded (Nick Craig-Wood)
* doc fixes (Nick Craig-Wood, tgfisher, Alexandre Hamez, Randy Bush)
* Local
* Fix permission and ownership on symlinks with `--links` and `--metadata` (Nick Craig-Wood)
* Fix `--copy-links` on macOS when cloning (nielash)
* Onedrive
* Fix Retry-After handling to look at 503 errors also (Nick Craig-Wood)
* Pikpak
* Fix cid/gcid calculations for fs.OverrideRemote (wiserain)
* Fix fatal crash on startup with token that can't be refreshed (Nick Craig-Wood)
* S3
* Fix crash when using `--s3-download-url` after migration to SDKv2 (Nick Craig-Wood)
* Storj provider: fix server-side copy of files bigger than 5GB (Kaloyan Raev)
* Fix multitenant multipart uploads with CEPH (Nick Craig-Wood)
## v1.68.1 - 2024-09-24 ## v1.68.1 - 2024-09-24
[See commits](https://github.com/rclone/rclone/compare/v1.68.0...v1.68.1) [See commits](https://github.com/rclone/rclone/compare/v1.68.0...v1.68.1)

71
MANUAL.txt generated
View file

@ -1,6 +1,6 @@
rclone(1) User Manual rclone(1) User Manual
Nick Craig-Wood Nick Craig-Wood
Sep 24, 2024 Nov 15, 2024
Rclone syncs your files to cloud storage Rclone syncs your files to cloud storage
@ -16428,6 +16428,10 @@ processed in.
Arrange the order of filter rules with the most restrictive first and Arrange the order of filter rules with the most restrictive first and
work down. work down.
Lines starting with # or ; are ignored, and can be used to write
comments. Inline comments are not supported. Use -vv --dump filters to
see how they appear in the final regexp.
E.g. for filter-file.txt: E.g. for filter-file.txt:
# a sample filter rule file # a sample filter rule file
@ -16435,6 +16439,7 @@ E.g. for filter-file.txt:
+ *.jpg + *.jpg
+ *.png + *.png
+ file2.avi + file2.avi
- /dir/tmp/** # WARNING! This text will be treated as part of the path.
- /dir/Trash/** - /dir/Trash/**
+ /dir/** + /dir/**
# exclude everything else # exclude everything else
@ -19269,7 +19274,7 @@ Here is an overview of the major features of each cloud storage system.
OpenDrive MD5 R/W Yes Partial ⁸ - - OpenDrive MD5 R/W Yes Partial ⁸ - -
OpenStack Swift MD5 R/W No No R/W - OpenStack Swift MD5 R/W No No R/W -
Oracle Object Storage MD5 R/W No No R/W - Oracle Object Storage MD5 R/W No No R/W -
pCloud MD5, SHA1 ⁷ R No No W - pCloud MD5, SHA1 ⁷ R/W No No W -
PikPak MD5 R No No R - PikPak MD5 R No No R -
Pixeldrain SHA256 R/W No No R RW Pixeldrain SHA256 R/W No No R RW
premiumize.me - - Yes No R - premiumize.me - - Yes No R -
@ -20076,7 +20081,7 @@ Flags for general networking and HTTP stuff.
--tpslimit float Limit HTTP transactions per second to this --tpslimit float Limit HTTP transactions per second to this
--tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --tpslimit-burst int Max burst of transactions for --tpslimit (default 1)
--use-cookies Enable session cookiejar --use-cookies Enable session cookiejar
--user-agent string Set the user-agent to a specified string (default "rclone/v1.68.1") --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2")
Performance Performance
@ -27364,13 +27369,13 @@ rclone like this:
chunk_size = 5M chunk_size = 5M
copy_cutoff = 5M copy_cutoff = 5M
C14 Cold Storage is the low-cost S3 Glacier alternative from Scaleway Scaleway Glacier is the low-cost S3 Glacier alternative from Scaleway
and it works the same way as on S3 by accepting the "GLACIER" and it works the same way as on S3 by accepting the "GLACIER"
storage_class. So you can configure your remote with the storage_class. So you can configure your remote with the
storage_class = GLACIER option to upload directly to C14. Don't forget storage_class = GLACIER option to upload directly to Scaleway Glacier.
that in this state you can't read files back after, you will need to Don't forget that in this state you can't read files back after, you
restore them to "STANDARD" storage_class first before being able to read will need to restore them to "STANDARD" storage_class first before being
them (see "restore" section above) able to read them (see "restore" section above)
Seagate Lyve Cloud Seagate Lyve Cloud
@ -37324,9 +37329,9 @@ Here is how to create your own Google Drive client ID for rclone:
9. It will show you a client ID and client secret. Make a note of 9. It will show you a client ID and client secret. Make a note of
these. these.
(If you selected "External" at Step 5 continue to Step 9. If you (If you selected "External" at Step 5 continue to Step 10. If you
chose "Internal" you don't need to publish and can skip straight to chose "Internal" you don't need to publish and can skip straight to
Step 10 but your destination drive must be part of the same Google Step 11 but your destination drive must be part of the same Google
Workspace.) Workspace.)
10. Go to "Oauth consent screen" and then click "PUBLISH APP" button and 10. Go to "Oauth consent screen" and then click "PUBLISH APP" button and
@ -54290,6 +54295,52 @@ Options:
Changelog Changelog
v1.68.2 - 2024-11-15
See commits
- Security fixes
- local backend: CVE-2024-52522: fix permission and ownership on
symlinks with --links and --metadata (Nick Craig-Wood)
- Only affects users using --metadata and --links and copying
files to the local backend
- See
https://github.com/rclone/rclone/security/advisories/GHSA-hrxh-9w67-g4cv
- build: bump github.com/golang-jwt/jwt/v4 from 4.5.0 to 4.5.1
(dependabot)
- This is an issue in a dependency which is used for JWT
certificates
- See
https://github.com/golang-jwt/jwt/security/advisories/GHSA-29wx-vh33-7x7r
- Bug Fixes
- accounting: Fix wrong message on SIGUSR2 to enable/disable
bwlimit (Nick Craig-Wood)
- bisync: Fix output capture restoring the wrong output for logrus
(Dimitrios Slamaris)
- dlna: Fix loggingResponseWriter disregarding log level (Simon
Bos)
- serve s3: Fix excess locking which was making serve s3 single
threaded (Nick Craig-Wood)
- doc fixes (Nick Craig-Wood, tgfisher, Alexandre Hamez, Randy
Bush)
- Local
- Fix permission and ownership on symlinks with --links and
--metadata (Nick Craig-Wood)
- Fix --copy-links on macOS when cloning (nielash)
- Onedrive
- Fix Retry-After handling to look at 503 errors also (Nick
Craig-Wood)
- Pikpak
- Fix cid/gcid calculations for fs.OverrideRemote (wiserain)
- Fix fatal crash on startup with token that can't be refreshed
(Nick Craig-Wood)
- S3
- Fix crash when using --s3-download-url after migration to SDKv2
(Nick Craig-Wood)
- Storj provider: fix server-side copy of files bigger than 5GB
(Kaloyan Raev)
- Fix multitenant multipart uploads with CEPH (Nick Craig-Wood)
v1.68.1 - 2024-09-24 v1.68.1 - 2024-09-24
See commits See commits

30
docs/content/changelog.md
View file

@ -5,6 +5,36 @@ description: "Rclone Changelog"
# Changelog # Changelog
## v1.68.2 - 2024-11-15
[See commits](https://github.com/rclone/rclone/compare/v1.68.1...v1.68.2)
* Security fixes
* local backend: CVE-2024-52522: fix permission and ownership on symlinks with `--links` and `--metadata` (Nick Craig-Wood)
* Only affects users using `--metadata` and `--links` and copying files to the local backend
* See https://github.com/rclone/rclone/security/advisories/GHSA-hrxh-9w67-g4cv
* build: bump github.com/golang-jwt/jwt/v4 from 4.5.0 to 4.5.1 (dependabot)
* This is an issue in a dependency which is used for JWT certificates
* See https://github.com/golang-jwt/jwt/security/advisories/GHSA-29wx-vh33-7x7r
* Bug Fixes
* accounting: Fix wrong message on SIGUSR2 to enable/disable bwlimit (Nick Craig-Wood)
* bisync: Fix output capture restoring the wrong output for logrus (Dimitrios Slamaris)
* dlna: Fix loggingResponseWriter disregarding log level (Simon Bos)
* serve s3: Fix excess locking which was making serve s3 single threaded (Nick Craig-Wood)
* doc fixes (Nick Craig-Wood, tgfisher, Alexandre Hamez, Randy Bush)
* Local
* Fix permission and ownership on symlinks with `--links` and `--metadata` (Nick Craig-Wood)
* Fix `--copy-links` on macOS when cloning (nielash)
* Onedrive
* Fix Retry-After handling to look at 503 errors also (Nick Craig-Wood)
* Pikpak
* Fix cid/gcid calculations for fs.OverrideRemote (wiserain)
* Fix fatal crash on startup with token that can't be refreshed (Nick Craig-Wood)
* S3
* Fix crash when using `--s3-download-url` after migration to SDKv2 (Nick Craig-Wood)
* Storj provider: fix server-side copy of files bigger than 5GB (Kaloyan Raev)
* Fix multitenant multipart uploads with CEPH (Nick Craig-Wood)
## v1.68.1 - 2024-09-24 ## v1.68.1 - 2024-09-24
[See commits](https://github.com/rclone/rclone/compare/v1.68.0...v1.68.1) [See commits](https://github.com/rclone/rclone/compare/v1.68.0...v1.68.1)

2
docs/content/commands/rclone.md
View file

@ -929,7 +929,7 @@ rclone [flags]
--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 (default "rclone/v1.68.1") --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2")
-v, --verbose count Print lots more stuff (repeat for more) -v, --verbose count Print lots more stuff (repeat for more)
-V, --version Print the version number -V, --version Print the version number
--webdav-bearer-token string Bearer token instead of user/pass (e.g. a Macaroon) --webdav-bearer-token string Bearer token instead of user/pass (e.g. a Macaroon)

2
docs/content/flags.md
View file

@ -115,7 +115,7 @@ Flags for general networking and HTTP stuff.
--tpslimit float Limit HTTP transactions per second to this --tpslimit float Limit HTTP transactions per second to this
--tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --tpslimit-burst int Max burst of transactions for --tpslimit (default 1)
--use-cookies Enable session cookiejar --use-cookies Enable session cookiejar
--user-agent string Set the user-agent to a specified string (default "rclone/v1.68.1") --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2")
``` ```

103
rclone.1 generated
View file

@ -1,7 +1,7 @@
.\"t .\"t
.\" Automatically generated by Pandoc 2.9.2.1 .\" Automatically generated by Pandoc 2.9.2.1
.\" .\"
.TH "rclone" "1" "Sep 24, 2024" "User Manual" "" .TH "rclone" "1" "Nov 15, 2024" "User Manual" ""
.hy .hy
.SH Rclone syncs your files to cloud storage .SH Rclone syncs your files to cloud storage
.PP .PP
@ -20955,6 +20955,12 @@ See above for the order filter flags are processed in.
Arrange the order of filter rules with the most restrictive first and Arrange the order of filter rules with the most restrictive first and
work down. work down.
.PP .PP
Lines starting with # or ; are ignored, and can be used to write
comments.
Inline comments are not supported.
\f[I]Use \f[CI]-vv --dump filters\f[I] to see how they appear in the
final regexp.\f[R]
.PP
E.g. E.g.
for \f[C]filter-file.txt\f[R]: for \f[C]filter-file.txt\f[R]:
.IP .IP
@ -20965,6 +20971,7 @@ for \f[C]filter-file.txt\f[R]:
+ *.jpg + *.jpg
+ *.png + *.png
+ file2.avi + file2.avi
- /dir/tmp/** # WARNING! This text will be treated as part of the path.
- /dir/Trash/** - /dir/Trash/**
+ /dir/** + /dir/**
# exclude everything else # exclude everything else
@ -24965,7 +24972,7 @@ pCloud
T}@T{ T}@T{
MD5, SHA1 \[u2077] MD5, SHA1 \[u2077]
T}@T{ T}@T{
R R/W
T}@T{ T}@T{
No No
T}@T{ T}@T{
@ -27719,7 +27726,7 @@ Flags for general networking and HTTP stuff.
--tpslimit float Limit HTTP transactions per second to this --tpslimit float Limit HTTP transactions per second to this
--tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --tpslimit-burst int Max burst of transactions for --tpslimit (default 1)
--use-cookies Enable session cookiejar --use-cookies Enable session cookiejar
--user-agent string Set the user-agent to a specified string (default \[dq]rclone/v1.68.1\[dq]) --user-agent string Set the user-agent to a specified string (default \[dq]rclone/v1.68.2\[dq])
\f[R] \f[R]
.fi .fi
.SS Performance .SS Performance
@ -37393,11 +37400,12 @@ copy_cutoff = 5M
\f[R] \f[R]
.fi .fi
.PP .PP
C14 Cold Storage (https://www.online.net/en/storage/c14-cold-storage) is Scaleway Glacier (https://www.scaleway.com/en/glacier-cold-storage/) is
the low-cost S3 Glacier alternative from Scaleway and it works the same the low-cost S3 Glacier alternative from Scaleway and it works the same
way as on S3 by accepting the \[dq]GLACIER\[dq] \f[C]storage_class\f[R]. way as on S3 by accepting the \[dq]GLACIER\[dq] \f[C]storage_class\f[R].
So you can configure your remote with the So you can configure your remote with the
\f[C]storage_class = GLACIER\f[R] option to upload directly to C14. \f[C]storage_class = GLACIER\f[R] option to upload directly to Scaleway
Glacier.
Don\[aq]t forget that in this state you can\[aq]t read files back after, Don\[aq]t forget that in this state you can\[aq]t read files back after,
you will need to restore them to \[dq]STANDARD\[dq] storage_class first you will need to restore them to \[dq]STANDARD\[dq] storage_class first
before being able to read them (see \[dq]restore\[dq] section above) before being able to read them (see \[dq]restore\[dq] section above)
@ -50216,9 +50224,9 @@ It will show you a client ID and client secret.
Make a note of these. Make a note of these.
.RS 4 .RS 4
.PP .PP
(If you selected \[dq]External\[dq] at Step 5 continue to Step 9. (If you selected \[dq]External\[dq] at Step 5 continue to Step 10.
If you chose \[dq]Internal\[dq] you don\[aq]t need to publish and can If you chose \[dq]Internal\[dq] you don\[aq]t need to publish and can
skip straight to Step 10 but your destination drive must be part of the skip straight to Step 11 but your destination drive must be part of the
same Google Workspace.) same Google Workspace.)
.RE .RE
.IP "10." 4 .IP "10." 4
@ -72522,6 +72530,87 @@ 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.68.2 - 2024-11-15
.PP
See commits (https://github.com/rclone/rclone/compare/v1.68.1...v1.68.2)
.IP \[bu] 2
Security fixes
.RS 2
.IP \[bu] 2
local backend: CVE-2024-52522: fix permission and ownership on symlinks
with \f[C]--links\f[R] and \f[C]--metadata\f[R] (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
Only affects users using \f[C]--metadata\f[R] and \f[C]--links\f[R] and
copying files to the local backend
.IP \[bu] 2
See
https://github.com/rclone/rclone/security/advisories/GHSA-hrxh-9w67-g4cv
.RE
.IP \[bu] 2
build: bump github.com/golang-jwt/jwt/v4 from 4.5.0 to 4.5.1
(dependabot)
.RS 2
.IP \[bu] 2
This is an issue in a dependency which is used for JWT certificates
.IP \[bu] 2
See
https://github.com/golang-jwt/jwt/security/advisories/GHSA-29wx-vh33-7x7r
.RE
.RE
.IP \[bu] 2
Bug Fixes
.RS 2
.IP \[bu] 2
accounting: Fix wrong message on SIGUSR2 to enable/disable bwlimit (Nick
Craig-Wood)
.IP \[bu] 2
bisync: Fix output capture restoring the wrong output for logrus
(Dimitrios Slamaris)
.IP \[bu] 2
dlna: Fix loggingResponseWriter disregarding log level (Simon Bos)
.IP \[bu] 2
serve s3: Fix excess locking which was making serve s3 single threaded
(Nick Craig-Wood)
.IP \[bu] 2
doc fixes (Nick Craig-Wood, tgfisher, Alexandre Hamez, Randy Bush)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
Fix permission and ownership on symlinks with \f[C]--links\f[R] and
\f[C]--metadata\f[R] (Nick Craig-Wood)
.IP \[bu] 2
Fix \f[C]--copy-links\f[R] on macOS when cloning (nielash)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
Fix Retry-After handling to look at 503 errors also (Nick Craig-Wood)
.RE
.IP \[bu] 2
Pikpak
.RS 2
.IP \[bu] 2
Fix cid/gcid calculations for fs.OverrideRemote (wiserain)
.IP \[bu] 2
Fix fatal crash on startup with token that can\[aq]t be refreshed (Nick
Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
Fix crash when using \f[C]--s3-download-url\f[R] after migration to
SDKv2 (Nick Craig-Wood)
.IP \[bu] 2
Storj provider: fix server-side copy of files bigger than 5GB (Kaloyan
Raev)
.IP \[bu] 2
Fix multitenant multipart uploads with CEPH (Nick Craig-Wood)
.RE
.SS v1.68.1 - 2024-09-24 .SS v1.68.1 - 2024-09-24
.PP .PP
See commits (https://github.com/rclone/rclone/compare/v1.68.0...v1.68.1) See commits (https://github.com/rclone/rclone/compare/v1.68.0...v1.68.1)