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

62 lines
2.4 KiB
HTML

.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
.. _borg_with-lock:
borg with-lock
--------------
.. code-block:: none
borg [common options] with-lock [options] REPOSITORY COMMAND [ARGS...]
.. only:: html
.. class:: borg-options-table
+-------------------------------------------------------+----------------+--------------------+
| **positional arguments** |
+-------------------------------------------------------+----------------+--------------------+
| | ``REPOSITORY`` | repository to lock |
+-------------------------------------------------------+----------------+--------------------+
| | ``COMMAND`` | command to run |
+-------------------------------------------------------+----------------+--------------------+
| | ``ARGS`` | command arguments |
+-------------------------------------------------------+----------------+--------------------+
| .. class:: borg-common-opt-ref |
| |
| :ref:`common_options` |
+-------------------------------------------------------+----------------+--------------------+
.. raw:: html
<script type='text/javascript'>
$(document).ready(function () {
$('.borg-options-table colgroup').remove();
})
</script>
.. only:: latex
REPOSITORY
repository to lock
COMMAND
command to run
ARGS
command arguments
:ref:`common_options`
|
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.
As example you can use "borg with-lock" to copy a repo to another location
(see :ref:`can_i_copy_or_synchronize_my_repo_to_another_location` in the FAQ).