borg/docs/usage/with-lock.rst.inc

34 lines
941 B
PHP
Raw Normal View History

2016-07-05 23:33:53 +00:00
.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
2016-04-27 23:28:43 +00:00
.. _borg_with-lock:
borg with-lock
--------------
.. code-block:: none
2016-04-27 23:28:43 +00:00
borg [common options] with-lock [options] REPOSITORY COMMAND ARGS
2016-04-27 23:28:43 +00:00
positional arguments
REPOSITORY
repository to lock
COMMAND
command to run
ARGS
command arguments
2017-06-06 22:06:36 +00:00
:ref:`common_options`
2016-04-27 23:28:43 +00:00
|
Description
~~~~~~~~~~~
This command runs a user-specified command while the repository lock is held.
It will first try to acquire the lock (make sure that no other operation is
running in the repo), then execute the given command as a subprocess and wait
for its termination, release the lock and return 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, obviously. Thus, before using borg on the copy, you need to
2017-03-26 23:45:45 +00:00
use "borg break-lock" on it.