mirror of
https://github.com/borgbackup/borg.git
synced 2024-12-27 10:18:12 +00:00
19aa9825a8
general.rst and man_intro.rst both included usage_general.rst.inc, which resulted in three Sphinx warning "WARNING: duplicate label". To prevent this we move all sections of usage_general into own include files and add a second usage_general file without the three labels.
26 lines
1.1 KiB
HTML
26 lines
1.1 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)
|
|
- mkdir(2) should be atomic, since it is used for locking
|
|
- Hardlinks are needed for :ref:`borg_upgrade` ``--inplace``
|