Browse Source

docs: document behavior for filesystems with inconsistent inodes, fixes borgbackup#5770 (#5965)

Jubjub 3 years ago
parent
commit
0393cfac6c
1 changed files with 6 additions and 0 deletions
  1. 6 0
      docs/faq.rst

+ 6 - 0
docs/faq.rst

@@ -987,6 +987,12 @@ stable. If the directory where you mount a filesystem is different every time,
 Borg assumes they are different files. This is true even if you backup these
 files with relative pathnames - borg uses full pathnames in files cache regardless.
 
+It is possible for some filesystems, such as ``mergerfs`` or network filesystems,
+to return inconsistent inode numbers across runs, causing borg to consider them changed.
+A workaround is to set the option ``--files-cache=ctime,size`` to exclude the inode
+number comparison from the files cache check so that files with different inode
+numbers won't be treated as modified.
+
 
 Is there a way to limit bandwidth with Borg?
 --------------------------------------------