| borg-with-lock(1) | borg backup tool | borg-with-lock(1) |
Name¶
borg-with-lock - Runs a user-specified command with the repository lock held.
SYNOPSIS¶
borg [common options] with-lock [options] COMMAND [ARGS...]
DESCRIPTION¶
This command runs a user-specified command while locking the repository. For example:
$ BORG_REPO=/mnt/borgrepo borg with-lock rsync -av /mnt/borgrepo /somewhere/else/borgrepo
It first tries to acquire the lock (make sure that no other operation is running in the repository), then executes the given command as a subprocess and waits for its termination, releases the lock, and returns the user command's return code as Borg's return code.
Note:
If you copy a repository with the lock held, the lock
will be present in the copy. Before using Borg on the copy from a different
host, you need to run borg break-lock on the copied repository, because
Borg is cautious and does not automatically remove stale locks made by a
different host.
OPTIONS¶
See borg-common(1) for common options of Borg commands.
arguments¶
SEE ALSO¶
Author¶
The Borg Collective
| 2025-12-24 |