From ef39dc6554e1e7a8dc747cffcd556af026d79975 Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Sat, 25 Nov 2017 20:08:33 +0100 Subject: [PATCH] docs: move bsdflags tuning comments to notes docs section the atime comments are already there. (cherry picked from commit 91ff2f81a6a64523f433eab7334eb79b81857cc2) --- docs/usage/notes.rst | 10 ++++++++++ src/borg/archiver.py | 6 ------ 2 files changed, 10 insertions(+), 6 deletions(-) diff --git a/docs/usage/notes.rst b/docs/usage/notes.rst index 4342a8c12..d5415d0e9 100644 --- a/docs/usage/notes.rst +++ b/docs/usage/notes.rst @@ -61,6 +61,16 @@ affect metadata stream deduplication: if only this timestamp changes between backups and is stored into the metadata stream, the metadata stream chunks won't deduplicate just because of that. +``--nobsdflags`` +~~~~~~~~~~~~~~~~ + +You can use this to not query and store (or not extract and set) bsdflags - +in case you don't need them or if they are broken somehow for your fs. + +On Linux, dealing with the bsflags needs some additional syscalls. +Especially when dealing with lots of small files, this causes a noticable +overhead, so you can use this option also for speeding up operations. + ``--umask`` ~~~~~~~~~~~ diff --git a/src/borg/archiver.py b/src/borg/archiver.py index d99822d4f..13fc3db2a 100644 --- a/src/borg/archiver.py +++ b/src/borg/archiver.py @@ -2952,12 +2952,6 @@ class Archiver: it had before a content change happened. This can be used maliciously as well as well-meant, but in both cases mtime based cache modes can be problematic. - By default, borg tries to archive all metadata that it supports archiving. - If that is not what you want or need, there are some tuning options: - - - --nobsdflags (getting bsdflags has a speed penalty under Linux) - - --noatime (if atime changes frequently, the metadata stream will dedup badly) - The mount points of filesystems or filesystem snapshots should be the same for every creation of a new archive to ensure fast operation. This is because the file cache that is used to determine changed files quickly uses absolute filenames.