mirror of
https://github.com/octoleo/restic.git
synced 2024-12-23 11:28:54 +00:00
34a6a24544
Per Amazon's product page [1], S3 is officially called "Amazon S3". The restic project uses the phrase "AWS S3" in some places. This patch corrects the product name. [1]:https://aws.amazon.com/s3/
3329 lines
141 KiB
Markdown
3329 lines
141 KiB
Markdown
Changelog for restic 0.12.1 (2021-08-03)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.12.1 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #2742: Improve error handling for rclone and REST backend over HTTP2
|
||
* Fix #3111: Fix terminal output redirection for PowerShell
|
||
* Fix #3214: Treat an empty password as a fatal error for repository init
|
||
* Fix #3267: `copy` failed to copy snapshots in rare cases
|
||
* Fix #3184: `backup --quiet` no longer prints status information
|
||
* Fix #3296: Fix crash of `check --read-data-subset=x%` run for an empty repository
|
||
* Fix #3302: Fix `fdopendir: not a directory` error for local backend
|
||
* Fix #3334: Print `created new cache` message only on a terminal
|
||
* Fix #3380: Fix crash of `backup --exclude='**'`
|
||
* Fix #3305: Fix possibly missing backup summary of JSON output in case of error
|
||
* Fix #3439: Correctly handle download errors during `restore`
|
||
* Chg #3247: Empty files now have size of 0 in `ls --json` output
|
||
* Enh #2780: Add release binaries for s390x architecture on Linux
|
||
* Enh #3293: Add `--repository-file2` option to `init` and `copy` command
|
||
* Enh #3312: Add auto-completion support for fish
|
||
* Enh #3336: SFTP backend now checks for disk space
|
||
* Enh #3377: Add release binaries for Apple Silicon
|
||
* Enh #3414: Add `--keep-within-hourly` option to restic forget
|
||
* Enh #3456: Support filtering and specifying untagged snapshots
|
||
* Enh #3167: Allow specifying limit of `snapshots` list
|
||
* Enh #3426: Optimize read performance of mount command
|
||
* Enh #3427: `find --pack` fallback to index if data file is missing
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #2742: Improve error handling for rclone and REST backend over HTTP2
|
||
|
||
When retrieving data from the rclone / REST backend while also using HTTP2 restic did not detect
|
||
when no data was returned at all. This could cause for example the `check` command to report the
|
||
following error:
|
||
|
||
Pack ID does not match, want [...], got e3b0c442
|
||
|
||
This has been fixed by correctly detecting and retrying the incomplete download.
|
||
|
||
https://github.com/restic/restic/issues/2742
|
||
https://github.com/restic/restic/pull/3453
|
||
https://forum.restic.net/t/http2-stream-closed-connection-reset-context-canceled/3743/10
|
||
|
||
* Bugfix #3111: Fix terminal output redirection for PowerShell
|
||
|
||
When redirecting the output of restic using PowerShell on Windows, the output contained
|
||
terminal escape characters. This has been fixed by properly detecting the terminal type.
|
||
|
||
In addition, the mintty terminal now shows progress output for the backup command.
|
||
|
||
https://github.com/restic/restic/issues/3111
|
||
https://github.com/restic/restic/pull/3325
|
||
|
||
* Bugfix #3214: Treat an empty password as a fatal error for repository init
|
||
|
||
When attempting to initialize a new repository, if an empty password was supplied, the
|
||
repository would be created but the init command would return an error with a stack trace. Now,
|
||
if an empty password is provided, it is treated as a fatal error, and no repository is created.
|
||
|
||
https://github.com/restic/restic/issues/3214
|
||
https://github.com/restic/restic/pull/3283
|
||
|
||
* Bugfix #3267: `copy` failed to copy snapshots in rare cases
|
||
|
||
The `copy` command could in rare cases fail with the error message `SaveTree(...) returned
|
||
unexpected id ...`. This has been fixed.
|
||
|
||
On Linux/BSDs, the error could be caused by backing up symlinks with non-UTF-8 target paths.
|
||
Note that, due to limitations in the repository format, these are not stored properly and
|
||
should be avoided if possible.
|
||
|
||
https://github.com/restic/restic/issues/3267
|
||
https://github.com/restic/restic/pull/3310
|
||
|
||
* Bugfix #3184: `backup --quiet` no longer prints status information
|
||
|
||
A regression in the latest restic version caused the output of `backup --quiet` to contain
|
||
large amounts of backup progress information when run using an interactive terminal. This is
|
||
fixed now.
|
||
|
||
A workaround for this bug is to run restic as follows: `restic backup --quiet [..] | cat -`.
|
||
|
||
https://github.com/restic/restic/issues/3184
|
||
https://github.com/restic/restic/pull/3186
|
||
|
||
* Bugfix #3296: Fix crash of `check --read-data-subset=x%` run for an empty repository
|
||
|
||
The command `restic check --read-data-subset=x%` crashed when run for an empty repository.
|
||
This has been fixed.
|
||
|
||
https://github.com/restic/restic/issues/3296
|
||
https://github.com/restic/restic/pull/3309
|
||
|
||
* Bugfix #3302: Fix `fdopendir: not a directory` error for local backend
|
||
|
||
The `check`, `list packs`, `prune` and `rebuild-index` commands failed for the local backend
|
||
when the `data` folder in the repository contained files. This has been fixed.
|
||
|
||
https://github.com/restic/restic/issues/3302
|
||
https://github.com/restic/restic/pull/3308
|
||
|
||
* Bugfix #3334: Print `created new cache` message only on a terminal
|
||
|
||
The message `created new cache` was printed even when the output wasn't a terminal. That broke
|
||
piping `restic dump` output to tar or zip if cache directory didn't exist. The message is now
|
||
only printed on a terminal.
|
||
|
||
https://github.com/restic/restic/issues/3334
|
||
https://github.com/restic/restic/pull/3343
|
||
|
||
* Bugfix #3380: Fix crash of `backup --exclude='**'`
|
||
|
||
The exclude filter `**`, which excludes all files, caused restic to crash. This has been
|
||
corrected.
|
||
|
||
https://github.com/restic/restic/issues/3380
|
||
https://github.com/restic/restic/pull/3393
|
||
|
||
* Bugfix #3305: Fix possibly missing backup summary of JSON output in case of error
|
||
|
||
When using `--json` output it happened from time to time that the summary output was missing in
|
||
case an error occurred. This has been fixed.
|
||
|
||
https://github.com/restic/restic/pull/3305
|
||
|
||
* Bugfix #3439: Correctly handle download errors during `restore`
|
||
|
||
Due to a regression in restic 0.12.0, the `restore` command in some cases did not retry download
|
||
errors and only printed a warning. This has been fixed by retrying incomplete data downloads.
|
||
|
||
https://github.com/restic/restic/issues/3439
|
||
https://github.com/restic/restic/pull/3449
|
||
|
||
* Change #3247: Empty files now have size of 0 in `ls --json` output
|
||
|
||
The `ls --json` command used to omit the sizes of empty files in its output. It now reports a size
|
||
of zero explicitly for regular files, while omitting the size field for all other types.
|
||
|
||
https://github.com/restic/restic/issues/3247
|
||
https://github.com/restic/restic/pull/3257
|
||
|
||
* Enhancement #2780: Add release binaries for s390x architecture on Linux
|
||
|
||
We've added release binaries for Linux using the s390x architecture.
|
||
|
||
https://github.com/restic/restic/issues/2780
|
||
https://github.com/restic/restic/pull/3452
|
||
|
||
* Enhancement #3293: Add `--repository-file2` option to `init` and `copy` command
|
||
|
||
The `init` and `copy` command can now be used with the `--repository-file2` option or the
|
||
`$RESTIC_REPOSITORY_FILE2` environment variable. These to options are in addition to the
|
||
`--repo2` flag and allow you to read the destination repository from a file.
|
||
|
||
Using both `--repository-file` and `--repo2` options resulted in an error for the `copy` or
|
||
`init` command. The handling of this combination of options has been fixed. A workaround for
|
||
this issue is to only use `--repo` or `-r` and `--repo2` for `init` or `copy`.
|
||
|
||
https://github.com/restic/restic/issues/3293
|
||
https://github.com/restic/restic/pull/3294
|
||
|
||
* Enhancement #3312: Add auto-completion support for fish
|
||
|
||
The `generate` command now supports fish auto completion.
|
||
|
||
https://github.com/restic/restic/pull/3312
|
||
|
||
* Enhancement #3336: SFTP backend now checks for disk space
|
||
|
||
Backing up over SFTP previously spewed multiple generic "failure" messages when the remote
|
||
disk was full. It now checks for disk space before writing a file and fails immediately with a "no
|
||
space left on device" message.
|
||
|
||
https://github.com/restic/restic/issues/3336
|
||
https://github.com/restic/restic/pull/3345
|
||
|
||
* Enhancement #3377: Add release binaries for Apple Silicon
|
||
|
||
We've added release binaries for macOS on Apple Silicon (M1).
|
||
|
||
https://github.com/restic/restic/issues/3377
|
||
https://github.com/restic/restic/pull/3394
|
||
|
||
* Enhancement #3414: Add `--keep-within-hourly` option to restic forget
|
||
|
||
The `forget` command allowed keeping a given number of hourly backups or to keep all backups
|
||
within a given interval, but it was not possible to specify keeping hourly backups within a
|
||
given interval.
|
||
|
||
The new `--keep-within-hourly` option now offers this functionality. Similar options for
|
||
daily/weekly/monthly/yearly are also implemented, the new options are:
|
||
|
||
--keep-within-hourly <1y2m3d4h> --keep-within-daily <1y2m3d4h> --keep-within-weekly
|
||
<1y2m3d4h> --keep-within-monthly <1y2m3d4h> --keep-within-yearly <1y2m3d4h>
|
||
|
||
https://github.com/restic/restic/issues/3414
|
||
https://github.com/restic/restic/pull/3416
|
||
https://forum.restic.net/t/forget-policy/4014/11
|
||
|
||
* Enhancement #3456: Support filtering and specifying untagged snapshots
|
||
|
||
It was previously not possible to specify an empty tag with the `--tag` and `--keep-tag`
|
||
options. This has now been fixed, such that `--tag ''` and `--keep-tag ''` now matches
|
||
snapshots without tags. This allows e.g. the `snapshots` and `forget` commands to only
|
||
operate on untagged snapshots.
|
||
|
||
https://github.com/restic/restic/issues/3456
|
||
https://github.com/restic/restic/pull/3457
|
||
|
||
* Enhancement #3167: Allow specifying limit of `snapshots` list
|
||
|
||
The `--last` option allowed limiting the output of the `snapshots` command to the latest
|
||
snapshot for each host. The new `--latest n` option allows limiting the output to the latest `n`
|
||
snapshots.
|
||
|
||
This change deprecates the option `--last` in favour of `--latest 1`.
|
||
|
||
https://github.com/restic/restic/pull/3167
|
||
|
||
* Enhancement #3426: Optimize read performance of mount command
|
||
|
||
Reading large files in a mounted repository may be up to five times faster. This improvement
|
||
primarily applies to repositories stored at a backend that can be accessed with low latency,
|
||
like e.g. the local backend.
|
||
|
||
https://github.com/restic/restic/pull/3426
|
||
|
||
* Enhancement #3427: `find --pack` fallback to index if data file is missing
|
||
|
||
When investigating a repository with missing data files, it might be useful to determine
|
||
affected snapshots before running `rebuild-index`. Previously, `find --pack pack-id`
|
||
returned no data as it required accessing the data file. Now, if the necessary data is still
|
||
available in the repository index, it gets retrieved from there.
|
||
|
||
The command now also supports looking up multiple pack files in a single `find` run.
|
||
|
||
https://github.com/restic/restic/pull/3427
|
||
https://forum.restic.net/t/missing-packs-not-found/2600
|
||
|
||
|
||
Changelog for restic 0.12.0 (2021-02-14)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.12.0 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1681: Make `mount` not create missing mount point directory
|
||
* Fix #1800: Ignore `no data available` filesystem error during backup
|
||
* Fix #2563: Report the correct owner of directories in FUSE mounts
|
||
* Fix #2688: Make `backup` and `tag` commands separate tags by comma
|
||
* Fix #2739: Make the `cat` command respect the `--no-lock` option
|
||
* Fix #3087: The `--use-fs-snapshot` option now works on windows/386
|
||
* Fix #3100: Do not require gs bucket permissions when running `init`
|
||
* Fix #3111: Correctly detect output redirection for `backup` command on Windows
|
||
* Fix #3151: Don't create invalid snapshots when `backup` is interrupted
|
||
* Fix #3166: Improve error handling in the `restore` command
|
||
* Fix #3232: Correct statistics for overlapping targets
|
||
* Fix #3014: Fix sporadic stream reset between rclone and restic
|
||
* Fix #3152: Do not hang until foregrounded when completed in background
|
||
* Fix #3249: Improve error handling in `gs` backend
|
||
* Chg #3095: Deleting files on Google Drive now moves them to the trash
|
||
* Enh #2186: Allow specifying percentage in `check --read-data-subset`
|
||
* Enh #2453: Report permanent/fatal backend errors earlier
|
||
* Enh #2528: Add Alibaba/Aliyun OSS support in the `s3` backend
|
||
* Enh #2706: Configurable progress reports for non-interactive terminals
|
||
* Enh #2944: Add `backup` options `--files-from-{verbatim,raw}`
|
||
* Enh #3083: Allow usage of deprecated S3 `ListObjects` API
|
||
* Enh #3147: Support additional environment variables for Swift authentication
|
||
* Enh #3191: Add release binaries for MIPS architectures
|
||
* Enh #909: Back up mountpoints as empty directories
|
||
* Enh #3250: Add several more error checks
|
||
* Enh #2718: Improve `prune` performance and make it more customizable
|
||
* Enh #2495: Add option to let `backup` trust mtime without checking ctime
|
||
* Enh #2941: Speed up the repacking step of the `prune` command
|
||
* Enh #3006: Speed up the `rebuild-index` command
|
||
* Enh #3048: Add more checks for index and pack files in the `check` command
|
||
* Enh #2433: Make the `dump` command support `zip` format
|
||
* Enh #3099: Reduce memory usage of `check` command
|
||
* Enh #3106: Parallelize scan of snapshot content in `copy` and `prune`
|
||
* Enh #3130: Parallelize reading of locks and snapshots
|
||
* Enh #3254: Enable HTTP/2 for backend connections
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1681: Make `mount` not create missing mount point directory
|
||
|
||
When specifying a non-existent directory as mount point for the `mount` command, restic used
|
||
to create the specified directory automatically.
|
||
|
||
This has now changed such that restic instead gives an error when the specified directory for
|
||
the mount point does not exist.
|
||
|
||
https://github.com/restic/restic/issues/1681
|
||
https://github.com/restic/restic/pull/3008
|
||
|
||
* Bugfix #1800: Ignore `no data available` filesystem error during backup
|
||
|
||
Restic was unable to backup files on some filesystems, for example certain configurations of
|
||
CIFS on Linux which return a `no data available` error when reading extended attributes. These
|
||
errors are now ignored.
|
||
|
||
https://github.com/restic/restic/issues/1800
|
||
https://github.com/restic/restic/pull/3034
|
||
|
||
* Bugfix #2563: Report the correct owner of directories in FUSE mounts
|
||
|
||
Restic 0.10.0 changed the FUSE mount to always report the current user as the owner of
|
||
directories within the FUSE mount, which is incorrect.
|
||
|
||
This is now changed back to reporting the correct owner of a directory.
|
||
|
||
https://github.com/restic/restic/issues/2563
|
||
https://github.com/restic/restic/pull/3141
|
||
|
||
* Bugfix #2688: Make `backup` and `tag` commands separate tags by comma
|
||
|
||
Running `restic backup --tag foo,bar` previously created snapshots with one single tag
|
||
containing a comma (`foo,bar`) instead of two tags (`foo`, `bar`).
|
||
|
||
Similarly, the `tag` command's `--set`, `--add` and `--remove` options would treat
|
||
`foo,bar` as one tag instead of two tags. This was inconsistent with other commands and often
|
||
unexpected when one intended `foo,bar` to mean two tags.
|
||
|
||
To be consistent in all commands, restic now interprets `foo,bar` to mean two separate tags
|
||
(`foo` and `bar`) instead of one tag (`foo,bar`) everywhere, including in the `backup` and
|
||
`tag` commands.
|
||
|
||
NOTE: This change might result in unexpected behavior in cases where you use the `forget`
|
||
command and filter on tags like `foo,bar`. Snapshots previously backed up with `--tag
|
||
foo,bar` will still not match that filter, but snapshots saved from now on will match that
|
||
filter.
|
||
|
||
To replace `foo,bar` tags with `foo` and `bar` tags in old snapshots, you can first generate a
|
||
list of the relevant snapshots using a command like:
|
||
|
||
Restic snapshots --json --quiet | jq '.[] | select(contains({tags: ["foo,bar"]})) | .id'
|
||
|
||
And then use `restic tag --set foo --set bar snapshotID [...]` to set the new tags. Please adjust
|
||
the commands to include real tag names and any additional tags, as well as the list of snapshots
|
||
to process.
|
||
|
||
https://github.com/restic/restic/issues/2688
|
||
https://github.com/restic/restic/pull/2690
|
||
https://github.com/restic/restic/pull/3197
|
||
|
||
* Bugfix #2739: Make the `cat` command respect the `--no-lock` option
|
||
|
||
The `cat` command would not respect the `--no-lock` flag. This is now fixed.
|
||
|
||
https://github.com/restic/restic/issues/2739
|
||
|
||
* Bugfix #3087: The `--use-fs-snapshot` option now works on windows/386
|
||
|
||
Restic failed to create VSS snapshots on windows/386 with the following error:
|
||
|
||
GetSnapshotProperties() failed: E_INVALIDARG (0x80070057)
|
||
|
||
This is now fixed.
|
||
|
||
https://github.com/restic/restic/issues/3087
|
||
https://github.com/restic/restic/pull/3090
|
||
|
||
* Bugfix #3100: Do not require gs bucket permissions when running `init`
|
||
|
||
Restic used to require bucket level permissions for the `gs` backend in order to initialize a
|
||
restic repository.
|
||
|
||
It now allows a `gs` service account to initialize a repository if the bucket does exist and the
|
||
service account has permissions to write/read to that bucket.
|
||
|
||
https://github.com/restic/restic/issues/3100
|
||
|
||
* Bugfix #3111: Correctly detect output redirection for `backup` command on Windows
|
||
|
||
On Windows, since restic 0.10.0 the `backup` command did not properly detect when the output
|
||
was redirected to a file. This caused restic to output terminal control characters. This has
|
||
been fixed by correcting the terminal detection.
|
||
|
||
https://github.com/restic/restic/issues/3111
|
||
https://github.com/restic/restic/pull/3150
|
||
|
||
* Bugfix #3151: Don't create invalid snapshots when `backup` is interrupted
|
||
|
||
When canceling a backup run at a certain moment it was possible that restic created a snapshot
|
||
with an invalid "null" tree. This caused `check` and other operations to fail. The `backup`
|
||
command now properly handles interruptions and never saves a snapshot when interrupted.
|
||
|
||
https://github.com/restic/restic/issues/3151
|
||
https://github.com/restic/restic/pull/3164
|
||
|
||
* Bugfix #3166: Improve error handling in the `restore` command
|
||
|
||
The `restore` command used to not print errors while downloading file contents from the
|
||
repository. It also incorrectly exited with a zero error code even when there were errors
|
||
during the restore process. This has all been fixed and `restore` now returns with a non-zero
|
||
exit code when there's an error.
|
||
|
||
https://github.com/restic/restic/issues/3166
|
||
https://github.com/restic/restic/pull/3207
|
||
|
||
* Bugfix #3232: Correct statistics for overlapping targets
|
||
|
||
A user reported that restic's statistics and progress information during backup was not
|
||
correctly calculated when the backup targets (files/dirs to save) overlap. For example,
|
||
consider a directory `foo` which contains (among others) a file `foo/bar`. When `restic
|
||
backup foo foo/bar` was run, restic counted the size of the file `foo/bar` twice, so the
|
||
completeness percentage as well as the number of files was wrong. This is now corrected.
|
||
|
||
https://github.com/restic/restic/issues/3232
|
||
https://github.com/restic/restic/pull/3243
|
||
|
||
* Bugfix #3014: Fix sporadic stream reset between rclone and restic
|
||
|
||
Sometimes when using restic with the `rclone` backend, an error message similar to the
|
||
following would be printed:
|
||
|
||
Didn't finish writing GET request (wrote 0/xxx): http2: stream closed
|
||
|
||
It was found that this was caused by restic closing the connection to rclone to soon when
|
||
downloading data. A workaround has been added which waits for the end of the download before
|
||
closing the connection.
|
||
|
||
https://github.com/rclone/rclone/issues/2598
|
||
https://github.com/restic/restic/pull/3014
|
||
|
||
* Bugfix #3152: Do not hang until foregrounded when completed in background
|
||
|
||
On Linux, when running in the background restic failed to stop the terminal output of the
|
||
`backup` command after it had completed. This caused restic to hang until moved to the
|
||
foreground. This has now been fixed.
|
||
|
||
https://github.com/restic/restic/pull/3152
|
||
https://forum.restic.net/t/restic-alpine-container-cron-hangs-epoll-pwait/3334
|
||
|
||
* Bugfix #3249: Improve error handling in `gs` backend
|
||
|
||
The `gs` backend did not notice when the last step of completing a file upload failed. Under rare
|
||
circumstances, this could cause missing files in the backup repository. This has now been
|
||
fixed.
|
||
|
||
https://github.com/restic/restic/pull/3249
|
||
|
||
* Change #3095: Deleting files on Google Drive now moves them to the trash
|
||
|
||
When deleting files on Google Drive via the `rclone` backend, restic used to bypass the trash
|
||
folder required that one used the `-o rclone.args` option to enable usage of the trash folder.
|
||
This ensured that deleted files in Google Drive were not kept indefinitely in the trash folder.
|
||
However, since Google Drive's trash retention policy changed to deleting trashed files after
|
||
30 days, this is no longer needed.
|
||
|
||
Restic now leaves it up to rclone and its configuration to use or not use the trash folder when
|
||
deleting files. The default is to use the trash folder, as of rclone 1.53.2. To re-enable the
|
||
restic 0.11 behavior, set the `RCLONE_DRIVE_USE_TRASH` environment variable or change the
|
||
rclone configuration. See the rclone documentation for more details.
|
||
|
||
https://github.com/restic/restic/issues/3095
|
||
https://github.com/restic/restic/pull/3102
|
||
|
||
* Enhancement #2186: Allow specifying percentage in `check --read-data-subset`
|
||
|
||
We've enhanced the `check` command's `--read-data-subset` option to also accept a
|
||
percentage (e.g. `2.5%` or `10%`). This will check the given percentage of pack files (which
|
||
are randomly selected on each run).
|
||
|
||
https://github.com/restic/restic/issues/2186
|
||
https://github.com/restic/restic/pull/3038
|
||
|
||
* Enhancement #2453: Report permanent/fatal backend errors earlier
|
||
|
||
When encountering errors in reading from or writing to storage backends, restic retries the
|
||
failing operation up to nine times (for a total of ten attempts). It used to retry all backend
|
||
operations, but now detects some permanent error conditions so that it can report fatal errors
|
||
earlier.
|
||
|
||
Permanent failures include local disks being full, SSH connections dropping and permission
|
||
errors.
|
||
|
||
https://github.com/restic/restic/issues/2453
|
||
https://github.com/restic/restic/issues/3180
|
||
https://github.com/restic/restic/pull/3170
|
||
https://github.com/restic/restic/pull/3181
|
||
|
||
* Enhancement #2528: Add Alibaba/Aliyun OSS support in the `s3` backend
|
||
|
||
A new extended option `s3.bucket-lookup` has been added to support Alibaba/Aliyun OSS in the
|
||
`s3` backend. The option can be set to one of the following values:
|
||
|
||
- `auto` - Existing behaviour - `dns` - Use DNS style bucket access - `path` - Use path style
|
||
bucket access
|
||
|
||
To make the `s3` backend work with Alibaba/Aliyun OSS you must set `s3.bucket-lookup` to `dns`
|
||
and set the `s3.region` parameter. For example:
|
||
|
||
Restic -o s3.bucket-lookup=dns -o s3.region=oss-eu-west-1 -r
|
||
s3:https://oss-eu-west-1.aliyuncs.com/bucketname init
|
||
|
||
Note that `s3.region` must be set, otherwise the MinIO SDK tries to look it up and it seems that
|
||
Alibaba doesn't support that properly.
|
||
|
||
https://github.com/restic/restic/issues/2528
|
||
https://github.com/restic/restic/pull/2535
|
||
|
||
* Enhancement #2706: Configurable progress reports for non-interactive terminals
|
||
|
||
The `backup`, `check` and `prune` commands never printed any progress reports on
|
||
non-interactive terminals. This behavior is now configurable using the
|
||
`RESTIC_PROGRESS_FPS` environment variable. Use for example a value of `1` for an update
|
||
every second, or `0.01666` for an update every minute.
|
||
|
||
The `backup` command now also prints the current progress when restic receives a `SIGUSR1`
|
||
signal.
|
||
|
||
Setting the `RESTIC_PROGRESS_FPS` environment variable or sending a `SIGUSR1` signal
|
||
prints a status report even when `--quiet` was specified.
|
||
|
||
https://github.com/restic/restic/issues/2706
|
||
https://github.com/restic/restic/issues/3194
|
||
https://github.com/restic/restic/pull/3199
|
||
|
||
* Enhancement #2944: Add `backup` options `--files-from-{verbatim,raw}`
|
||
|
||
The new `backup` options `--files-from-verbatim` and `--files-from-raw` read a list of
|
||
files to back up from a file. Unlike the existing `--files-from` option, these options do not
|
||
interpret the listed filenames as glob patterns; instead, whitespace in filenames is
|
||
preserved as-is and no pattern expansion is done. Please see the documentation for specifics.
|
||
|
||
These new options are highly recommended over `--files-from`, when using a script to generate
|
||
the list of files to back up.
|
||
|
||
https://github.com/restic/restic/issues/2944
|
||
https://github.com/restic/restic/issues/3013
|
||
|
||
* Enhancement #3083: Allow usage of deprecated S3 `ListObjects` API
|
||
|
||
Some S3 API implementations, e.g. Ceph before version 14.2.5, have a broken `ListObjectsV2`
|
||
implementation which causes problems for restic when using their API endpoints. When a broken
|
||
server implementation is used, restic prints errors similar to the following:
|
||
|
||
List() returned error: Truncated response should have continuation token set
|
||
|
||
As a temporary workaround, restic now allows using the older `ListObjects` endpoint by
|
||
setting the `s3.list-objects-v1` extended option, for instance:
|
||
|
||
Restic -o s3.list-objects-v1=true snapshots
|
||
|
||
Please note that this option may be removed in future versions of restic.
|
||
|
||
https://github.com/restic/restic/issues/3083
|
||
https://github.com/restic/restic/pull/3085
|
||
|
||
* Enhancement #3147: Support additional environment variables for Swift authentication
|
||
|
||
The `swift` backend now supports the following additional environment variables for passing
|
||
authentication details to restic: `OS_USER_ID`, `OS_USER_DOMAIN_ID`,
|
||
`OS_PROJECT_DOMAIN_ID` and `OS_TRUST_ID`
|
||
|
||
Depending on the `openrc` configuration file these might be required when the user and project
|
||
domains differ from one another.
|
||
|
||
https://github.com/restic/restic/issues/3147
|
||
https://github.com/restic/restic/pull/3158
|
||
|
||
* Enhancement #3191: Add release binaries for MIPS architectures
|
||
|
||
We've added a few new architectures for Linux to the release binaries: `mips`, `mipsle`,
|
||
`mips64`, and `mip64le`. MIPS is mostly used for low-end embedded systems.
|
||
|
||
https://github.com/restic/restic/issues/3191
|
||
https://github.com/restic/restic/pull/3208
|
||
|
||
* Enhancement #909: Back up mountpoints as empty directories
|
||
|
||
When the `--one-file-system` option is specified to `restic backup`, it ignores all file
|
||
systems mounted below one of the target directories. This means that when a snapshot is
|
||
restored, users needed to manually recreate the mountpoint directories.
|
||
|
||
Restic now backs up mountpoints as empty directories and therefore implements the same
|
||
approach as `tar`.
|
||
|
||
https://github.com/restic/restic/issues/909
|
||
https://github.com/restic/restic/pull/3119
|
||
|
||
* Enhancement #3250: Add several more error checks
|
||
|
||
We've added a lot more error checks in places where errors were previously ignored (as hinted by
|
||
the static analysis program `errcheck` via `golangci-lint`).
|
||
|
||
https://github.com/restic/restic/pull/3250
|
||
|
||
* Enhancement #2718: Improve `prune` performance and make it more customizable
|
||
|
||
The `prune` command is now much faster. This is especially the case for remote repositories or
|
||
repositories with not much data to remove. Also the memory usage of the `prune` command is now
|
||
reduced.
|
||
|
||
Restic used to rebuild the index from scratch after pruning. This could lead to missing packs in
|
||
the index in some cases for eventually consistent backends such as e.g. Amazon S3. This behavior is
|
||
now changed and the index rebuilding uses the information already known by `prune`.
|
||
|
||
By default, the `prune` command no longer removes all unused data. This behavior can be
|
||
fine-tuned by new options, like the acceptable amount of unused space or the maximum size of
|
||
data to reorganize. For more details, please see
|
||
https://restic.readthedocs.io/en/stable/060_forget.html .
|
||
|
||
Moreover, `prune` now accepts the `--dry-run` option and also running `forget --dry-run
|
||
--prune` will show what `prune` would do.
|
||
|
||
This enhancement also fixes several open issues, e.g.: -
|
||
https://github.com/restic/restic/issues/1140 -
|
||
https://github.com/restic/restic/issues/1599 -
|
||
https://github.com/restic/restic/issues/1985 -
|
||
https://github.com/restic/restic/issues/2112 -
|
||
https://github.com/restic/restic/issues/2227 -
|
||
https://github.com/restic/restic/issues/2305
|
||
|
||
https://github.com/restic/restic/pull/2718
|
||
https://github.com/restic/restic/pull/2842
|
||
|
||
* Enhancement #2495: Add option to let `backup` trust mtime without checking ctime
|
||
|
||
The `backup` command used to require that both `ctime` and `mtime` of a file matched with a
|
||
previously backed up version to determine that the file was unchanged. In other words, if
|
||
either `ctime` or `mtime` of the file had changed, it would be considered changed and restic
|
||
would read the file's content again to back up the relevant (changed) parts of it.
|
||
|
||
The new option `--ignore-ctime` makes restic look at `mtime` only, such that `ctime` changes
|
||
for a file does not cause restic to read the file's contents again.
|
||
|
||
The check for both `ctime` and `mtime` was introduced in restic 0.9.6 to make backups more
|
||
reliable in the face of programs that reset `mtime` (some Unix archivers do that), but it turned
|
||
out to often be expensive because it made restic read file contents even if only the metadata
|
||
(owner, permissions) of a file had changed. The new `--ignore-ctime` option lets the user
|
||
restore the 0.9.5 behavior when needed. The existing `--ignore-inode` option already turned
|
||
off this behavior, but also removed a different check.
|
||
|
||
Please note that changes in files' metadata are still recorded, regardless of the command line
|
||
options provided to the backup command.
|
||
|
||
https://github.com/restic/restic/issues/2495
|
||
https://github.com/restic/restic/issues/2558
|
||
https://github.com/restic/restic/issues/2819
|
||
https://github.com/restic/restic/pull/2823
|
||
|
||
* Enhancement #2941: Speed up the repacking step of the `prune` command
|
||
|
||
The repack step of the `prune` command, which moves still used file parts into new pack files
|
||
such that the old ones can be garbage collected later on, now processes multiple pack files in
|
||
parallel. This is especially beneficial for high latency backends or when using a fast network
|
||
connection.
|
||
|
||
https://github.com/restic/restic/pull/2941
|
||
|
||
* Enhancement #3006: Speed up the `rebuild-index` command
|
||
|
||
We've optimized the `rebuild-index` command. Now, existing index entries are used to
|
||
minimize the number of pack files that must be read. This speeds up the index rebuild a lot.
|
||
|
||
Additionally, the option `--read-all-packs` has been added, implementing the previous
|
||
behavior.
|
||
|
||
https://github.com/restic/restic/pull/3006
|
||
https://github.com/restic/restic/issue/2547
|
||
|
||
* Enhancement #3048: Add more checks for index and pack files in the `check` command
|
||
|
||
The `check` command run with the `--read-data` or `--read-data-subset` options used to only
|
||
verify only the pack file content - it did not check if the blobs within the pack are correctly
|
||
contained in the index.
|
||
|
||
A check for the latter is now in place, which can print the following error:
|
||
|
||
Blob ID is not contained in index or position is incorrect
|
||
|
||
Another test is also added, which compares pack file sizes computed from the index and the pack
|
||
header with the actual file size. This test is able to detect truncated pack files.
|
||
|
||
If the index is not correct, it can be rebuilt by using the `rebuild-index` command.
|
||
|
||
Having added these tests, `restic check` is now able to detect non-existing blobs which are
|
||
wrongly referenced in the index. This situation could have lead to missing data.
|
||
|
||
https://github.com/restic/restic/pull/3048
|
||
https://github.com/restic/restic/pull/3082
|
||
|
||
* Enhancement #2433: Make the `dump` command support `zip` format
|
||
|
||
Previously, restic could dump the contents of a whole folder structure only in the `tar`
|
||
format. The `dump` command now has a new flag to change output format to `zip`. Just pass
|
||
`--archive zip` as an option to `restic dump`.
|
||
|
||
https://github.com/restic/restic/pull/2433
|
||
https://github.com/restic/restic/pull/3081
|
||
|
||
* Enhancement #3099: Reduce memory usage of `check` command
|
||
|
||
The `check` command now requires less memory if it is run without the `--check-unused` option.
|
||
|
||
https://github.com/restic/restic/pull/3099
|
||
|
||
* Enhancement #3106: Parallelize scan of snapshot content in `copy` and `prune`
|
||
|
||
The `copy` and `prune` commands used to traverse the directories of snapshots one by one to find
|
||
used data. This snapshot traversal is now parallized which can speed up this step several
|
||
times.
|
||
|
||
In addition the `check` command now reports how many snapshots have already been processed.
|
||
|
||
https://github.com/restic/restic/pull/3106
|
||
|
||
* Enhancement #3130: Parallelize reading of locks and snapshots
|
||
|
||
Restic used to read snapshots sequentially. For repositories containing many snapshots this
|
||
slowed down commands which have to read all snapshots.
|
||
|
||
Now the reading of snapshots is parallelized. This speeds up for example `prune`, `backup` and
|
||
other commands that search for snapshots with certain properties or which have to find the
|
||
`latest` snapshot.
|
||
|
||
The speed up also applies to locks stored in the backup repository.
|
||
|
||
https://github.com/restic/restic/pull/3130
|
||
https://github.com/restic/restic/pull/3174
|
||
|
||
* Enhancement #3254: Enable HTTP/2 for backend connections
|
||
|
||
Go's HTTP library usually automatically chooses between HTTP/1.x and HTTP/2 depending on
|
||
what the server supports. But for compatibility this mechanism is disabled if DialContext is
|
||
used (which is the case for restic). This change allows restic's HTTP client to negotiate
|
||
HTTP/2 if supported by the server.
|
||
|
||
https://github.com/restic/restic/pull/3254
|
||
|
||
|
||
Changelog for restic 0.11.0 (2020-11-05)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.11.0 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1212: Restore timestamps and permissions on intermediate directories
|
||
* Fix #1756: Mark repository files as read-only when using the local backend
|
||
* Fix #2241: Hide password in REST backend repository URLs
|
||
* Fix #2319: Correctly dump directories into tar files
|
||
* Fix #2491: Don't require `self-update --output` placeholder file
|
||
* Fix #2834: Fix rare cases of backup command hanging forever
|
||
* Fix #2938: Fix manpage formatting
|
||
* Fix #2942: Make --exclude-larger-than handle disappearing files
|
||
* Fix #2951: Restic generate, help and self-update no longer check passwords
|
||
* Fix #2979: Make snapshots --json output [] instead of null when no snapshots
|
||
* Enh #2969: Optimize check for unchanged files during backup
|
||
* Enh #340: Add support for Volume Shadow Copy Service (VSS) on Windows
|
||
* Enh #2849: Authenticate to Google Cloud Storage with access token
|
||
* Enh #1458: New option --repository-file
|
||
* Enh #2978: Warn if parent snapshot cannot be loaded during backup
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1212: Restore timestamps and permissions on intermediate directories
|
||
|
||
When using the `--include` option of the restore command, restic restored timestamps and
|
||
permissions only on directories selected by the include pattern. Intermediate directories,
|
||
which are necessary to restore files located in sub- directories, were created with default
|
||
permissions. We've fixed the restore command to restore timestamps and permissions for these
|
||
directories as well.
|
||
|
||
https://github.com/restic/restic/issues/1212
|
||
https://github.com/restic/restic/issues/1402
|
||
https://github.com/restic/restic/pull/2906
|
||
|
||
* Bugfix #1756: Mark repository files as read-only when using the local backend
|
||
|
||
Files stored in a local repository were marked as writeable on the filesystem for non-Windows
|
||
systems, which did not prevent accidental file modifications outside of restic. In addition,
|
||
the local backend did not work with certain filesystems and network mounts which do not permit
|
||
modifications of file permissions.
|
||
|
||
Restic now marks files stored in a local repository as read-only on the filesystem on
|
||
non-Windows systems. The error handling is improved to support more filesystems.
|
||
|
||
https://github.com/restic/restic/issues/1756
|
||
https://github.com/restic/restic/issues/2157
|
||
https://github.com/restic/restic/pull/2989
|
||
|
||
* Bugfix #2241: Hide password in REST backend repository URLs
|
||
|
||
When using a password in the REST backend repository URL, the password could in some cases be
|
||
included in the output from restic, e.g. when initializing a repo or during an error.
|
||
|
||
The password is now replaced with "***" where applicable.
|
||
|
||
https://github.com/restic/restic/issues/2241
|
||
https://github.com/restic/restic/pull/2658
|
||
|
||
* Bugfix #2319: Correctly dump directories into tar files
|
||
|
||
The dump command previously wrote directories in a tar file in a way which can cause
|
||
compatibility problems. This caused, for example, 7zip on Windows to not open tar files
|
||
containing directories. In addition it was not possible to dump directories with extended
|
||
attributes. These compatibility problems are now corrected.
|
||
|
||
In addition, a tar file now includes the name of the owner and group of a file.
|
||
|
||
https://github.com/restic/restic/issues/2319
|
||
https://github.com/restic/restic/pull/3039
|
||
|
||
* Bugfix #2491: Don't require `self-update --output` placeholder file
|
||
|
||
`restic self-update --output /path/to/new-restic` used to require that new-restic was an
|
||
existing file, to be overwritten. Now it's possible to download an updated restic binary to a
|
||
new path, without first having to create a placeholder file.
|
||
|
||
https://github.com/restic/restic/issues/2491
|
||
https://github.com/restic/restic/pull/2937
|
||
|
||
* Bugfix #2834: Fix rare cases of backup command hanging forever
|
||
|
||
We've fixed an issue with the backup progress reporting which could cause restic to hang
|
||
forever right before finishing a backup.
|
||
|
||
https://github.com/restic/restic/issues/2834
|
||
https://github.com/restic/restic/pull/2963
|
||
|
||
* Bugfix #2938: Fix manpage formatting
|
||
|
||
The manpage formatting in restic v0.10.0 was garbled, which is fixed now.
|
||
|
||
https://github.com/restic/restic/issues/2938
|
||
https://github.com/restic/restic/pull/2977
|
||
|
||
* Bugfix #2942: Make --exclude-larger-than handle disappearing files
|
||
|
||
There was a small bug in the backup command's --exclude-larger-than option where files that
|
||
disappeared between scanning and actually backing them up to the repository caused a panic.
|
||
This is now fixed.
|
||
|
||
https://github.com/restic/restic/issues/2942
|
||
|
||
* Bugfix #2951: Restic generate, help and self-update no longer check passwords
|
||
|
||
The commands `restic cache`, `generate`, `help` and `self-update` don't need passwords, but
|
||
they previously did run the RESTIC_PASSWORD_COMMAND (if set in the environment), prompting
|
||
users to authenticate for no reason. They now skip running the password command.
|
||
|
||
https://github.com/restic/restic/issues/2951
|
||
https://github.com/restic/restic/pull/2987
|
||
|
||
* Bugfix #2979: Make snapshots --json output [] instead of null when no snapshots
|
||
|
||
Restic previously output `null` instead of `[]` for the `--json snapshots` command, when
|
||
there were no snapshots in the repository. This caused some minor problems when parsing the
|
||
output, but is now fixed such that `[]` is output when the list of snapshots is empty.
|
||
|
||
https://github.com/restic/restic/issues/2979
|
||
https://github.com/restic/restic/pull/2984
|
||
|
||
* Enhancement #2969: Optimize check for unchanged files during backup
|
||
|
||
During a backup restic skips processing files which have not changed since the last backup run.
|
||
Previously this required opening each file once which can be slow on network filesystems. The
|
||
backup command now checks for file changes before opening a file. This considerably reduces
|
||
the time to create a backup on network filesystems.
|
||
|
||
https://github.com/restic/restic/issues/2969
|
||
https://github.com/restic/restic/pull/2970
|
||
|
||
* Enhancement #340: Add support for Volume Shadow Copy Service (VSS) on Windows
|
||
|
||
Volume Shadow Copy Service allows read access to files that are locked by another process using
|
||
an exclusive lock through a filesystem snapshot. Restic was unable to backup those files
|
||
before. This update enables backing up these files.
|
||
|
||
This needs to be enabled explicitely using the --use-fs-snapshot option of the backup
|
||
command.
|
||
|
||
https://github.com/restic/restic/issues/340
|
||
https://github.com/restic/restic/pull/2274
|
||
|
||
* Enhancement #2849: Authenticate to Google Cloud Storage with access token
|
||
|
||
When using the GCS backend, it is now possible to authenticate with OAuth2 access tokens
|
||
instead of a credentials file by setting the GOOGLE_ACCESS_TOKEN environment variable.
|
||
|
||
https://github.com/restic/restic/pull/2849
|
||
|
||
* Enhancement #1458: New option --repository-file
|
||
|
||
We've added a new command-line option --repository-file as an alternative to -r. This allows
|
||
to read the repository URL from a file in order to prevent certain types of information leaks,
|
||
especially for URLs containing credentials.
|
||
|
||
https://github.com/restic/restic/issues/1458
|
||
https://github.com/restic/restic/issues/2900
|
||
https://github.com/restic/restic/pull/2910
|
||
|
||
* Enhancement #2978: Warn if parent snapshot cannot be loaded during backup
|
||
|
||
During a backup restic uses the parent snapshot to check whether a file was changed and has to be
|
||
backed up again. For this check the backup has to read the directories contained in the old
|
||
snapshot. If a tree blob cannot be loaded, restic now warns about this problem with the backup
|
||
repository.
|
||
|
||
https://github.com/restic/restic/pull/2978
|
||
|
||
|
||
Changelog for restic 0.10.0 (2020-09-19)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.10.0 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1863: Report correct number of directories processed by backup
|
||
* Fix #2254: Fix tar issues when dumping `/`
|
||
* Fix #2281: Handle format verbs like '%' properly in `find` output
|
||
* Fix #2298: Do not hang when run as a background job
|
||
* Fix #2389: Fix mangled json output of backup command
|
||
* Fix #2390: Refresh lock timestamp
|
||
* Fix #2429: Backup --json reports total_bytes_processed as 0
|
||
* Fix #2469: Fix incorrect bytes stats in `diff` command
|
||
* Fix #2518: Do not crash with Synology NAS sftp server
|
||
* Fix #2531: Fix incorrect size calculation in `stats --mode restore-size`
|
||
* Fix #2537: Fix incorrect file counts in `stats --mode restore-size`
|
||
* Fix #2592: SFTP backend supports IPv6 addresses
|
||
* Fix #2607: Honor RESTIC_CACHE_DIR environment variable on Mac and Windows
|
||
* Fix #2668: Don't abort the stats command when data blobs are missing
|
||
* Fix #2674: Add stricter prune error checks
|
||
* Fix #2899: Fix possible crash in the progress bar of check --read-data
|
||
* Chg #2482: Remove vendored dependencies
|
||
* Chg #2546: Return exit code 3 when failing to backup all source data
|
||
* Chg #2600: Update dependencies, require Go >= 1.13
|
||
* Chg #1597: Honor the --no-lock flag in the mount command
|
||
* Enh #1570: Support specifying multiple host flags for various commands
|
||
* Enh #1680: Optimize `restic mount`
|
||
* Enh #2072: Display snapshot date when using `restic find`
|
||
* Enh #2175: Allow specifying user and host when creating keys
|
||
* Enh #2277: Add support for ppc64le
|
||
* Enh #2395: Ignore sync errors when operation not supported by local filesystem
|
||
* Enh #2427: Add flag `--iexclude-file` to backup command
|
||
* Enh #2569: Support excluding files by their size
|
||
* Enh #2571: Self-heal missing file parts during backup of unchanged files
|
||
* Enh #2858: Support filtering snapshots by tag and path in the stats command
|
||
* Enh #323: Add command for copying snapshots between repositories
|
||
* Enh #551: Use optimized library for hash calculation of file chunks
|
||
* Enh #2195: Simplify and improve restore performance
|
||
* Enh #2328: Improve speed of check command
|
||
* Enh #2423: Support user@domain parsing as user
|
||
* Enh #2576: Improve the chunking algorithm
|
||
* Enh #2598: Improve speed of diff command
|
||
* Enh #2599: Slightly reduce memory usage of prune and stats commands
|
||
* Enh #2733: S3 backend: Add support for WebIdentityTokenFile
|
||
* Enh #2773: Optimize handling of new index entries
|
||
* Enh #2781: Reduce memory consumption of in-memory index
|
||
* Enh #2786: Optimize `list blobs` command
|
||
* Enh #2790: Optimized file access in restic mount
|
||
* Enh #2840: Speed-up file deletion in forget, prune and rebuild-index
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1863: Report correct number of directories processed by backup
|
||
|
||
The directory statistics calculation was fixed to report the actual number of processed
|
||
directories instead of always zero.
|
||
|
||
https://github.com/restic/restic/issues/1863
|
||
|
||
* Bugfix #2254: Fix tar issues when dumping `/`
|
||
|
||
We've fixed an issue with dumping either `/` or files on the first sublevel e.g. `/foo` to tar.
|
||
This also fixes tar dumping issues on Windows where this issue could also happen.
|
||
|
||
https://github.com/restic/restic/issues/2254
|
||
https://github.com/restic/restic/issues/2357
|
||
https://github.com/restic/restic/pull/2255
|
||
|
||
* Bugfix #2281: Handle format verbs like '%' properly in `find` output
|
||
|
||
The JSON or "normal" output of the `find` command can now deal with file names that contain
|
||
substrings which the Golang `fmt` package considers "format verbs" like `%s`.
|
||
|
||
https://github.com/restic/restic/issues/2281
|
||
|
||
* Bugfix #2298: Do not hang when run as a background job
|
||
|
||
Restic did hang on exit while restoring the terminal configuration when it was started as a
|
||
background job, for example using `restic ... &`. This has been fixed by only restoring the
|
||
terminal configuration when restic is interrupted while reading a password from the
|
||
terminal.
|
||
|
||
https://github.com/restic/restic/issues/2298
|
||
|
||
* Bugfix #2389: Fix mangled json output of backup command
|
||
|
||
We've fixed a race condition in the json output of the backup command that could cause multiple
|
||
lines to get mixed up. We've also ensured that the backup summary is printed last.
|
||
|
||
https://github.com/restic/restic/issues/2389
|
||
https://github.com/restic/restic/pull/2545
|
||
|
||
* Bugfix #2390: Refresh lock timestamp
|
||
|
||
Long-running operations did not refresh lock timestamp, resulting in locks becoming stale.
|
||
This is now fixed.
|
||
|
||
https://github.com/restic/restic/issues/2390
|
||
|
||
* Bugfix #2429: Backup --json reports total_bytes_processed as 0
|
||
|
||
We've fixed the json output of total_bytes_processed. The non-json output was already fixed
|
||
with pull request #2138 but left the json output untouched.
|
||
|
||
https://github.com/restic/restic/issues/2429
|
||
|
||
* Bugfix #2469: Fix incorrect bytes stats in `diff` command
|
||
|
||
In some cases, the wrong number of bytes (e.g. 16777215.998 TiB) were reported by the `diff`
|
||
command. This is now fixed.
|
||
|
||
https://github.com/restic/restic/issues/2469
|
||
|
||
* Bugfix #2518: Do not crash with Synology NAS sftp server
|
||
|
||
It was found that when restic is used to store data on an sftp server on a Synology NAS with a
|
||
relative path (one which does not start with a slash), it may go into an endless loop trying to
|
||
create directories on the server. We've fixed this bug by using a function in the sftp library
|
||
instead of our own implementation.
|
||
|
||
The bug was discovered because the Synology sftp server behaves erratic with non-absolute
|
||
path (e.g. `home/restic-repo`). This can be resolved by just using an absolute path instead
|
||
(`/home/restic-repo`). We've also added a paragraph in the FAQ.
|
||
|
||
https://github.com/restic/restic/issues/2518
|
||
https://github.com/restic/restic/issues/2363
|
||
https://github.com/restic/restic/pull/2530
|
||
|
||
* Bugfix #2531: Fix incorrect size calculation in `stats --mode restore-size`
|
||
|
||
The restore-size mode of stats was counting hard-linked files as if they were independent.
|
||
|
||
https://github.com/restic/restic/issues/2531
|
||
|
||
* Bugfix #2537: Fix incorrect file counts in `stats --mode restore-size`
|
||
|
||
The restore-size mode of stats was failing to count empty directories and some files with hard
|
||
links.
|
||
|
||
https://github.com/restic/restic/issues/2537
|
||
|
||
* Bugfix #2592: SFTP backend supports IPv6 addresses
|
||
|
||
The SFTP backend now supports IPv6 addresses natively, without relying on aliases in the
|
||
external SSH configuration.
|
||
|
||
https://github.com/restic/restic/pull/2592
|
||
|
||
* Bugfix #2607: Honor RESTIC_CACHE_DIR environment variable on Mac and Windows
|
||
|
||
On Mac and Windows, the RESTIC_CACHE_DIR environment variable was ignored. This variable can
|
||
now be used on all platforms to set the directory where restic stores caches.
|
||
|
||
https://github.com/restic/restic/pull/2607
|
||
|
||
* Bugfix #2668: Don't abort the stats command when data blobs are missing
|
||
|
||
Runing the stats command in the blobs-per-file mode on a repository with missing data blobs
|
||
previously resulted in a crash.
|
||
|
||
https://github.com/restic/restic/pull/2668
|
||
|
||
* Bugfix #2674: Add stricter prune error checks
|
||
|
||
Additional checks were added to the prune command in order to improve resiliency to backend,
|
||
hardware and/or networking issues. The checks now detect a few more cases where such outside
|
||
factors could potentially cause data loss.
|
||
|
||
https://github.com/restic/restic/pull/2674
|
||
|
||
* Bugfix #2899: Fix possible crash in the progress bar of check --read-data
|
||
|
||
We've fixed a possible crash while displaying the progress bar for the check --read-data
|
||
command. The crash occurred when the length of the progress bar status exceeded the terminal
|
||
width, which only happened for very narrow terminal windows.
|
||
|
||
https://github.com/restic/restic/pull/2899
|
||
https://forum.restic.net/t/restic-rclone-pcloud-connection-issues/2963/15
|
||
|
||
* Change #2482: Remove vendored dependencies
|
||
|
||
We've removed the vendored dependencies (in the subdir `vendor/`). When building restic, the
|
||
Go compiler automatically fetches the dependencies. It will also cryptographically verify
|
||
that the correct code has been fetched by using the hashes in `go.sum` (see the link to the
|
||
documentation below).
|
||
|
||
https://github.com/restic/restic/issues/2482
|
||
https://golang.org/cmd/go/#hdr-Module_downloading_and_verification
|
||
|
||
* Change #2546: Return exit code 3 when failing to backup all source data
|
||
|
||
The backup command used to return a zero exit code as long as a snapshot could be created
|
||
successfully, even if some of the source files could not be read (in which case the snapshot
|
||
would contain the rest of the files).
|
||
|
||
This made it hard for automation/scripts to detect failures/incomplete backups by looking at
|
||
the exit code. Restic now returns the following exit codes for the backup command:
|
||
|
||
- 0 when the command was successful - 1 when there was a fatal error (no snapshot created) - 3 when
|
||
some source data could not be read (incomplete snapshot created)
|
||
|
||
https://github.com/restic/restic/issues/956
|
||
https://github.com/restic/restic/issues/2064
|
||
https://github.com/restic/restic/issues/2526
|
||
https://github.com/restic/restic/issues/2364
|
||
https://github.com/restic/restic/pull/2546
|
||
|
||
* Change #2600: Update dependencies, require Go >= 1.13
|
||
|
||
Restic now requires Go to be at least 1.13. This allows simplifications in the build process and
|
||
removing workarounds.
|
||
|
||
This is also probably the last version of restic still supporting mounting repositories via
|
||
fuse on macOS. The library we're using for fuse does not support macOS any more and osxfuse is not
|
||
open source any more.
|
||
|
||
https://github.com/bazil/fuse/issues/224
|
||
https://github.com/osxfuse/osxfuse/issues/590
|
||
https://github.com/restic/restic/pull/2600
|
||
https://github.com/restic/restic/pull/2852
|
||
https://github.com/restic/restic/pull/2927
|
||
|
||
* Change #1597: Honor the --no-lock flag in the mount command
|
||
|
||
The mount command now does not lock the repository if given the --no-lock flag. This allows to
|
||
mount repositories which are archived on a read only backend/filesystem.
|
||
|
||
https://github.com/restic/restic/issues/1597
|
||
https://github.com/restic/restic/pull/2821
|
||
|
||
* Enhancement #1570: Support specifying multiple host flags for various commands
|
||
|
||
Previously commands didn't take more than one `--host` or `-H` argument into account, which
|
||
could be limiting with e.g. the `forget` command.
|
||
|
||
The `dump`, `find`, `forget`, `ls`, `mount`, `restore`, `snapshots`, `stats` and `tag`
|
||
commands will now take into account multiple `--host` and `-H` flags.
|
||
|
||
https://github.com/restic/restic/issues/1570
|
||
|
||
* Enhancement #1680: Optimize `restic mount`
|
||
|
||
We've optimized the FUSE implementation used within restic. `restic mount` is now more
|
||
responsive and uses less memory.
|
||
|
||
https://github.com/restic/restic/issues/1680
|
||
https://github.com/restic/restic/pull/2587
|
||
https://github.com/restic/restic/pull/2787
|
||
|
||
* Enhancement #2072: Display snapshot date when using `restic find`
|
||
|
||
Added the respective snapshot date to the output of `restic find`.
|
||
|
||
https://github.com/restic/restic/issues/2072
|
||
|
||
* Enhancement #2175: Allow specifying user and host when creating keys
|
||
|
||
When adding a new key to the repository, the username and hostname for the new key can be
|
||
specified on the command line. This allows overriding the defaults, for example if you would
|
||
prefer to use the FQDN to identify the host or if you want to add keys for several different hosts
|
||
without having to run the key add command on those hosts.
|
||
|
||
https://github.com/restic/restic/issues/2175
|
||
|
||
* Enhancement #2277: Add support for ppc64le
|
||
|
||
Adds support for ppc64le, the processor architecture from IBM.
|
||
|
||
https://github.com/restic/restic/issues/2277
|
||
|
||
* Enhancement #2395: Ignore sync errors when operation not supported by local filesystem
|
||
|
||
The local backend has been modified to work with filesystems which doesn't support the `sync`
|
||
operation. This operation is normally used by restic to ensure that data files are fully
|
||
written to disk before continuing.
|
||
|
||
For these limited filesystems, saving a file in the backend would previously fail with an
|
||
"operation not supported" error. This error is now ignored, which means that e.g. an SMB mount
|
||
on macOS can now be used as storage location for a repository.
|
||
|
||
https://github.com/restic/restic/issues/2395
|
||
https://forum.restic.net/t/sync-errors-on-mac-over-smb/1859
|
||
|
||
* Enhancement #2427: Add flag `--iexclude-file` to backup command
|
||
|
||
The backup command now supports the flag `--iexclude-file` which is a case-insensitive
|
||
version of `--exclude-file`.
|
||
|
||
https://github.com/restic/restic/issues/2427
|
||
https://github.com/restic/restic/pull/2898
|
||
|
||
* Enhancement #2569: Support excluding files by their size
|
||
|
||
The `backup` command now supports the `--exclude-larger-than` option to exclude files which
|
||
are larger than the specified maximum size. This can for example be useful to exclude
|
||
unimportant files with a large file size.
|
||
|
||
https://github.com/restic/restic/issues/2569
|
||
https://github.com/restic/restic/pull/2914
|
||
|
||
* Enhancement #2571: Self-heal missing file parts during backup of unchanged files
|
||
|
||
We've improved the resilience of restic to certain types of repository corruption.
|
||
|
||
For files that are unchanged since the parent snapshot, the backup command now verifies that
|
||
all parts of the files still exist in the repository. Parts that are missing, e.g. from a damaged
|
||
repository, are backed up again. This verification was already run for files that were
|
||
modified since the parent snapshot, but is now also done for unchanged files.
|
||
|
||
Note that restic will not backup file parts that are referenced in the index but where the actual
|
||
data is not present on disk, as this situation can only be detected by restic check. Please
|
||
ensure that you run `restic check` regularly.
|
||
|
||
https://github.com/restic/restic/issues/2571
|
||
https://github.com/restic/restic/pull/2827
|
||
|
||
* Enhancement #2858: Support filtering snapshots by tag and path in the stats command
|
||
|
||
We've added filtering snapshots by `--tag tagList` and by `--path path` to the `stats`
|
||
command. This includes filtering of only 'latest' snapshots or all snapshots in a repository.
|
||
|
||
https://github.com/restic/restic/issues/2858
|
||
https://github.com/restic/restic/pull/2859
|
||
https://forum.restic.net/t/stats-for-a-host-and-filtered-snapshots/3020
|
||
|
||
* Enhancement #323: Add command for copying snapshots between repositories
|
||
|
||
We've added a copy command, allowing you to copy snapshots from one repository to another.
|
||
|
||
Note that this process will have to read (download) and write (upload) the entire snapshot(s)
|
||
due to the different encryption keys used on the source and destination repository. Also, the
|
||
transferred files are not re-chunked, which may break deduplication between files already
|
||
stored in the destination repo and files copied there using this command.
|
||
|
||
To fully support deduplication between repositories when the copy command is used, the init
|
||
command now supports the `--copy-chunker-params` option, which initializes the new
|
||
repository with identical parameters for splitting files into chunks as an already existing
|
||
repository. This allows copied snapshots to be equally deduplicated in both repositories.
|
||
|
||
https://github.com/restic/restic/issues/323
|
||
https://github.com/restic/restic/pull/2606
|
||
https://github.com/restic/restic/pull/2928
|
||
|
||
* Enhancement #551: Use optimized library for hash calculation of file chunks
|
||
|
||
We've switched the library used to calculate the hashes of file chunks, which are used for
|
||
deduplication, to the optimized Minio SHA-256 implementation.
|
||
|
||
Depending on the CPU it improves the hashing throughput by 10-30%. Modern x86 CPUs with the SHA
|
||
Extension should be about two to three times faster.
|
||
|
||
https://github.com/restic/restic/issues/551
|
||
https://github.com/restic/restic/pull/2709
|
||
|
||
* Enhancement #2195: Simplify and improve restore performance
|
||
|
||
Significantly improves restore performance of large files (i.e. 50M+):
|
||
https://github.com/restic/restic/issues/2074
|
||
https://forum.restic.net/t/restore-using-rclone-gdrive-backend-is-slow/1112/8
|
||
https://forum.restic.net/t/degraded-restore-performance-s3-backend/1400
|
||
|
||
Fixes "not enough cache capacity" error during restore:
|
||
https://github.com/restic/restic/issues/2244
|
||
|
||
NOTE: This new implementation does not guarantee order in which blobs are written to the target
|
||
files and, for example, the last blob of a file can be written to the file before any of the
|
||
preceeding file blobs. It is therefore possible to have gaps in the data written to the target
|
||
files if restore fails or interrupted by the user.
|
||
|
||
The implementation will try to preallocate space for the restored files on the filesystem to
|
||
prevent file fragmentation. This ensures good read performance for large files, like for
|
||
example VM images. If preallocating space is not supported by the filesystem, then this step is
|
||
silently skipped.
|
||
|
||
https://github.com/restic/restic/pull/2195
|
||
https://github.com/restic/restic/pull/2893
|
||
|
||
* Enhancement #2328: Improve speed of check command
|
||
|
||
We've improved the check command to traverse trees only once independent of whether they are
|
||
contained in multiple snapshots. The check command is now much faster for repositories with a
|
||
large number of snapshots.
|
||
|
||
https://github.com/restic/restic/issues/2284
|
||
https://github.com/restic/restic/pull/2328
|
||
|
||
* Enhancement #2423: Support user@domain parsing as user
|
||
|
||
Added the ability for user@domain-like users to be authenticated over SFTP servers.
|
||
|
||
https://github.com/restic/restic/pull/2423
|
||
|
||
* Enhancement #2576: Improve the chunking algorithm
|
||
|
||
We've updated the chunker library responsible for splitting files into smaller blocks. It
|
||
should improve the chunking throughput by 5-15% depending on the CPU.
|
||
|
||
https://github.com/restic/restic/issues/2820
|
||
https://github.com/restic/restic/pull/2576
|
||
https://github.com/restic/restic/pull/2845
|
||
|
||
* Enhancement #2598: Improve speed of diff command
|
||
|
||
We've improved the performance of the diff command when comparing snapshots with similar
|
||
content. It should run up to twice as fast as before.
|
||
|
||
https://github.com/restic/restic/pull/2598
|
||
|
||
* Enhancement #2599: Slightly reduce memory usage of prune and stats commands
|
||
|
||
The prune and the stats command kept directory identifiers in memory twice while searching for
|
||
used blobs.
|
||
|
||
https://github.com/restic/restic/pull/2599
|
||
|
||
* Enhancement #2733: S3 backend: Add support for WebIdentityTokenFile
|
||
|
||
We've added support for EKS IAM roles for service accounts feature to the S3 backend.
|
||
|
||
https://github.com/restic/restic/issues/2703
|
||
https://github.com/restic/restic/pull/2733
|
||
|
||
* Enhancement #2773: Optimize handling of new index entries
|
||
|
||
Restic now uses less memory for backups which add a lot of data, e.g. large initial backups. In
|
||
addition, we've improved the stability in some edge cases.
|
||
|
||
https://github.com/restic/restic/pull/2773
|
||
|
||
* Enhancement #2781: Reduce memory consumption of in-memory index
|
||
|
||
We've improved how the index is stored in memory. This change can reduce memory usage for large
|
||
repositories by up to 50% (depending on the operation).
|
||
|
||
https://github.com/restic/restic/pull/2781
|
||
https://github.com/restic/restic/pull/2812
|
||
|
||
* Enhancement #2786: Optimize `list blobs` command
|
||
|
||
We've changed the implementation of `list blobs` which should be now a bit faster and consume
|
||
almost no memory even for large repositories.
|
||
|
||
https://github.com/restic/restic/pull/2786
|
||
|
||
* Enhancement #2790: Optimized file access in restic mount
|
||
|
||
Reading large (> 100GiB) files from restic mountpoints is now faster, and the speedup is
|
||
greater for larger files.
|
||
|
||
https://github.com/restic/restic/pull/2790
|
||
|
||
* Enhancement #2840: Speed-up file deletion in forget, prune and rebuild-index
|
||
|
||
We've sped up the file deletion for the commands forget, prune and rebuild-index, especially
|
||
for remote repositories. Deletion was sequential before and is now run in parallel.
|
||
|
||
https://github.com/restic/restic/pull/2840
|
||
|
||
|
||
Changelog for restic 0.9.6 (2019-11-22)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.9.6 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #2063: Allow absolute path for filename when backing up from stdin
|
||
* Fix #2174: Save files with invalid timestamps
|
||
* Fix #2249: Read fresh metadata for unmodified files
|
||
* Fix #2301: Add upper bound for t in --read-data-subset=n/t
|
||
* Fix #2321: Check errors when loading index files
|
||
* Enh #2179: Use ctime when checking for file changes
|
||
* Enh #2306: Allow multiple retries for interactive password input
|
||
* Enh #2330: Make `--group-by` accept both singular and plural
|
||
* Enh #2350: Add option to configure S3 region
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #2063: Allow absolute path for filename when backing up from stdin
|
||
|
||
When backing up from stdin, handle directory path for `--stdin-filename`. This can be used to
|
||
specify the full path for the backed-up file.
|
||
|
||
https://github.com/restic/restic/issues/2063
|
||
|
||
* Bugfix #2174: Save files with invalid timestamps
|
||
|
||
When restic reads invalid timestamps (year is before 0000 or after 9999) it refused to read and
|
||
archive the file. We've changed the behavior and will now save modified timestamps with the
|
||
year set to either 0000 or 9999, the rest of the timestamp stays the same, so the file will be saved
|
||
(albeit with a bogus timestamp).
|
||
|
||
https://github.com/restic/restic/issues/2174
|
||
https://github.com/restic/restic/issues/1173
|
||
|
||
* Bugfix #2249: Read fresh metadata for unmodified files
|
||
|
||
Restic took all metadata for files which were detected as unmodified, not taking into account
|
||
changed metadata (ownership, mode). This is now corrected.
|
||
|
||
https://github.com/restic/restic/issues/2249
|
||
https://github.com/restic/restic/pull/2252
|
||
|
||
* Bugfix #2301: Add upper bound for t in --read-data-subset=n/t
|
||
|
||
256 is the effective maximum for t, but restic would allow larger values, leading to strange
|
||
behavior.
|
||
|
||
https://github.com/restic/restic/issues/2301
|
||
https://github.com/restic/restic/pull/2304
|
||
|
||
* Bugfix #2321: Check errors when loading index files
|
||
|
||
Restic now checks and handles errors which occur when loading index files, the missing check
|
||
leads to odd errors (and a stack trace printed to users) later. This was reported in the forum.
|
||
|
||
https://github.com/restic/restic/pull/2321
|
||
https://forum.restic.net/t/check-rebuild-index-prune/1848/13
|
||
|
||
* Enhancement #2179: Use ctime when checking for file changes
|
||
|
||
Previously, restic only checked a file's mtime (along with other non-timestamp metadata) to
|
||
decide if a file has changed. This could cause restic to not notice that a file has changed (and
|
||
therefore continue to store the old version, as opposed to the modified version) if something
|
||
edits the file and then resets the timestamp. Restic now also checks the ctime of files, so any
|
||
modifications to a file should be noticed, and the modified file will be backed up. The ctime
|
||
check will be disabled if the --ignore-inode flag was given.
|
||
|
||
If this change causes problems for you, please open an issue, and we can look in to adding a
|
||
seperate flag to disable just the ctime check.
|
||
|
||
https://github.com/restic/restic/issues/2179
|
||
https://github.com/restic/restic/pull/2212
|
||
|
||
* Enhancement #2306: Allow multiple retries for interactive password input
|
||
|
||
Restic used to quit if the repository password was typed incorrectly once. Restic will now ask
|
||
the user again for the repository password if typed incorrectly. The user will now get three
|
||
tries to input the correct password before restic quits.
|
||
|
||
https://github.com/restic/restic/issues/2306
|
||
|
||
* Enhancement #2330: Make `--group-by` accept both singular and plural
|
||
|
||
One can now use the values `host`/`hosts`, `path`/`paths` and `tag` / `tags` interchangeably
|
||
in the `--group-by` argument.
|
||
|
||
https://github.com/restic/restic/issues/2330
|
||
|
||
* Enhancement #2350: Add option to configure S3 region
|
||
|
||
We've added a new option for setting the region when accessing an S3-compatible service. For
|
||
some providers, it is required to set this to a valid value. You can do that either by setting the
|
||
environment variable `AWS_DEFAULT_REGION` or using the option `s3.region`, e.g. like this:
|
||
`-o s3.region="us-east-1"`.
|
||
|
||
https://github.com/restic/restic/pull/2350
|
||
|
||
|
||
Changelog for restic 0.9.5 (2019-04-23)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.9.5 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #2135: Return error when no bytes could be read from stdin
|
||
* Fix #2181: Don't cancel timeout after 30 seconds for self-update
|
||
* Fix #2203: Fix reading passwords from stdin
|
||
* Fix #2224: Don't abort the find command when a tree can't be loaded
|
||
* Enh #1895: Add case insensitive include & exclude options
|
||
* Enh #1937: Support streaming JSON output for backup
|
||
* Enh #2155: Add Openstack application credential auth for Swift
|
||
* Enh #2184: Add --json support to forget command
|
||
* Enh #2037: Add group-by option to snapshots command
|
||
* Enh #2124: Ability to dump folders to tar via stdout
|
||
* Enh #2139: Return error if no bytes could be read for `backup --stdin`
|
||
* Enh #2205: Add --ignore-inode option to backup cmd
|
||
* Enh #2220: Add config option to set S3 storage class
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #2135: Return error when no bytes could be read from stdin
|
||
|
||
We assume that users reading backup data from stdin want to know when no data could be read, so now
|
||
restic returns an error when `backup --stdin` is called but no bytes could be read. Usually,
|
||
this means that an earlier command in a pipe has failed. The documentation was amended and now
|
||
recommends setting the `pipefail` option (`set -o pipefail`).
|
||
|
||
https://github.com/restic/restic/pull/2135
|
||
https://github.com/restic/restic/pull/2139
|
||
|
||
* Bugfix #2181: Don't cancel timeout after 30 seconds for self-update
|
||
|
||
https://github.com/restic/restic/issues/2181
|
||
|
||
* Bugfix #2203: Fix reading passwords from stdin
|
||
|
||
Passwords for the `init`, `key add`, and `key passwd` commands can now be read from
|
||
non-terminal stdin.
|
||
|
||
https://github.com/restic/restic/issues/2203
|
||
|
||
* Bugfix #2224: Don't abort the find command when a tree can't be loaded
|
||
|
||
Change the find command so that missing trees don't result in a crash. Instead, the error is
|
||
logged to the debug log, and the tree ID is displayed along with the snapshot it belongs to. This
|
||
makes it possible to recover repositories that are missing trees by forgetting the snapshots
|
||
they are used in.
|
||
|
||
https://github.com/restic/restic/issues/2224
|
||
|
||
* Enhancement #1895: Add case insensitive include & exclude options
|
||
|
||
The backup and restore commands now have --iexclude and --iinclude flags as case insensitive
|
||
variants of --exclude and --include.
|
||
|
||
https://github.com/restic/restic/issues/1895
|
||
https://github.com/restic/restic/pull/2032
|
||
|
||
* Enhancement #1937: Support streaming JSON output for backup
|
||
|
||
We've added support for getting machine-readable status output during backup, just pass the
|
||
flag `--json` for `restic backup` and restic will output a stream of JSON objects which contain
|
||
the current progress.
|
||
|
||
https://github.com/restic/restic/issues/1937
|
||
https://github.com/restic/restic/pull/1944
|
||
|
||
* Enhancement #2155: Add Openstack application credential auth for Swift
|
||
|
||
Since Openstack Queens Identity (auth V3) service supports an application credential auth
|
||
method. It allows to create a technical account with the limited roles. This commit adds an
|
||
application credential authentication method for the Swift backend.
|
||
|
||
https://github.com/restic/restic/issues/2155
|
||
|
||
* Enhancement #2184: Add --json support to forget command
|
||
|
||
The forget command now supports the --json argument, outputting the information about what is
|
||
(or would-be) kept and removed from the repository.
|
||
|
||
https://github.com/restic/restic/issues/2184
|
||
https://github.com/restic/restic/pull/2185
|
||
|
||
* Enhancement #2037: Add group-by option to snapshots command
|
||
|
||
We have added an option to group the output of the snapshots command, similar to the output of the
|
||
forget command. The option has been called "--group-by" and accepts any combination of the
|
||
values "host", "paths" and "tags", separated by commas. Default behavior (not specifying
|
||
--group-by) has not been changed. We have added support of the grouping to the JSON output.
|
||
|
||
https://github.com/restic/restic/issues/2037
|
||
https://github.com/restic/restic/pull/2087
|
||
|
||
* Enhancement #2124: Ability to dump folders to tar via stdout
|
||
|
||
We've added the ability to dump whole folders to stdout via the `dump` command. Restic now
|
||
requires at least Go 1.10 due to a limitation of the standard library for Go <= 1.9.
|
||
|
||
https://github.com/restic/restic/issues/2123
|
||
https://github.com/restic/restic/pull/2124
|
||
|
||
* Enhancement #2139: Return error if no bytes could be read for `backup --stdin`
|
||
|
||
When restic is used to backup the output of a program, like `mysqldump | restic backup --stdin`,
|
||
it now returns an error if no bytes could be read at all. This catches the failure case when
|
||
`mysqldump` failed for some reason and did not output any data to stdout.
|
||
|
||
https://github.com/restic/restic/pull/2139
|
||
|
||
* Enhancement #2205: Add --ignore-inode option to backup cmd
|
||
|
||
This option handles backup of virtual filesystems that do not keep fixed inodes for files, like
|
||
Fuse-based, pCloud, etc. Ignoring inode changes allows to consider the file as unchanged if
|
||
last modification date and size are unchanged.
|
||
|
||
https://github.com/restic/restic/issues/1631
|
||
https://github.com/restic/restic/pull/2205
|
||
https://github.com/restic/restic/pull/2047
|
||
|
||
* Enhancement #2220: Add config option to set S3 storage class
|
||
|
||
The `s3.storage-class` option can be passed to restic (using `-o`) to specify the storage
|
||
class to be used for S3 objects created by restic.
|
||
|
||
The storage class is passed as-is to S3, so it needs to be understood by the API. On AWS, it can be
|
||
one of `STANDARD`, `STANDARD_IA`, `ONEZONE_IA`, `INTELLIGENT_TIERING` and
|
||
`REDUCED_REDUNDANCY`. If unspecified, the default storage class is used (`STANDARD` on
|
||
AWS).
|
||
|
||
You can mix storage classes in the same bucket, and the setting isn't stored in the restic
|
||
repository, so be sure to specify it with each command that writes to S3.
|
||
|
||
https://github.com/restic/restic/issues/706
|
||
https://github.com/restic/restic/pull/2220
|
||
|
||
|
||
Changelog for restic 0.9.4 (2019-01-06)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.9.4 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1989: Google Cloud Storage: Respect bandwidth limit
|
||
* Fix #2040: Add host name filter shorthand flag for `stats` command
|
||
* Fix #2068: Correctly return error loading data
|
||
* Fix #2095: Consistently use local time for snapshots times
|
||
* Enh #1605: Concurrent restore
|
||
* Enh #2089: Increase granularity of the "keep within" retention policy
|
||
* Enh #2097: Add key hinting
|
||
* Enh #2017: Mount: Enforce FUSE Unix permissions with allow-other
|
||
* Enh #2070: Make all commands display timestamps in local time
|
||
* Enh #2085: Allow --files-from to be specified multiple times
|
||
* Enh #2094: Run command to get password
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1989: Google Cloud Storage: Respect bandwidth limit
|
||
|
||
The GCS backend did not respect the bandwidth limit configured, a previous commit
|
||
accidentally removed support for it.
|
||
|
||
https://github.com/restic/restic/issues/1989
|
||
https://github.com/restic/restic/pull/2100
|
||
|
||
* Bugfix #2040: Add host name filter shorthand flag for `stats` command
|
||
|
||
The default value for `--host` flag was set to 'H' (the shorthand version of the flag), this
|
||
caused the lookup for the latest snapshot to fail.
|
||
|
||
Add shorthand flag `-H` for `--host` (with empty default so if these flags are not specified the
|
||
latest snapshot will not filter by host name).
|
||
|
||
Also add shorthand `-H` for `backup` command.
|
||
|
||
https://github.com/restic/restic/issues/2040
|
||
|
||
* Bugfix #2068: Correctly return error loading data
|
||
|
||
In one case during `prune` and `check`, an error loading data from the backend is not returned
|
||
properly. This is now corrected.
|
||
|
||
https://github.com/restic/restic/issues/1999#issuecomment-433737921
|
||
https://github.com/restic/restic/pull/2068
|
||
|
||
* Bugfix #2095: Consistently use local time for snapshots times
|
||
|
||
By default snapshots created with restic backup were set to local time, but when the --time flag
|
||
was used the provided timestamp was parsed as UTC. With this change all snapshots times are set
|
||
to local time.
|
||
|
||
https://github.com/restic/restic/pull/2095
|
||
|
||
* Enhancement #1605: Concurrent restore
|
||
|
||
This change significantly improves restore performance, especially when using
|
||
high-latency remote repositories like B2.
|
||
|
||
The implementation now uses several concurrent threads to download and process multiple
|
||
remote files concurrently. To further reduce restore time, each remote file is downloaded
|
||
using a single repository request.
|
||
|
||
https://github.com/restic/restic/issues/1605
|
||
https://github.com/restic/restic/pull/1719
|
||
|
||
* Enhancement #2089: Increase granularity of the "keep within" retention policy
|
||
|
||
The `keep-within` option of the `forget` command now accepts time ranges with an hourly
|
||
granularity. For example, running `restic forget --keep-within 3d12h` will keep all the
|
||
snapshots made within three days and twelve hours from the time of the latest snapshot.
|
||
|
||
https://github.com/restic/restic/issues/2089
|
||
https://github.com/restic/restic/pull/2090
|
||
|
||
* Enhancement #2097: Add key hinting
|
||
|
||
Added a new option `--key-hint` and corresponding environment variable `RESTIC_KEY_HINT`.
|
||
The key hint is a key ID to try decrypting first, before other keys in the repository.
|
||
|
||
This change will benefit repositories with many keys; if the correct key hint is supplied then
|
||
restic only needs to check one key. If the key hint is incorrect (the key does not exist, or the
|
||
password is incorrect) then restic will check all keys, as usual.
|
||
|
||
https://github.com/restic/restic/issues/2097
|
||
|
||
* Enhancement #2017: Mount: Enforce FUSE Unix permissions with allow-other
|
||
|
||
The fuse mount (`restic mount`) now lets the kernel check the permissions of the files within
|
||
snapshots (this is done through the `DefaultPermissions` FUSE option) when the option
|
||
`--allow-other` is specified.
|
||
|
||
To restore the old behavior, we've added the `--no-default-permissions` option. This allows
|
||
all users that have access to the mount point to access all files within the snapshots.
|
||
|
||
https://github.com/restic/restic/pull/2017
|
||
|
||
* Enhancement #2070: Make all commands display timestamps in local time
|
||
|
||
Restic used to drop the timezone information from displayed timestamps, it now converts
|
||
timestamps to local time before printing them so the times can be easily compared to.
|
||
|
||
https://github.com/restic/restic/pull/2070
|
||
|
||
* Enhancement #2085: Allow --files-from to be specified multiple times
|
||
|
||
Before, restic took only the last file specified with `--files-from` into account, this is now
|
||
corrected.
|
||
|
||
https://github.com/restic/restic/issues/2085
|
||
https://github.com/restic/restic/pull/2086
|
||
|
||
* Enhancement #2094: Run command to get password
|
||
|
||
We've added the `--password-command` option which allows specifying a command that restic
|
||
runs every time the password for the repository is needed, so it can be integrated with a
|
||
password manager or keyring. The option can also be set via the environment variable
|
||
`$RESTIC_PASSWORD_COMMAND`.
|
||
|
||
https://github.com/restic/restic/pull/2094
|
||
|
||
|
||
Changelog for restic 0.9.3 (2018-10-13)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.9.3 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1935: Remove truncated files from cache
|
||
* Fix #1978: Do not return an error when the scanner is slower than backup
|
||
* Enh #1766: Restore: suppress lchown errors when not running as root
|
||
* Enh #1909: Reject files/dirs by name first
|
||
* Enh #1940: Add directory filter to ls command
|
||
* Enh #1967: Use `--host` everywhere
|
||
* Enh #2028: Display size of cache directories
|
||
* Enh #1777: Improve the `find` command
|
||
* Enh #1876: Display reason why forget keeps snapshots
|
||
* Enh #1891: Accept glob in paths loaded via --files-from
|
||
* Enh #1920: Vendor dependencies with Go 1.11 Modules
|
||
* Enh #1949: Add new command `self-update`
|
||
* Enh #1953: Ls: Add JSON output support for restic ls cmd
|
||
* Enh #1962: Stream JSON output for ls command
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1935: Remove truncated files from cache
|
||
|
||
When a file in the local cache is truncated, and restic tries to access data beyond the end of the
|
||
(cached) file, it used to return an error "EOF". This is now fixed, such truncated files are
|
||
removed and the data is fetched directly from the backend.
|
||
|
||
https://github.com/restic/restic/issues/1935
|
||
|
||
* Bugfix #1978: Do not return an error when the scanner is slower than backup
|
||
|
||
When restic makes a backup, there's a background task called "scanner" which collects
|
||
information on how many files and directories are to be saved, in order to display progress
|
||
information to the user. When the backup finishes faster than the scanner, it is aborted
|
||
because the result is not needed any more. This logic contained a bug, where quitting the
|
||
scanner process was treated as an error, and caused restic to print an unhelpful error message
|
||
("context canceled").
|
||
|
||
https://github.com/restic/restic/issues/1978
|
||
https://github.com/restic/restic/pull/1991
|
||
|
||
* Enhancement #1766: Restore: suppress lchown errors when not running as root
|
||
|
||
Like "cp" and "rsync" do, restic now only reports errors for changing the ownership of files
|
||
during restore if it is run as root, on non-Windows operating systems. On Windows, the error
|
||
is reported as usual.
|
||
|
||
https://github.com/restic/restic/issues/1766
|
||
|
||
* Enhancement #1909: Reject files/dirs by name first
|
||
|
||
The current scanner/archiver code had an architectural limitation: it always ran the
|
||
`lstat()` system call on all files and directories before a decision to include/exclude the
|
||
file/dir was made. This lead to a lot of unnecessary system calls for items that could have been
|
||
rejected by their name or path only.
|
||
|
||
We've changed the archiver/scanner implementation so that it now first rejects by name/path,
|
||
and only runs the system call on the remaining items. This reduces the number of `lstat()`
|
||
system calls a lot (depending on the exclude settings).
|
||
|
||
https://github.com/restic/restic/issues/1909
|
||
https://github.com/restic/restic/pull/1912
|
||
|
||
* Enhancement #1940: Add directory filter to ls command
|
||
|
||
The ls command can now be filtered by directories, so that only files in the given directories
|
||
will be shown. If the --recursive flag is specified, then ls will traverse subfolders and list
|
||
their files as well.
|
||
|
||
It used to be possible to specify multiple snapshots, but that has been replaced by only one
|
||
snapshot and the possibility of specifying multiple directories.
|
||
|
||
Specifying directories constrains the walk, which can significantly speed up the listing.
|
||
|
||
https://github.com/restic/restic/issues/1940
|
||
https://github.com/restic/restic/pull/1941
|
||
|
||
* Enhancement #1967: Use `--host` everywhere
|
||
|
||
We now use the flag `--host` for all commands which need a host name, using `--hostname` (e.g.
|
||
for `restic backup`) still works, but will print a deprecation warning. Also, add the short
|
||
option `-H` where possible.
|
||
|
||
https://github.com/restic/restic/issues/1967
|
||
|
||
* Enhancement #2028: Display size of cache directories
|
||
|
||
The `cache` command now by default shows the size of the individual cache directories. It can be
|
||
disabled with `--no-size`.
|
||
|
||
https://github.com/restic/restic/issues/2028
|
||
https://github.com/restic/restic/pull/2033
|
||
|
||
* Enhancement #1777: Improve the `find` command
|
||
|
||
We've updated the `find` command to support multiple patterns.
|
||
|
||
`restic find` is now able to list the snapshots containing a specific tree or blob, or even the
|
||
snapshots that contain blobs belonging to a given pack. A list of IDs can be given, as long as they
|
||
all have the same type.
|
||
|
||
The command `find` can also display the pack IDs the blobs belong to, if the `--show-pack-id`
|
||
flag is provided.
|
||
|
||
https://github.com/restic/restic/issues/1777
|
||
https://github.com/restic/restic/pull/1780
|
||
|
||
* Enhancement #1876: Display reason why forget keeps snapshots
|
||
|
||
We've added a column to the list of snapshots `forget` keeps which details the reasons to keep a
|
||
particuliar snapshot. This makes debugging policies for forget much easier. Please remember
|
||
to always try things out with `--dry-run`!
|
||
|
||
https://github.com/restic/restic/pull/1876
|
||
|
||
* Enhancement #1891: Accept glob in paths loaded via --files-from
|
||
|
||
Before that, behaviour was different if paths were appended to command line or from a file,
|
||
because wild card characters were expanded by shell if appended to command line, but not
|
||
expanded if loaded from file.
|
||
|
||
https://github.com/restic/restic/issues/1891
|
||
|
||
* Enhancement #1920: Vendor dependencies with Go 1.11 Modules
|
||
|
||
Until now, we've used `dep` for managing dependencies, we've now switch to using Go modules.
|
||
For users this does not change much, only if you want to compile restic without downloading
|
||
anything with Go 1.11, then you need to run: `go build -mod=vendor build.go`
|
||
|
||
https://github.com/restic/restic/pull/1920
|
||
|
||
* Enhancement #1949: Add new command `self-update`
|
||
|
||
We have added a new command called `self-update` which downloads the latest released version
|
||
of restic from GitHub and replaces the current binary with it. It does not rely on any external
|
||
program (so it'll work everywhere), but still verifies the GPG signature using the embedded
|
||
GPG public key.
|
||
|
||
By default, the `self-update` command is hidden behind the `selfupdate` built tag, which is
|
||
only set when restic is built using `build.go` (including official releases). The reason for
|
||
this is that downstream distributions will then not include the command by default, so users
|
||
are encouraged to use the platform-specific distribution mechanism.
|
||
|
||
https://github.com/restic/restic/pull/1949
|
||
|
||
* Enhancement #1953: Ls: Add JSON output support for restic ls cmd
|
||
|
||
We've implemented listing files in the repository with JSON as output, just pass `--json` as an
|
||
option to `restic ls`. This makes the output of the command machine readable.
|
||
|
||
https://github.com/restic/restic/pull/1953
|
||
|
||
* Enhancement #1962: Stream JSON output for ls command
|
||
|
||
The `ls` command now supports JSON output with the global `--json` flag, and this change
|
||
streams out JSON messages one object at a time rather than en entire array buffered in memory
|
||
before encoding. The advantage is it allows large listings to be handled efficiently.
|
||
|
||
Two message types are printed: snapshots and nodes. A snapshot object will precede node
|
||
objects which belong to that snapshot. The `struct_type` field can be used to determine which
|
||
kind of message an object is.
|
||
|
||
https://github.com/restic/restic/pull/1962
|
||
|
||
|
||
Changelog for restic 0.9.2 (2018-08-06)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.9.2 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1854: Allow saving files/dirs on different fs with `--one-file-system`
|
||
* Fix #1870: Fix restore with --include
|
||
* Fix #1880: Use `--cache-dir` argument for `check` command
|
||
* Fix #1893: Return error when exclude file cannot be read
|
||
* Fix #1861: Fix case-insensitive search with restic find
|
||
* Enh #1906: Add support for B2 application keys
|
||
* Enh #874: Add stats command to get information about a repository
|
||
* Enh #1772: Add restore --verify to verify restored file content
|
||
* Enh #1853: Add JSON output support to `restic key list`
|
||
* Enh #1477: S3 backend: accept AWS_SESSION_TOKEN
|
||
* Enh #1901: Update the Backblaze B2 library
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1854: Allow saving files/dirs on different fs with `--one-file-system`
|
||
|
||
Restic now allows saving files/dirs on a different file system in a subdir correctly even when
|
||
`--one-file-system` is specified.
|
||
|
||
The first thing the restic archiver code does is to build a tree of the target
|
||
files/directories. If it detects that a parent directory is already included (e.g. `restic
|
||
backup /foo /foo/bar/baz`), it'll ignore the latter argument.
|
||
|
||
Without `--one-file-system`, that's perfectly valid: If `/foo` is to be archived, it will
|
||
include `/foo/bar/baz`. But with `--one-file-system`, `/foo/bar/baz` may reside on a
|
||
different file system, so it won't be included with `/foo`.
|
||
|
||
https://github.com/restic/restic/issues/1854
|
||
https://github.com/restic/restic/pull/1855
|
||
|
||
* Bugfix #1870: Fix restore with --include
|
||
|
||
We fixed a bug which prevented restic to restore files with an include filter.
|
||
|
||
https://github.com/restic/restic/issues/1870
|
||
https://github.com/restic/restic/pull/1900
|
||
|
||
* Bugfix #1880: Use `--cache-dir` argument for `check` command
|
||
|
||
`check` command now uses a temporary sub-directory of the specified directory if set using the
|
||
`--cache-dir` argument. If not set, the cache directory is created in the default temporary
|
||
directory as before. In either case a temporary cache is used to ensure the actual repository is
|
||
checked (rather than a local copy).
|
||
|
||
The `--cache-dir` argument was not used by the `check` command, instead a cache directory was
|
||
created in the temporary directory.
|
||
|
||
https://github.com/restic/restic/issues/1880
|
||
|
||
* Bugfix #1893: Return error when exclude file cannot be read
|
||
|
||
A bug was found: when multiple exclude files were passed to restic and one of them could not be
|
||
read, an error was printed and restic continued, ignoring even the existing exclude files.
|
||
Now, an error message is printed and restic aborts when an exclude file cannot be read.
|
||
|
||
https://github.com/restic/restic/issues/1893
|
||
|
||
* Bugfix #1861: Fix case-insensitive search with restic find
|
||
|
||
We've fixed the behavior for `restic find -i PATTERN`, which was broken in v0.9.1.
|
||
|
||
https://github.com/restic/restic/pull/1861
|
||
|
||
* Enhancement #1906: Add support for B2 application keys
|
||
|
||
Restic can now use so-called "application keys" which can be created in the B2 dashboard and
|
||
were only introduced recently. In contrast to the "master key", such keys can be restricted to a
|
||
specific bucket and/or path.
|
||
|
||
https://github.com/restic/restic/issues/1906
|
||
https://github.com/restic/restic/pull/1914
|
||
|
||
* Enhancement #874: Add stats command to get information about a repository
|
||
|
||
https://github.com/restic/restic/issues/874
|
||
https://github.com/restic/restic/pull/1729
|
||
|
||
* Enhancement #1772: Add restore --verify to verify restored file content
|
||
|
||
Restore will print error message if restored file content does not match expected SHA256
|
||
checksum
|
||
|
||
https://github.com/restic/restic/pull/1772
|
||
|
||
* Enhancement #1853: Add JSON output support to `restic key list`
|
||
|
||
This PR enables users to get the output of `restic key list` in JSON in addition to the existing
|
||
table format.
|
||
|
||
https://github.com/restic/restic/pull/1853
|
||
|
||
* Enhancement #1477: S3 backend: accept AWS_SESSION_TOKEN
|
||
|
||
Before, it was not possible to use s3 backend with AWS temporary security credentials(with
|
||
AWS_SESSION_TOKEN). This change gives higher priority to credentials.EnvAWS credentials
|
||
provider.
|
||
|
||
https://github.com/restic/restic/issues/1477
|
||
https://github.com/restic/restic/pull/1479
|
||
https://github.com/restic/restic/pull/1647
|
||
|
||
* Enhancement #1901: Update the Backblaze B2 library
|
||
|
||
We've updated the library we're using for accessing the Backblaze B2 service to 0.5.0 to
|
||
include support for upcoming so-called "application keys". With this feature, you can create
|
||
access credentials for B2 which are restricted to e.g. a single bucket or even a sub-directory
|
||
of a bucket.
|
||
|
||
https://github.com/restic/restic/pull/1901
|
||
https://github.com/kurin/blazer
|
||
|
||
|
||
Changelog for restic 0.9.1 (2018-06-10)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.9.1 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1801: Add limiting bandwidth to the rclone backend
|
||
* Fix #1822: Allow uploading large files to MS Azure
|
||
* Fix #1825: Correct `find` to not skip snapshots
|
||
* Fix #1833: Fix caching files on error
|
||
* Fix #1834: Resolve deadlock
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1801: Add limiting bandwidth to the rclone backend
|
||
|
||
The rclone backend did not respect `--limit-upload` or `--limit-download`. Oftentimes it's
|
||
not necessary to use this, as the limiting in rclone itself should be used because it gives much
|
||
better results, but in case a remote instance of rclone is used (e.g. called via ssh), it is still
|
||
relevant to limit the bandwidth from restic to rclone.
|
||
|
||
https://github.com/restic/restic/issues/1801
|
||
|
||
* Bugfix #1822: Allow uploading large files to MS Azure
|
||
|
||
Sometimes, restic creates files to be uploaded to the repository which are quite large, e.g.
|
||
when saving directories with many entries or very large files. The MS Azure API does not allow
|
||
uploading files larger that 256MiB directly, rather restic needs to upload them in blocks of
|
||
100MiB. This is now implemented.
|
||
|
||
https://github.com/restic/restic/issues/1822
|
||
|
||
* Bugfix #1825: Correct `find` to not skip snapshots
|
||
|
||
Under certain circumstances, the `find` command was found to skip snapshots containing
|
||
directories with files to look for when the directories haven't been modified at all, and were
|
||
already printed as part of a different snapshot. This is now corrected.
|
||
|
||
In addition, we've switched to our own matching/pattern implementation, so now things like
|
||
`restic find "/home/user/foo/**/main.go"` are possible.
|
||
|
||
https://github.com/restic/restic/issues/1825
|
||
https://github.com/restic/restic/issues/1823
|
||
|
||
* Bugfix #1833: Fix caching files on error
|
||
|
||
During `check` it may happen that different threads access the same file in the backend, which
|
||
is then downloaded into the cache only once. When that fails, only the thread which is
|
||
responsible for downloading the file signals the correct error. The other threads just assume
|
||
that the file has been downloaded successfully and then get an error when they try to access the
|
||
cached file.
|
||
|
||
https://github.com/restic/restic/issues/1833
|
||
|
||
* Bugfix #1834: Resolve deadlock
|
||
|
||
When the "scanning" process restic runs to find out how much data there is does not finish before
|
||
the backup itself is done, restic stops doing anything. This is resolved now.
|
||
|
||
https://github.com/restic/restic/issues/1834
|
||
https://github.com/restic/restic/pull/1835
|
||
|
||
|
||
Changelog for restic 0.9.0 (2018-05-21)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.9.0 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1608: Respect time stamp for new backup when reading from stdin
|
||
* Fix #1652: Ignore/remove invalid lock files
|
||
* Fix #1730: Ignore sockets for restore
|
||
* Fix #1684: Fix backend tests for rest-server
|
||
* Fix #1745: Correctly parse the argument to --tls-client-cert
|
||
* Enh #1433: Support UTF-16 encoding and process Byte Order Mark
|
||
* Enh #1561: Allow using rclone to access other services
|
||
* Enh #1665: Improve cache handling for `restic check`
|
||
* Enh #1721: Add `cache` command to list cache dirs
|
||
* Enh #1758: Allow saving OneDrive folders in Windows
|
||
* Enh #549: Rework archiver code
|
||
* Enh #1552: Use Google Application Default credentials
|
||
* Enh #1477: Accept AWS_SESSION_TOKEN for the s3 backend
|
||
* Enh #1648: Ignore AWS permission denied error when creating a repository
|
||
* Enh #1649: Add illumos/Solaris support
|
||
* Enh #1709: Improve messages `restic check` prints
|
||
* Enh #827: Add --new-password-file flag for non-interactive password changes
|
||
* Enh #1735: Allow keeping a time range of snaphots
|
||
* Enh #1782: Use default AWS credentials chain for S3 backend
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1608: Respect time stamp for new backup when reading from stdin
|
||
|
||
When reading backups from stdin (via `restic backup --stdin`), restic now uses the time stamp
|
||
for the new backup passed in `--time`.
|
||
|
||
https://github.com/restic/restic/issues/1608
|
||
https://github.com/restic/restic/pull/1703
|
||
|
||
* Bugfix #1652: Ignore/remove invalid lock files
|
||
|
||
This corrects a bug introduced recently: When an invalid lock file in the repo is encountered
|
||
(e.g. if the file is empty), the code used to ignore that, but now returns the error. Now, invalid
|
||
files are ignored for the normal lock check, and removed when `restic unlock --remove-all` is
|
||
run.
|
||
|
||
https://github.com/restic/restic/issues/1652
|
||
https://github.com/restic/restic/pull/1653
|
||
|
||
* Bugfix #1730: Ignore sockets for restore
|
||
|
||
We've received a report and correct the behavior in which the restore code aborted restoring a
|
||
directory when a socket was encountered. Unix domain socket files cannot be restored (they are
|
||
created on the fly once a process starts listening). The error handling was corrected, and in
|
||
addition we're now ignoring sockets during restore.
|
||
|
||
https://github.com/restic/restic/issues/1730
|
||
https://github.com/restic/restic/pull/1731
|
||
|
||
* Bugfix #1684: Fix backend tests for rest-server
|
||
|
||
The REST server for restic now requires an explicit parameter (`--no-auth`) if no
|
||
authentication should be allowed. This is fixed in the tests.
|
||
|
||
https://github.com/restic/restic/pull/1684
|
||
|
||
* Bugfix #1745: Correctly parse the argument to --tls-client-cert
|
||
|
||
Previously, the --tls-client-cert method attempt to read ARGV[1] (hardcoded) instead of the
|
||
argument that was passed to it. This has been corrected.
|
||
|
||
https://github.com/restic/restic/issues/1745
|
||
https://github.com/restic/restic/pull/1746
|
||
|
||
* Enhancement #1433: Support UTF-16 encoding and process Byte Order Mark
|
||
|
||
On Windows, text editors commonly leave a Byte Order Mark at the beginning of the file to define
|
||
which encoding is used (oftentimes UTF-16). We've added code to support processing the BOMs in
|
||
text files, like the exclude files, the password file and the file passed via `--files-from`.
|
||
This does not apply to any file being saved in a backup, those are not touched and archived as they
|
||
are.
|
||
|
||
https://github.com/restic/restic/issues/1433
|
||
https://github.com/restic/restic/issues/1738
|
||
https://github.com/restic/restic/pull/1748
|
||
|
||
* Enhancement #1561: Allow using rclone to access other services
|
||
|
||
We've added the ability to use rclone to store backup data on all backends that it supports. This
|
||
was done in collaboration with Nick, the author of rclone. You can now use it to first configure a
|
||
service, then restic manages the rest (starting and stopping rclone). For details, please see
|
||
the manual.
|
||
|
||
https://github.com/restic/restic/issues/1561
|
||
https://github.com/restic/restic/pull/1657
|
||
https://rclone.org
|
||
|
||
* Enhancement #1665: Improve cache handling for `restic check`
|
||
|
||
For safety reasons, restic does not use a local metadata cache for the `restic check` command,
|
||
so that data is loaded from the repository and restic can check it's in good condition. When the
|
||
cache is disabled, restic will fetch each tiny blob needed for checking the integrity using a
|
||
separate backend request. For non-local backends, that will take a long time, and depending on
|
||
the backend (e.g. B2) may also be much more expensive.
|
||
|
||
This PR adds a few commits which will change the behavior as follows:
|
||
|
||
* When `restic check` is called without any additional parameters, it will build a new cache in a
|
||
temporary directory, which is removed at the end of the check. This way, we'll get readahead for
|
||
metadata files (so restic will fetch the whole file when the first blob from the file is
|
||
requested), but all data is freshly fetched from the storage backend. This is the default
|
||
behavior and will work for almost all users.
|
||
|
||
* When `restic check` is called with `--with-cache`, the default on-disc cache is used. This
|
||
behavior hasn't changed since the cache was introduced.
|
||
|
||
* When `--no-cache` is specified, restic falls back to the old behavior, and read all tiny blobs
|
||
in separate requests.
|
||
|
||
https://github.com/restic/restic/issues/1665
|
||
https://github.com/restic/restic/issues/1694
|
||
https://github.com/restic/restic/pull/1696
|
||
|
||
* Enhancement #1721: Add `cache` command to list cache dirs
|
||
|
||
The command `cache` was added, it allows listing restic's cache directoriers together with
|
||
the last usage. It also allows removing old cache dirs without having to access a repo, via
|
||
`restic cache --cleanup`
|
||
|
||
https://github.com/restic/restic/issues/1721
|
||
https://github.com/restic/restic/pull/1749
|
||
|
||
* Enhancement #1758: Allow saving OneDrive folders in Windows
|
||
|
||
Restic now contains a bugfix to two libraries, which allows saving OneDrive folders in
|
||
Windows. In order to use the newer versions of the libraries, the minimal version required to
|
||
compile restic is now Go 1.9.
|
||
|
||
https://github.com/restic/restic/issues/1758
|
||
https://github.com/restic/restic/pull/1765
|
||
|
||
* Enhancement #549: Rework archiver code
|
||
|
||
The core archiver code and the complementary code for the `backup` command was rewritten
|
||
completely. This resolves very annoying issues such as 549. The first backup with this release
|
||
of restic will likely result in all files being re-read locally, so it will take a lot longer. The
|
||
next backup after that will be fast again.
|
||
|
||
Basically, with the old code, restic took the last path component of each to-be-saved file or
|
||
directory as the top-level file/directory within the snapshot. This meant that when called as
|
||
`restic backup /home/user/foo`, the snapshot would contain the files in the directory
|
||
`/home/user/foo` as `/foo`.
|
||
|
||
This is not the case any more with the new archiver code. Now, restic works very similar to what
|
||
`tar` does: When restic is called with an absolute path to save, then it'll preserve the
|
||
directory structure within the snapshot. For the example above, the snapshot would contain
|
||
the files in the directory within `/home/user/foo` in the snapshot. For relative
|
||
directories, it only preserves the relative path components. So `restic backup user/foo`
|
||
will save the files as `/user/foo` in the snapshot.
|
||
|
||
While we were at it, the status display and notification system was completely rewritten. By
|
||
default, restic now shows which files are currently read (unless `--quiet` is specified) in a
|
||
multi-line status display.
|
||
|
||
The `backup` command also gained a new option: `--verbose`. It can be specified once (which
|
||
prints a bit more detail what restic is doing) or twice (which prints a line for each
|
||
file/directory restic encountered, together with some statistics).
|
||
|
||
Another issue that was resolved is the new code only reads two files at most. The old code would
|
||
read way too many files in parallel, thereby slowing down the backup process on spinning discs a
|
||
lot.
|
||
|
||
https://github.com/restic/restic/issues/549
|
||
https://github.com/restic/restic/issues/1286
|
||
https://github.com/restic/restic/issues/446
|
||
https://github.com/restic/restic/issues/1344
|
||
https://github.com/restic/restic/issues/1416
|
||
https://github.com/restic/restic/issues/1456
|
||
https://github.com/restic/restic/issues/1145
|
||
https://github.com/restic/restic/issues/1160
|
||
https://github.com/restic/restic/pull/1494
|
||
|
||
* Enhancement #1552: Use Google Application Default credentials
|
||
|
||
Google provide libraries to generate appropriate credentials with various fallback
|
||
sources. This change uses the library to generate our GCS client, which allows us to make use of
|
||
these extra methods.
|
||
|
||
This should be backward compatible with previous restic behaviour while adding the
|
||
additional capabilities to auth from Google's internal metadata endpoints. For users
|
||
running restic in GCP this can make authentication far easier than it was before.
|
||
|
||
https://github.com/restic/restic/pull/1552
|
||
https://developers.google.com/identity/protocols/application-default-credentials
|
||
|
||
* Enhancement #1477: Accept AWS_SESSION_TOKEN for the s3 backend
|
||
|
||
Before, it was not possible to use s3 backend with AWS temporary security credentials(with
|
||
AWS_SESSION_TOKEN). This change gives higher priority to credentials.EnvAWS credentials
|
||
provider.
|
||
|
||
https://github.com/restic/restic/issues/1477
|
||
https://github.com/restic/restic/pull/1479
|
||
https://github.com/restic/restic/pull/1647
|
||
|
||
* Enhancement #1648: Ignore AWS permission denied error when creating a repository
|
||
|
||
It's not possible to use s3 backend scoped to a subdirectory(with specific permissions).
|
||
Restic doesn't try to create repository in a subdirectory, when 'bucket exists' of parent
|
||
directory check fails due to permission issues.
|
||
|
||
https://github.com/restic/restic/pull/1648
|
||
|
||
* Enhancement #1649: Add illumos/Solaris support
|
||
|
||
https://github.com/restic/restic/pull/1649
|
||
|
||
* Enhancement #1709: Improve messages `restic check` prints
|
||
|
||
Some messages `restic check` prints are not really errors, so from now on restic does not treat
|
||
them as errors any more and exits cleanly.
|
||
|
||
https://github.com/restic/restic/pull/1709
|
||
https://forum.restic.net/t/what-is-the-standard-procedure-to-follow-if-a-backup-or-restore-is-interrupted/571/2
|
||
|
||
* Enhancement #827: Add --new-password-file flag for non-interactive password changes
|
||
|
||
This makes it possible to change a repository password without being prompted.
|
||
|
||
https://github.com/restic/restic/issues/827
|
||
https://github.com/restic/restic/pull/1720
|
||
https://forum.restic.net/t/changing-repo-password-without-prompt/591
|
||
|
||
* Enhancement #1735: Allow keeping a time range of snaphots
|
||
|
||
We've added the `--keep-within` option to the `forget` command. It instructs restic to keep
|
||
all snapshots within the given duration since the newest snapshot. For example, running
|
||
`restic forget --keep-within 5m7d` will keep all snapshots which have been made in the five
|
||
months and seven days since the latest snapshot.
|
||
|
||
https://github.com/restic/restic/pull/1735
|
||
|
||
* Enhancement #1782: Use default AWS credentials chain for S3 backend
|
||
|
||
Adds support for file credentials to the S3 backend (e.g. ~/.aws/credentials), and reorders
|
||
the credentials chain for the S3 backend to match AWS's standard, which is static credentials,
|
||
env vars, credentials file, and finally remote.
|
||
|
||
https://github.com/restic/restic/pull/1782
|
||
|
||
|
||
Changelog for restic 0.8.3 (2018-02-26)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.8.3 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1633: Fixed unexpected 'pack file cannot be listed' error
|
||
* Fix #1641: Ignore files with invalid names in the repo
|
||
* Fix #1638: Handle errors listing files in the backend
|
||
* Enh #1497: Add --read-data-subset flag to check command
|
||
* Enh #1560: Retry all repository file download errors
|
||
* Enh #1623: Don't check for presence of files in the backend before writing
|
||
* Enh #1634: Upgrade B2 client library, reduce HTTP requests
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1633: Fixed unexpected 'pack file cannot be listed' error
|
||
|
||
Due to a regression introduced in 0.8.2, the `rebuild-index` and `prune` commands failed to
|
||
read pack files with size of 587, 588, 589 or 590 bytes.
|
||
|
||
https://github.com/restic/restic/issues/1633
|
||
https://github.com/restic/restic/pull/1635
|
||
|
||
* Bugfix #1641: Ignore files with invalid names in the repo
|
||
|
||
The release 0.8.2 introduced a bug: when restic encounters files in the repo which do not have a
|
||
valid name, it tries to load a file with a name of lots of zeroes instead of ignoring it. This is now
|
||
resolved, invalid file names are just ignored.
|
||
|
||
https://github.com/restic/restic/issues/1641
|
||
https://github.com/restic/restic/pull/1643
|
||
https://forum.restic.net/t/help-fixing-repo-no-such-file/485/3
|
||
|
||
* Bugfix #1638: Handle errors listing files in the backend
|
||
|
||
A user reported in the forum that restic completes a backup although a concurrent `prune`
|
||
operation was running. A few error messages were printed, but the backup was attempted and
|
||
completed successfully. No error code was returned.
|
||
|
||
This should not happen: The repository is exclusively locked during `prune`, so when `restic
|
||
backup` is run in parallel, it should abort and return an error code instead.
|
||
|
||
It was found that the bug was in the code introduced only recently, which retries a List()
|
||
operation on the backend should that fail. It is now corrected.
|
||
|
||
https://github.com/restic/restic/pull/1638
|
||
https://forum.restic.net/t/restic-backup-returns-0-exit-code-when-already-locked/484
|
||
|
||
* Enhancement #1497: Add --read-data-subset flag to check command
|
||
|
||
This change introduces ability to check integrity of a subset of repository data packs. This
|
||
can be used to spread integrity check of larger repositories over a period of time.
|
||
|
||
https://github.com/restic/restic/issues/1497
|
||
https://github.com/restic/restic/pull/1556
|
||
|
||
* Enhancement #1560: Retry all repository file download errors
|
||
|
||
Restic will now retry failed downloads, similar to other operations.
|
||
|
||
https://github.com/restic/restic/pull/1560
|
||
|
||
* Enhancement #1623: Don't check for presence of files in the backend before writing
|
||
|
||
Before, all backend implementations were required to return an error if the file that is to be
|
||
written already exists in the backend. For most backends, that means making a request (e.g. via
|
||
HTTP) and returning an error when the file already exists.
|
||
|
||
This is not accurate, the file could have been created between the HTTP request testing for it,
|
||
and when writing starts, so we've relaxed this requeriment, which saves one additional HTTP
|
||
request per newly added file.
|
||
|
||
https://github.com/restic/restic/pull/1623
|
||
|
||
* Enhancement #1634: Upgrade B2 client library, reduce HTTP requests
|
||
|
||
We've upgraded the B2 client library restic uses to access BackBlaze B2. This reduces the
|
||
number of HTTP requests needed to upload a new file from two to one, which should improve
|
||
throughput to B2.
|
||
|
||
https://github.com/restic/restic/pull/1634
|
||
|
||
|
||
Changelog for restic 0.8.2 (2018-02-17)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.8.2 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1506: Limit bandwith at the http.RoundTripper for HTTP based backends
|
||
* Fix #1512: Restore directory permissions as the last step
|
||
* Fix #1528: Correctly create missing subdirs in data/
|
||
* Fix #1590: Strip spaces for lines read via --files-from
|
||
* Fix #1589: Complete intermediate index upload
|
||
* Fix #1594: Google Cloud Storage: Use generic HTTP transport
|
||
* Fix #1595: Backup: Remove bandwidth display
|
||
* Enh #1522: Add support for TLS client certificate authentication
|
||
* Enh #1541: Reduce number of remote requests during repository check
|
||
* Enh #1567: Reduce number of backend requests for rebuild-index and prune
|
||
* Enh #1507: Only reload snapshots once per minute for fuse mount
|
||
* Enh #1538: Reduce memory allocations for querying the index
|
||
* Enh #1549: Speed up querying across indices and scanning existing files
|
||
* Enh #1554: Fuse/mount: Correctly handle EOF, add template option
|
||
* Enh #1564: Don't terminate ssh on SIGINT
|
||
* Enh #1579: Retry Backend.List() in case of errors
|
||
* Enh #1584: Limit index file size
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1506: Limit bandwith at the http.RoundTripper for HTTP based backends
|
||
|
||
https://github.com/restic/restic/issues/1506
|
||
https://github.com/restic/restic/pull/1511
|
||
|
||
* Bugfix #1512: Restore directory permissions as the last step
|
||
|
||
This change allows restoring into directories that were not writable during backup. Before,
|
||
restic created the directory, set the read-only mode and then failed to create files in the
|
||
directory. This change now restores the directory (with its permissions) as the very last
|
||
step.
|
||
|
||
https://github.com/restic/restic/issues/1512
|
||
https://github.com/restic/restic/pull/1536
|
||
|
||
* Bugfix #1528: Correctly create missing subdirs in data/
|
||
|
||
https://github.com/restic/restic/issues/1528
|
||
https://github.com/restic/restic/pull/1529
|
||
|
||
* Bugfix #1590: Strip spaces for lines read via --files-from
|
||
|
||
Leading and trailing spaces in lines read via `--files-from` are now stripped, so it behaves
|
||
the same as with lines read via `--exclude-file`.
|
||
|
||
https://github.com/restic/restic/issues/1590
|
||
https://github.com/restic/restic/pull/1613
|
||
|
||
* Bugfix #1589: Complete intermediate index upload
|
||
|
||
After a user posted a comprehensive report of what he observed, we were able to find a bug and
|
||
correct it: During backup, restic uploads so-called "intermediate" index files. When the
|
||
backup finishes during a transfer of such an intermediate index, the upload is cancelled, but
|
||
the backup is finished without an error. This leads to an inconsistent state, where the
|
||
snapshot references data that is contained in the repo, but is not referenced in any index.
|
||
|
||
The situation can be resolved by building a new index with `rebuild-index`, but looks very
|
||
confusing at first. Since all the data got uploaded to the repo successfully, there was no risk
|
||
of data loss, just minor inconvenience for our users.
|
||
|
||
https://github.com/restic/restic/pull/1589
|
||
https://forum.restic.net/t/error-loading-tree-check-prune-and-forget-gives-error-b2-backend/406
|
||
|
||
* Bugfix #1594: Google Cloud Storage: Use generic HTTP transport
|
||
|
||
It was discovered that the Google Cloud Storage backend did not use the generic HTTP transport,
|
||
so things such as bandwidth limiting with `--limit-upload` did not work. This is resolved now.
|
||
|
||
https://github.com/restic/restic/pull/1594
|
||
|
||
* Bugfix #1595: Backup: Remove bandwidth display
|
||
|
||
This commit removes the bandwidth displayed during backup process. It is misleading and
|
||
seldomly correct, because it's neither the "read bandwidth" (only for the very first backup)
|
||
nor the "upload bandwidth". Many users are confused about (and rightly so), c.f. #1581, #1033,
|
||
#1591
|
||
|
||
We'll eventually replace this display with something more relevant when the new archiver code
|
||
is ready.
|
||
|
||
https://github.com/restic/restic/pull/1595
|
||
|
||
* Enhancement #1522: Add support for TLS client certificate authentication
|
||
|
||
Support has been added for using a TLS client certificate for authentication to HTTP based
|
||
backend. A file containing the PEM encoded private key and certificate can be set using the
|
||
`--tls-client-cert` option.
|
||
|
||
https://github.com/restic/restic/issues/1522
|
||
https://github.com/restic/restic/pull/1524
|
||
|
||
* Enhancement #1541: Reduce number of remote requests during repository check
|
||
|
||
This change eliminates redundant remote repository calls and significantly improves
|
||
repository check time.
|
||
|
||
https://github.com/restic/restic/issues/1541
|
||
https://github.com/restic/restic/pull/1548
|
||
|
||
* Enhancement #1567: Reduce number of backend requests for rebuild-index and prune
|
||
|
||
We've found a way to reduce then number of backend requests for the `rebuild-index` and `prune`
|
||
operations. This significantly speeds up the operations for high-latency backends.
|
||
|
||
https://github.com/restic/restic/issues/1567
|
||
https://github.com/restic/restic/pull/1574
|
||
https://github.com/restic/restic/pull/1575
|
||
|
||
* Enhancement #1507: Only reload snapshots once per minute for fuse mount
|
||
|
||
https://github.com/restic/restic/pull/1507
|
||
|
||
* Enhancement #1538: Reduce memory allocations for querying the index
|
||
|
||
This change reduces the internal memory allocations when the index data structures in memory
|
||
are queried if a blob (part of a file) already exists in the repo. It should speed up backup a bit,
|
||
and maybe even reduce RAM usage.
|
||
|
||
https://github.com/restic/restic/pull/1538
|
||
|
||
* Enhancement #1549: Speed up querying across indices and scanning existing files
|
||
|
||
This change increases the whenever a blob (part of a file) is searched for in a restic
|
||
repository. This will reduce cpu usage some when backing up files already backed up by restic.
|
||
Cpu usage is further decreased when scanning files.
|
||
|
||
https://github.com/restic/restic/pull/1549
|
||
|
||
* Enhancement #1554: Fuse/mount: Correctly handle EOF, add template option
|
||
|
||
We've added the `--snapshot-template` string, which can be used to specify a template for a
|
||
snapshot directory. In addition, accessing data after the end of a file via the fuse mount is now
|
||
handled correctly.
|
||
|
||
https://github.com/restic/restic/pull/1554
|
||
|
||
* Enhancement #1564: Don't terminate ssh on SIGINT
|
||
|
||
We've reworked the code which runs the `ssh` login for the sftp backend so that it can prompt for a
|
||
password (if needed) but does not exit when the user presses CTRL+C (SIGINT) e.g. during
|
||
backup. This allows restic to properly shut down when it receives SIGINT and remove the lock
|
||
file from the repo, afterwards exiting the `ssh` process.
|
||
|
||
https://github.com/restic/restic/pull/1564
|
||
https://github.com/restic/restic/pull/1588
|
||
|
||
* Enhancement #1579: Retry Backend.List() in case of errors
|
||
|
||
https://github.com/restic/restic/pull/1579
|
||
|
||
* Enhancement #1584: Limit index file size
|
||
|
||
Before, restic would create a single new index file on `prune` or `rebuild-index`, this may
|
||
lead to memory problems when this huge index is created and loaded again. We're now limiting the
|
||
size of the index file, and split newly created index files into several smaller ones. This
|
||
allows restic to be more memory-efficient.
|
||
|
||
https://github.com/restic/restic/issues/1412
|
||
https://github.com/restic/restic/issues/979
|
||
https://github.com/restic/restic/issues/526
|
||
https://github.com/restic/restic/pull/1584
|
||
|
||
|
||
Changelog for restic 0.8.1 (2017-12-27)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.8.1 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1457: Improve s3 backend with DigitalOcean Spaces
|
||
* Fix #1454: Correct cache dir location for Windows and Darwin
|
||
* Fix #1459: Disable handling SIGPIPE
|
||
* Chg #1452: Do not save atime by default
|
||
* Enh #1436: Add code to detect old cache directories
|
||
* Enh #1439: Improve cancellation logic
|
||
* Enh #11: Add the `diff` command
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1457: Improve s3 backend with DigitalOcean Spaces
|
||
|
||
https://github.com/restic/restic/issues/1457
|
||
https://github.com/restic/restic/pull/1459
|
||
|
||
* Bugfix #1454: Correct cache dir location for Windows and Darwin
|
||
|
||
The cache directory on Windows and Darwin was not correct, instead the directory `.cache` was
|
||
used.
|
||
|
||
https://github.com/restic/restic/pull/1454
|
||
|
||
* Bugfix #1459: Disable handling SIGPIPE
|
||
|
||
We've disabled handling SIGPIPE again. Turns out, writing to broken TCP connections also
|
||
raised SIGPIPE, so restic exits on the first write to a broken connection. Instead, restic
|
||
should retry the request.
|
||
|
||
https://github.com/restic/restic/issues/1457
|
||
https://github.com/restic/restic/issues/1466
|
||
https://github.com/restic/restic/pull/1459
|
||
|
||
* Change #1452: Do not save atime by default
|
||
|
||
By default, the access time for files and dirs is not saved any more. It is not possible to
|
||
reliably disable updating the access time during a backup, so for the next backup the access
|
||
time is different again. This means a lot of metadata is saved. If you want to save the access time
|
||
anyway, pass `--with-atime` to the `backup` command.
|
||
|
||
https://github.com/restic/restic/pull/1452
|
||
|
||
* Enhancement #1436: Add code to detect old cache directories
|
||
|
||
We've added code to detect old cache directories of repositories that haven't been used in a
|
||
long time, restic now prints a note when it detects that such dirs exist. Also, the option
|
||
`--cleanup-cache` was added to automatically remove such directories. That's not a problem
|
||
because the cache will be rebuild once a repo is accessed again.
|
||
|
||
https://github.com/restic/restic/pull/1436
|
||
|
||
* Enhancement #1439: Improve cancellation logic
|
||
|
||
The cancellation logic was improved, restic can now shut down cleanly when requested to do so
|
||
(e.g. via ctrl+c).
|
||
|
||
https://github.com/restic/restic/pull/1439
|
||
|
||
* Enhancement #11: Add the `diff` command
|
||
|
||
The command `diff` was added, it allows comparing two snapshots and listing all differences.
|
||
|
||
https://github.com/restic/restic/issues/11
|
||
https://github.com/restic/restic/issues/1460
|
||
https://github.com/restic/restic/pull/1462
|
||
|
||
|
||
Changelog for restic 0.8.0 (2017-11-26)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.8.0 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Sec #1445: Prevent writing outside the target directory during restore
|
||
* Fix #1256: Re-enable workaround for S3 backend
|
||
* Fix #1291: Reuse backend TCP connections to BackBlaze B2
|
||
* Fix #1317: Run prune when `forget --prune` is called with just snapshot IDs
|
||
* Fix #1437: Remove implicit path `/restic` for the s3 backend
|
||
* Enh #1102: Add subdirectory `ids` to fuse mount
|
||
* Enh #1114: Add `--cacert` to specify TLS certificates to check against
|
||
* Enh #1216: Add upload/download limiting
|
||
* Enh #1271: Cache results for excludes for `backup`
|
||
* Enh #1274: Add `generate` command, replaces `manpage` and `autocomplete`
|
||
* Enh #1367: Allow comments in files read from via `--file-from`
|
||
* Enh #448: Sftp backend prompts for password
|
||
* Enh #510: Add `dump` command
|
||
* Enh #1040: Add local metadata cache
|
||
* Enh #1249: Add `latest` symlink in fuse mount
|
||
* Enh #1269: Add `--compact` to `forget` command
|
||
* Enh #1281: Google Cloud Storage backend needs less permissions
|
||
* Enh #1319: Make `check` print `no errors found` explicitly
|
||
* Enh #1353: Retry failed backend requests
|
||
|
||
Details
|
||
-------
|
||
|
||
* Security #1445: Prevent writing outside the target directory during restore
|
||
|
||
A vulnerability was found in the restic restorer, which allowed attackers in special
|
||
circumstances to restore files to a location outside of the target directory. Due to the
|
||
circumstances we estimate this to be a low-risk vulnerability, but urge all users to upgrade to
|
||
the latest version of restic.
|
||
|
||
Exploiting the vulnerability requires a Linux/Unix system which saves backups via restic and
|
||
a Windows systems which restores files from the repo. In addition, the attackers need to be able
|
||
to create files with arbitrary names which are then saved to the restic repo. For example, by
|
||
creating a file named "..\test.txt" (which is a perfectly legal filename on Linux) and
|
||
restoring a snapshot containing this file on Windows, it would be written to the parent of the
|
||
target directory.
|
||
|
||
We'd like to thank Tyler Spivey for reporting this responsibly!
|
||
|
||
https://github.com/restic/restic/pull/1445
|
||
|
||
* Bugfix #1256: Re-enable workaround for S3 backend
|
||
|
||
We've re-enabled a workaround for `minio-go` (the library we're using to access s3 backends),
|
||
this reduces memory usage.
|
||
|
||
https://github.com/restic/restic/issues/1256
|
||
https://github.com/restic/restic/pull/1267
|
||
|
||
* Bugfix #1291: Reuse backend TCP connections to BackBlaze B2
|
||
|
||
A bug was discovered in the library we're using to access Backblaze, it now reuses already
|
||
established TCP connections which should be a lot faster and not cause network failures any
|
||
more.
|
||
|
||
https://github.com/restic/restic/issues/1291
|
||
https://github.com/restic/restic/pull/1301
|
||
|
||
* Bugfix #1317: Run prune when `forget --prune` is called with just snapshot IDs
|
||
|
||
A bug in the `forget` command caused `prune` not to be run when `--prune` was specified without a
|
||
policy, e.g. when only snapshot IDs that should be forgotten are listed manually.
|
||
|
||
https://github.com/restic/restic/pull/1317
|
||
|
||
* Bugfix #1437: Remove implicit path `/restic` for the s3 backend
|
||
|
||
The s3 backend used the subdir `restic` within a bucket if no explicit path after the bucket name
|
||
was specified. Since this version, restic does not use this default path any more. If you
|
||
created a repo on s3 in a bucket without specifying a path within the bucket, you need to add
|
||
`/restic` at the end of the repository specification to access your repo:
|
||
`s3:s3.amazonaws.com/bucket/restic`
|
||
|
||
https://github.com/restic/restic/issues/1292
|
||
https://github.com/restic/restic/pull/1437
|
||
|
||
* Enhancement #1102: Add subdirectory `ids` to fuse mount
|
||
|
||
The fuse mount now has an `ids` subdirectory which contains the snapshots below their (short)
|
||
IDs.
|
||
|
||
https://github.com/restic/restic/issues/1102
|
||
https://github.com/restic/restic/pull/1299
|
||
https://github.com/restic/restic/pull/1320
|
||
|
||
* Enhancement #1114: Add `--cacert` to specify TLS certificates to check against
|
||
|
||
We've added the `--cacert` option which can be used to pass one (or more) CA certificates to
|
||
restic. These are used in addition to the system CA certificates to verify HTTPS certificates
|
||
(e.g. for the REST backend).
|
||
|
||
https://github.com/restic/restic/issues/1114
|
||
https://github.com/restic/restic/pull/1276
|
||
|
||
* Enhancement #1216: Add upload/download limiting
|
||
|
||
We've added support for rate limiting through `--limit-upload` and `--limit-download`
|
||
flags.
|
||
|
||
https://github.com/restic/restic/issues/1216
|
||
https://github.com/restic/restic/pull/1336
|
||
https://github.com/restic/restic/pull/1358
|
||
|
||
* Enhancement #1271: Cache results for excludes for `backup`
|
||
|
||
The `backup` command now caches the result of excludes for a directory.
|
||
|
||
https://github.com/restic/restic/issues/1271
|
||
https://github.com/restic/restic/pull/1326
|
||
|
||
* Enhancement #1274: Add `generate` command, replaces `manpage` and `autocomplete`
|
||
|
||
The `generate` command has been added, which replaces the now removed commands `manpage` and
|
||
`autocomplete`. This release of restic contains the most recent manpages in `doc/man` and the
|
||
auto-completion files for bash and zsh in `doc/bash-completion.sh` and
|
||
`doc/zsh-completion.zsh`
|
||
|
||
https://github.com/restic/restic/issues/1274
|
||
https://github.com/restic/restic/pull/1282
|
||
|
||
* Enhancement #1367: Allow comments in files read from via `--file-from`
|
||
|
||
When the list of files/dirs to be saved is read from a file with `--files-from`, comment lines
|
||
(starting with `#`) are now ignored.
|
||
|
||
https://github.com/restic/restic/issues/1367
|
||
https://github.com/restic/restic/pull/1368
|
||
|
||
* Enhancement #448: Sftp backend prompts for password
|
||
|
||
The sftp backend now prompts for the password if a password is necessary for login.
|
||
|
||
https://github.com/restic/restic/issues/448
|
||
https://github.com/restic/restic/pull/1270
|
||
|
||
* Enhancement #510: Add `dump` command
|
||
|
||
We've added the `dump` command which prints a file from a snapshot to stdout. This can e.g. be
|
||
used to restore files read with `backup --stdin`.
|
||
|
||
https://github.com/restic/restic/issues/510
|
||
https://github.com/restic/restic/pull/1346
|
||
|
||
* Enhancement #1040: Add local metadata cache
|
||
|
||
We've added a local cache for metadata so that restic doesn't need to load all metadata
|
||
(snapshots, indexes, ...) from the repo each time it starts. By default the cache is active, but
|
||
there's a new global option `--no-cache` that can be used to disable the cache. By deafult, the
|
||
cache a standard cache folder for the OS, which can be overridden with `--cache-dir`. The cache
|
||
will automatically populate, indexes and snapshots are saved as they are loaded. Cache
|
||
directories for repos that haven't been used recently can automatically be removed by restic
|
||
with the `--cleanup-cache` option.
|
||
|
||
A related change was to by default create pack files in the repo that contain either data or
|
||
metadata, not both mixed together. This allows easy caching of only the metadata files. The
|
||
next run of `restic prune` will untangle mixed files automatically.
|
||
|
||
https://github.com/restic/restic/issues/29
|
||
https://github.com/restic/restic/issues/738
|
||
https://github.com/restic/restic/issues/282
|
||
https://github.com/restic/restic/pull/1040
|
||
https://github.com/restic/restic/pull/1287
|
||
https://github.com/restic/restic/pull/1436
|
||
https://github.com/restic/restic/pull/1265
|
||
|
||
* Enhancement #1249: Add `latest` symlink in fuse mount
|
||
|
||
The directory structure in the fuse mount now exposes a symlink `latest` which points to the
|
||
latest snapshot in that particular directory.
|
||
|
||
https://github.com/restic/restic/pull/1249
|
||
|
||
* Enhancement #1269: Add `--compact` to `forget` command
|
||
|
||
The option `--compact` was added to the `forget` command to provide the same compact view as the
|
||
`snapshots` command.
|
||
|
||
https://github.com/restic/restic/pull/1269
|
||
|
||
* Enhancement #1281: Google Cloud Storage backend needs less permissions
|
||
|
||
The Google Cloud Storage backend no longer requires the service account to have the
|
||
`storage.buckets.get` permission ("Storage Admin" role) in `restic init` if the bucket
|
||
already exists.
|
||
|
||
https://github.com/restic/restic/pull/1281
|
||
|
||
* Enhancement #1319: Make `check` print `no errors found` explicitly
|
||
|
||
The `check` command now explicetly prints `No errors were found` when no errors could be found.
|
||
|
||
https://github.com/restic/restic/issues/1303
|
||
https://github.com/restic/restic/pull/1319
|
||
|
||
* Enhancement #1353: Retry failed backend requests
|
||
|
||
https://github.com/restic/restic/pull/1353
|
||
|
||
|
||
Changelog for restic 0.7.3 (2017-09-20)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.7.3 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1246: List all files stored in Google Cloud Storage
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1246: List all files stored in Google Cloud Storage
|
||
|
||
For large backups stored in Google Cloud Storage, the `prune` command fails because listing
|
||
only returns the first 1000 files. This has been corrected, no data is lost in the process. In
|
||
addition, a plausibility check was added to `prune`.
|
||
|
||
https://github.com/restic/restic/issues/1246
|
||
https://github.com/restic/restic/pull/1247
|
||
|
||
|
||
Changelog for restic 0.7.2 (2017-09-13)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.7.2 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1167: Do not create a local repo unless `init` is used
|
||
* Fix #1164: Make the `key remove` command behave as documented
|
||
* Fix #1191: Make sure to write profiling files on interrupt
|
||
* Enh #1132: Make `key` command always prompt for a password
|
||
* Enh #1179: Resolve name conflicts, append a counter
|
||
* Enh #1218: Add `--compact` to `snapshots` command
|
||
* Enh #317: Add `--exclude-caches` and `--exclude-if-present`
|
||
* Enh #697: Automatically generate man pages for all restic commands
|
||
* Enh #1044: Improve `restore`, do not traverse/load excluded directories
|
||
* Enh #1061: Add Dockerfile and official Docker image
|
||
* Enh #1126: Use the standard Go git repository layout, use `dep` for vendoring
|
||
* Enh #1134: Add support for storing backups on Google Cloud Storage
|
||
* Enh #1144: Properly report errors when reading files with exclude patterns
|
||
* Enh #1149: Add support for storing backups on Microsoft Azure Blob Storage
|
||
* Enh #1196: Add `--group-by` to `forget` command for flexible grouping
|
||
* Enh #1203: Print stats on all BSD systems when SIGINFO (ctrl+t) is received
|
||
* Enh #1205: Allow specifying time/date for a backup with `--time`
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1167: Do not create a local repo unless `init` is used
|
||
|
||
When a restic command other than `init` is used with a local repository and the repository
|
||
directory does not exist, restic creates the directory structure. That's an error, only the
|
||
`init` command should create the dir.
|
||
|
||
https://github.com/restic/restic/issues/1167
|
||
https://github.com/restic/restic/pull/1182
|
||
|
||
* Bugfix #1164: Make the `key remove` command behave as documented
|
||
|
||
https://github.com/restic/restic/pull/1164
|
||
|
||
* Bugfix #1191: Make sure to write profiling files on interrupt
|
||
|
||
Since a few releases restic had the ability to write profiling files for memory and CPU usage
|
||
when `debug` is enabled. It was discovered that when restic is interrupted (ctrl+c is
|
||
pressed), the proper shutdown hook is not run. This is now corrected.
|
||
|
||
https://github.com/restic/restic/pull/1191
|
||
|
||
* Enhancement #1132: Make `key` command always prompt for a password
|
||
|
||
The `key` command now prompts for a password even if the original password to access a repo has
|
||
been specified via the `RESTIC_PASSWORD` environment variable or a password file.
|
||
|
||
https://github.com/restic/restic/issues/1132
|
||
https://github.com/restic/restic/pull/1133
|
||
|
||
* Enhancement #1179: Resolve name conflicts, append a counter
|
||
|
||
https://github.com/restic/restic/issues/1179
|
||
https://github.com/restic/restic/pull/1209
|
||
|
||
* Enhancement #1218: Add `--compact` to `snapshots` command
|
||
|
||
The option `--compact` was added to the `snapshots` command to get a better overview of the
|
||
snapshots in a repo. It limits each snapshot to a single line.
|
||
|
||
https://github.com/restic/restic/issues/1218
|
||
https://github.com/restic/restic/pull/1223
|
||
|
||
* Enhancement #317: Add `--exclude-caches` and `--exclude-if-present`
|
||
|
||
A new option `--exclude-caches` was added that allows excluding cache directories (that are
|
||
tagged as such). This is a special case of a more generic option `--exclude-if-present` which
|
||
excludes a directory if a file with a specific name (and contents) is present.
|
||
|
||
https://github.com/restic/restic/issues/317
|
||
https://github.com/restic/restic/pull/1170
|
||
https://github.com/restic/restic/pull/1224
|
||
|
||
* Enhancement #697: Automatically generate man pages for all restic commands
|
||
|
||
https://github.com/restic/restic/issues/697
|
||
https://github.com/restic/restic/pull/1147
|
||
|
||
* Enhancement #1044: Improve `restore`, do not traverse/load excluded directories
|
||
|
||
https://github.com/restic/restic/pull/1044
|
||
|
||
* Enhancement #1061: Add Dockerfile and official Docker image
|
||
|
||
https://github.com/restic/restic/pull/1061
|
||
|
||
* Enhancement #1126: Use the standard Go git repository layout, use `dep` for vendoring
|
||
|
||
The git repository layout was changed to resemble the layout typically used in Go projects,
|
||
we're not using `gb` for building restic any more and vendoring the dependencies is now taken
|
||
care of by `dep`.
|
||
|
||
https://github.com/restic/restic/pull/1126
|
||
|
||
* Enhancement #1134: Add support for storing backups on Google Cloud Storage
|
||
|
||
https://github.com/restic/restic/issues/211
|
||
https://github.com/restic/restic/pull/1134
|
||
https://github.com/restic/restic/pull/1052
|
||
|
||
* Enhancement #1144: Properly report errors when reading files with exclude patterns
|
||
|
||
https://github.com/restic/restic/pull/1144
|
||
|
||
* Enhancement #1149: Add support for storing backups on Microsoft Azure Blob Storage
|
||
|
||
The library we're using to access the service requires Go 1.8, so restic now needs at least Go
|
||
1.8.
|
||
|
||
https://github.com/restic/restic/issues/609
|
||
https://github.com/restic/restic/pull/1149
|
||
https://github.com/restic/restic/pull/1059
|
||
|
||
* Enhancement #1196: Add `--group-by` to `forget` command for flexible grouping
|
||
|
||
https://github.com/restic/restic/pull/1196
|
||
|
||
* Enhancement #1203: Print stats on all BSD systems when SIGINFO (ctrl+t) is received
|
||
|
||
https://github.com/restic/restic/pull/1203
|
||
https://github.com/restic/restic/pull/1082#issuecomment-326279920
|
||
|
||
* Enhancement #1205: Allow specifying time/date for a backup with `--time`
|
||
|
||
https://github.com/restic/restic/pull/1205
|
||
|
||
|
||
Changelog for restic 0.7.1 (2017-07-22)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.7.1 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1115: Fix `prune`, only include existing files in indexes
|
||
* Enh #1055: Create subdirs below `data/` for local/sftp backends
|
||
* Enh #1067: Allow loading credentials for s3 from IAM
|
||
* Enh #1073: Add `migrate` cmd to migrate from `s3legacy` to `default` layout
|
||
* Enh #1081: Clarify semantic for `--tasg` for the `forget` command
|
||
* Enh #1080: Ignore chmod() errors on filesystems which do not support it
|
||
* Enh #1082: Print stats on SIGINFO on Darwin and FreeBSD (ctrl+t)
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1115: Fix `prune`, only include existing files in indexes
|
||
|
||
A bug was found (and corrected) in the index rebuilding after prune, which led to indexes which
|
||
include blobs that were not present in the repo any more. There were already checks in place
|
||
which detected this situation and aborted with an error message. A new run of either `prune` or
|
||
`rebuild-index` corrected the index files. This is now fixed and a test has been added to detect
|
||
this.
|
||
|
||
https://github.com/restic/restic/pull/1115
|
||
|
||
* Enhancement #1055: Create subdirs below `data/` for local/sftp backends
|
||
|
||
The local and sftp backends now create the subdirs below `data/` on open/init. This way, restic
|
||
makes sure that they always exist. This is connected to an issue for the sftp server.
|
||
|
||
https://github.com/restic/restic/issues/1055
|
||
https://github.com/restic/rest-server/pull/11#issuecomment-309879710
|
||
https://github.com/restic/restic/pull/1077
|
||
https://github.com/restic/restic/pull/1105
|
||
|
||
* Enhancement #1067: Allow loading credentials for s3 from IAM
|
||
|
||
When no S3 credentials are specified in the environment variables, restic now tries to load
|
||
credentials from an IAM instance profile when the s3 backend is used.
|
||
|
||
https://github.com/restic/restic/issues/1067
|
||
https://github.com/restic/restic/pull/1086
|
||
|
||
* Enhancement #1073: Add `migrate` cmd to migrate from `s3legacy` to `default` layout
|
||
|
||
The `migrate` command for changing the `s3legacy` layout to the `default` layout for s3
|
||
backends has been improved: It can now be restarted with `restic migrate --force s3_layout`
|
||
and automatically retries operations on error.
|
||
|
||
https://github.com/restic/restic/issues/1073
|
||
https://github.com/restic/restic/pull/1075
|
||
|
||
* Enhancement #1081: Clarify semantic for `--tasg` for the `forget` command
|
||
|
||
https://github.com/restic/restic/issues/1081
|
||
https://github.com/restic/restic/pull/1090
|
||
|
||
* Enhancement #1080: Ignore chmod() errors on filesystems which do not support it
|
||
|
||
https://github.com/restic/restic/pull/1080
|
||
https://github.com/restic/restic/pull/1112
|
||
|
||
* Enhancement #1082: Print stats on SIGINFO on Darwin and FreeBSD (ctrl+t)
|
||
|
||
https://github.com/restic/restic/pull/1082
|
||
|
||
|
||
Changelog for restic 0.7.0 (2017-07-01)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.7.0 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Fix #1013: Switch back to using the high-level minio-go API for s3
|
||
* Fix #965: Switch to `default` repo layout for the s3 backend
|
||
* Enh #1021: Detect invalid backend name and print error
|
||
* Enh #1029: Remove invalid pack files when `prune` is run
|
||
* Enh #512: Add Backblaze B2 backend
|
||
* Enh #636: Add dirs `tags` and `hosts` to fuse mount
|
||
* Enh #989: Improve performance of the `find` command
|
||
* Enh #975: Add new backend for OpenStack Swift
|
||
* Enh #998: Improve performance of the fuse mount
|
||
|
||
Details
|
||
-------
|
||
|
||
* Bugfix #1013: Switch back to using the high-level minio-go API for s3
|
||
|
||
For the s3 backend we're back to using the high-level API the s3 client library for uploading
|
||
data, a few users reported dropped connections (which the library will automatically retry
|
||
now).
|
||
|
||
https://github.com/restic/restic/issues/1013
|
||
https://github.com/restic/restic/issues/1023
|
||
https://github.com/restic/restic/pull/1025
|
||
|
||
* Bugfix #965: Switch to `default` repo layout for the s3 backend
|
||
|
||
The default layout for the s3 backend is now `default` (instead of `s3legacy`). Also, there's a
|
||
new `migrate` command to convert an existing repo, it can be run like this: `restic migrate
|
||
s3_layout`
|
||
|
||
https://github.com/restic/restic/issues/965
|
||
https://github.com/restic/restic/pull/1004
|
||
|
||
* Enhancement #1021: Detect invalid backend name and print error
|
||
|
||
Restic now tries to detect when an invalid/unknown backend is used and returns an error
|
||
message.
|
||
|
||
https://github.com/restic/restic/issues/1021
|
||
https://github.com/restic/restic/pull/1070
|
||
|
||
* Enhancement #1029: Remove invalid pack files when `prune` is run
|
||
|
||
The `prune` command has been improved and will now remove invalid pack files, for example files
|
||
that have not been uploaded completely because a backup was interrupted.
|
||
|
||
https://github.com/restic/restic/issues/1029
|
||
https://github.com/restic/restic/pull/1036
|
||
|
||
* Enhancement #512: Add Backblaze B2 backend
|
||
|
||
https://github.com/restic/restic/issues/512
|
||
https://github.com/restic/restic/pull/978
|
||
|
||
* Enhancement #636: Add dirs `tags` and `hosts` to fuse mount
|
||
|
||
The fuse mount now has two more directories: `tags` contains a subdir for each tag, which in turn
|
||
contains only the snapshots that have this tag. The subdir `hosts` contains a subdir for each
|
||
host that has a snapshot, and the subdir contains the snapshots for that host.
|
||
|
||
https://github.com/restic/restic/issues/636
|
||
https://github.com/restic/restic/pull/1050
|
||
|
||
* Enhancement #989: Improve performance of the `find` command
|
||
|
||
Improved performance for the `find` command: Restic recognizes paths it has already checked
|
||
for the files in question, so the number of backend requests is reduced a lot.
|
||
|
||
https://github.com/restic/restic/issues/989
|
||
https://github.com/restic/restic/pull/993
|
||
|
||
* Enhancement #975: Add new backend for OpenStack Swift
|
||
|
||
https://github.com/restic/restic/pull/975
|
||
https://github.com/restic/restic/pull/648
|
||
|
||
* Enhancement #998: Improve performance of the fuse mount
|
||
|
||
Listing directories which contain large files now is significantly faster.
|
||
|
||
https://github.com/restic/restic/pull/998
|
||
|
||
|
||
Changelog for restic 0.6.1 (2017-06-01)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.6.1 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Enh #985: Allow multiple parallel idle HTTP connections
|
||
* Enh #981: Remove temporary path from binary in `build.go`
|
||
* Enh #974: Remove regular status reports
|
||
|
||
Details
|
||
-------
|
||
|
||
* Enhancement #985: Allow multiple parallel idle HTTP connections
|
||
|
||
Backends based on HTTP now allow several idle connections in parallel. This is especially
|
||
important for the REST backend, which (when used with a local server) may create a lot
|
||
connections and exhaust available ports quickly.
|
||
|
||
https://github.com/restic/restic/issues/985
|
||
https://github.com/restic/restic/pull/986
|
||
|
||
* Enhancement #981: Remove temporary path from binary in `build.go`
|
||
|
||
The `build.go` now strips the temporary directory used for compilation from the binary. This
|
||
is the first step in enabling reproducible builds.
|
||
|
||
https://github.com/restic/restic/pull/981
|
||
|
||
* Enhancement #974: Remove regular status reports
|
||
|
||
Regular status report: We've removed the status report that was printed every 10 seconds when
|
||
restic is run non-interactively. You can still force reporting the current status by sending a
|
||
`USR1` signal to the process.
|
||
|
||
https://github.com/restic/restic/pull/974
|
||
|
||
|
||
Changelog for restic 0.6.0 (2017-05-29)
|
||
=======================================
|
||
|
||
The following sections list the changes in restic 0.6.0 relevant to
|
||
restic users. The changes are ordered by importance.
|
||
|
||
Summary
|
||
-------
|
||
|
||
* Enh #957: Make `forget` consistent
|
||
* Enh #966: Unify repository layout for all backends
|
||
* Enh #962: Improve memory and runtime for the s3 backend
|
||
|
||
Details
|
||
-------
|
||
|
||
* Enhancement #957: Make `forget` consistent
|
||
|
||
The `forget` command was corrected to be more consistent in which snapshots are to be
|
||
forgotten. It is possible that the new code removes more snapshots than before, so please
|
||
review what would be deleted by using the `--dry-run` option.
|
||
|
||
https://github.com/restic/restic/issues/953
|
||
https://github.com/restic/restic/pull/957
|
||
|
||
* Enhancement #966: Unify repository layout for all backends
|
||
|
||
Up to now the s3 backend used a special repository layout. We've decided to unify the repository
|
||
layout and implemented the default layout also for the s3 backend. For creating a new
|
||
repository on s3 with the default layout, use `restic -o s3.layout=default init`. For further
|
||
commands the option is not necessary any more, restic will automatically detect the correct
|
||
layout to use. A future version will switch to the default layout for new repositories.
|
||
|
||
https://github.com/restic/restic/issues/965
|
||
https://github.com/restic/restic/pull/966
|
||
|
||
* Enhancement #962: Improve memory and runtime for the s3 backend
|
||
|
||
We've updated the library used for accessing s3, switched to using a lower level API and added
|
||
caching for some requests. This lead to a decrease in memory usage and a great speedup. In
|
||
addition, we added benchmark functions for all backends, so we can track improvements over
|
||
time. The Continuous Integration test service we're using (Travis) now runs the s3 backend
|
||
tests not only against a Minio server, but also against the Amazon s3 live service, so we should
|
||
be notified of any regressions much sooner.
|
||
|
||
https://github.com/restic/restic/pull/962
|
||
https://github.com/restic/restic/pull/960
|
||
https://github.com/restic/restic/pull/946
|
||
https://github.com/restic/restic/pull/938
|
||
https://github.com/restic/restic/pull/883
|
||
|
||
|