Skip to content

Drop borgfs runtime warning about symlinks and improve corresponding docs#9859

Merged
ThomasWaldmann merged 2 commits into
borgbackup:1.4-maintfrom
PhrozenByte:drop-symlink-mount-warning
Jul 4, 2026
Merged

Drop borgfs runtime warning about symlinks and improve corresponding docs#9859
ThomasWaldmann merged 2 commits into
borgbackup:1.4-maintfrom
PhrozenByte:drop-symlink-mount-warning

Conversation

@PhrozenByte

@PhrozenByte PhrozenByte commented Jul 4, 2026

Copy link
Copy Markdown
Contributor
  1. 46ed8bd: Drop non-actionable borgfs runtime warning about symlinks
  2. e3f7eb7: Improve and highlight docs note about borgfs symlink behaviour

Reasoning see #9254 (comment)

@codecov

codecov Bot commented Jul 4, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 82.04%. Comparing base (0c6e8e1) to head (e3f7eb7).
⚠️ Report is 1 commits behind head on 1.4-maint.

Additional details and impacted files
@@              Coverage Diff              @@
##           1.4-maint    #9859      +/-   ##
=============================================
- Coverage      82.06%   82.04%   -0.03%     
=============================================
  Files             38       38              
  Lines          11383    11383              
  Branches        1794     1794              
=============================================
- Hits            9342     9339       -3     
- Misses          1459     1461       +2     
- Partials         582      583       +1     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

@ThomasWaldmann ThomasWaldmann left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the PR - hopefully some people will read the docs and learn about nosymfollow and the dangers of mounted filesystems with symlinks in general.

Comment thread src/borg/archiver.py
``nosymfollow`` VFS mount option, for example:

borg mount <repo path> <mountpoint>
mount -o remount,nosymfollow <repo path> <mountpoint>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

TIL nosymfollow, thanks!

Comment thread src/borg/fuse.py
user=dir_user, group=dir_group, uid=dir_uid, gid=dir_gid)
self._create_filesystem()
llfuse.init(self, mountpoint, options)
logger.warning('Warning: The mounted archive is capable of containing symlinks that point outside the archive tree. When following such symlinks you may see files and directories within the mountpoint that do not reflect the archive content.')

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

guess "mount also does not show such a warning" is the reason why "borg mount" should also not do that.

@ThomasWaldmann
ThomasWaldmann merged commit c908d24 into borgbackup:1.4-maint Jul 4, 2026
12 of 14 checks passed
@ThomasWaldmann

Copy link
Copy Markdown
Member

Can you check master branch please and do a forward port?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants