borgbackup / borgbackup/borg

borg check should take "notes"

Open
#10,356 1 comment 0 reactions 0 assignees View on GitHub
cmd: check
Dominant language
Python
Stars
13.7k
Forks
875
Avg merge
11h 15m
Merged PRs (30d)
192

Description

Many borg users will use regularly scheduled `borg create` and `borg check` jobs to create and verify their backups.

If there is a lot of data in the repo, `borg check` will take a long time, but that should not be a problem because it runs unattended and also its runtime can be limited.

BUT, if there are issues with a repository (e.g. the check job detecting something), usually the repo admin will try to fix issues interactively and interactive operations should be fast.

That means:
- we should not need to run a full `borg check` again (processing all packs / all objects in the repo)
- `borg check [--repair]` should re-use intelligence that previous `borg check` runs have gathered (e.g. IDs of corrupt packs, IDs of corrupt or missing objects)
- `borg create` could have a special treatment (re-chunk them!) for paths of files that were noted as corrupted or containing missing chunks by `borg check`.

Contributor guide

Open the contributing guide

Research direction

Start by tracing the `borg check` and `borg create` command entry points and how they currently process repository packs, objects, and file paths. The issue is done when a defined notes mechanism lets later check or repair operations reuse prior findings and allows create to re-chunk affected paths, with behavior and scope agreed first.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
cli
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.