.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "borg-with-lock" "1" "2026-07-18" "" "ابزار پشتیبان‌گیری borg"
.SH "نام (NAME)"
borg-with-lock \- اجرای دستور سفارشی با حفظ قفل انحصاری مخزن
.SH "خلاصه دستور (SYNOPSIS)"
.sp
borg [گزینه‌های عمومی] with\-lock [گزینه‌ها] REPOSITORY COMMAND [ARGS...]
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور، یک دستور مشخص‌شده توسط کاربر را در حین قفل نگه داشتن مخزن اجرا می‌کند. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ borg with\-lock /mnt/borgrepo rsync \-av /mnt/borgrepo /somewhere/else/borgrepo
.EE
.UNINDENT
.UNINDENT
.sp
این دستور ابتدا تلاش می‌کند قفل را به دست آورد (تا اطمینان حاصل شود که هیچ عملیات دیگری در مخزن در حال اجرا نیست)، سپس دستور داده‌شده را به‌عنوان یک زیرفرآیند (subprocess) اجرا کرده و منتظر خاتمه آن می‌ماند، قفل را آزاد می‌کند، و در نهایت کد بازگشتی دستور کاربر را به عنوان کد بازگشتی Borg برمی‌گرداند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر یک مخزن را در حالی که قفل آن برقرار است کپی کنید، قفل در نسخه کپی‌شده نیز باقی خواهد ماند. بنابراین، پیش از استفاده از Borg روی نسخه کپی از طریق یک میزبان دیگر، باید از دستور
\(dqborg break\-lock\(dq
روی مخزن کپی‌شده استفاده کنید، چرا که Borg محتاط است و قفل‌های معلق ایجادشده توسط میزبانی دیگر را به طور خودکار حذف نمی‌کند.
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.sp
برای مشاهده گزینه‌های عمومی دستورات Borg، به \fIborg\-common(1)\fP مراجعه کنید.
.SS "آرگومان‌ها (arguments)"
.INDENT 0.0
.TP
.B REPOSITORY
مخزنی که باید قفل شود
.TP
.B COMMAND
دستوری که باید اجرا شود
.TP
.B ARGS
آرگومان‌های دستور
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fIborg\-common(1)\fP
.SH "نویسنده (Author)"
The Borg Collective
.\" End of generated man page.