borg/docs/usage/general
Thomas Waldmann 07b8d0271c
locking: BORG_LOCK_RECHECK_DELAY sets the race recheck delay, fixes #9899
acquire() creates its lock object, waits for the race recheck delay and
lists the lock objects again to detect other clients racing for the lock.

With list-after-write consistency (local filesystems, sftp, rest, AWS S3,
MinIO), at least the client that created its lock object last sees the
other's lock in its second listing, so the delay is not needed for
correctness and the 0.01s default stays.

Stores that only list a new object after a lag (e.g. NFS clients caching
directory listings, some cloud storages via rclone) need a delay of at
least that lag. That lag is a property of the storage, not of the request
latency, so it is not measured, but set via BORG_LOCK_RECHECK_DELAY.
Invalid values abort with an error.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-05 23:04:09 +02:00
..
archive-specification.rst.inc docs: archive specification, FAQ, fixes #9248, fixes #9053 2026-03-06 21:36:05 +01:00
config.rst.inc docs: fix borg1-era content in quickstart, general includes and misc 2026-08-28 12:38:31 +02:00
date-time.rst.inc Renames --since to --from 2026-06-20 18:36:59 +02:00
environment.rst.inc locking: BORG_LOCK_RECHECK_DELAY sets the race recheck delay, fixes #9899 2026-10-05 23:04:09 +02:00
file-metadata.rst.inc illumos/Solaris: add xattr support, see #1337 2026-08-14 16:47:22 +02:00
file-systems.rst.inc docs: ssh:// repository URLs, #9765 2026-09-24 15:55:01 +02:00
logging.rst.inc fixed typos and grammar (AI) 2025-09-23 14:56:23 +02:00
positional-arguments.rst.inc docs: fix borg1-era content in quickstart, general includes and misc 2026-08-28 12:38:31 +02:00
repository-locations.rst.inc manual corrections/reverts 2025-09-23 14:56:35 +02:00
repository-urls.rst.inc docs: ssh:// repository URLs, #9765 2026-09-24 15:55:01 +02:00
resources.rst.inc docs: fix borg1-era content in quickstart, general includes and misc 2026-08-28 12:38:31 +02:00
return-codes.rst.inc Fix return code docs 2026-07-24 12:24:20 +02:00
units.rst.inc docs: fix borg1-era content in quickstart, general includes and misc 2026-08-28 12:38:31 +02:00