mirror of
https://github.com/borgbackup/borg.git
synced 2024-12-26 09:47:58 +00:00
dfc5e915cc
locking: fix ExclusiveLock race condition bug, fixes #4923 - ExclusiveLock is now based on os.rename instead of os.mkdir. - catch FileNotFoundError observed under race condition in ExclusiveLock.release() and .kill_stale_lock() - added TestExclusiveLock.test_race_condition() which reveals issue #4923 - updated docs - locking: use "raise LockTimeout from None" for prettier traceback Co-authored-by: Thomas Portmann <thomas@portmann.org> Co-authored-by: Thomas Waldmann <tw@waldmann-edv.de>
29 lines
1.3 KiB
HTML
29 lines
1.3 KiB
HTML
File systems
|
|
~~~~~~~~~~~~
|
|
|
|
We strongly recommend against using Borg (or any other database-like
|
|
software) on non-journaling file systems like FAT, since it is not
|
|
possible to assume any consistency in case of power failures (or a
|
|
sudden disconnect of an external drive or similar failures).
|
|
|
|
While Borg uses a data store that is resilient against these failures
|
|
when used on journaling file systems, it is not possible to guarantee
|
|
this with some hardware -- independent of the software used. We don't
|
|
know a list of affected hardware.
|
|
|
|
If you are suspicious whether your Borg repository is still consistent
|
|
and readable after one of the failures mentioned above occurred, run
|
|
``borg check --verify-data`` to make sure it is consistent.
|
|
|
|
.. rubric:: Requirements for Borg repository file systems
|
|
|
|
- Long file names
|
|
- At least three directory levels with short names
|
|
- Typically, file sizes up to a few hundred MB.
|
|
Large repositories may require large files (>2 GB).
|
|
- Up to 1000 files per directory (10000 for repositories initialized with Borg 1.0)
|
|
- rename(2) / MoveFile(Ex) should work as specified, i.e. on the same file system
|
|
it should be a move (not a copy) operation, and in case of a directory
|
|
it should fail if the destination exists and is not an empty directory,
|
|
since this is used for locking.
|
|
- Hardlinks are needed for :ref:`borg_upgrade` ``--inplace``
|