.\" 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-benchmark-crud" "1" "2026-07-18" "" "borg backup tool"
.SH "نام (NAME)"
borg-benchmark-crud \- سنجش کارایی ایجاد، خواندن، به‌روزرسانی و حذف برای آرشیوها
.SH "خلاصه دستور (SYNOPSIS)"
.sp
borg [common options] benchmark crud [options] REPOSITORY PATH
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور عملیات CRUD (ایجاد، خواندن، به‌روزرسانی، حذف) در borg را محک (بنچمارک) می‌زند.
.sp
این ابزار داده‌های ورودی را در زیرِ PATH مشخص‌شده ایجاد کرده و از آن‌ها در REPO داده‌شده نسخه پشتیبان تهیه می‌کند.
مخزن REPO باید از پیش موجود باشد (می‌تواند یک مخزن تازه و خالی یا یک مخزن موجود باشد؛ این دستور تعدادی آرشیو با نام borg\-benchmark\-crud* در آن ایجاد / خوانده / به‌روزرسانی / حذف خواهد کرد).
.sp
اطمینان حاصل کنید که فضای خالی کافی در آنجا دارید، به ازای هر مورد به حدود ۱ گیگابایت فضا (+ سربار) نیاز خواهید داشت.
.sp
اگر مخزن شما رمزگذاری شده است و borg برای باز کردن قفل کلید به عبارت عبور (passphrase) نیاز دارد، از دستور زیر استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
BORG_PASSPHRASE=mysecret borg benchmark crud REPO PATH
.EE
.UNINDENT
.UNINDENT
.sp
اندازه‌گیری‌ها با مقادیر و اندازه‌های متفاوتی از فایل‌های ورودی انجام می‌شوند.
محتوای فایل‌ها کاملاً مصنوعی است (یا تماماً صفر یا کاملاً تصادفی)،
بنابراین نتایج اندازه‌گیری لزوماً بازتاب‌دهنده عملکرد با داده‌های واقعی نیست.
همچنین، با توجه به نوع محتوای استفاده‌شده، هیچ فشرده‌سازی در این بنچمارک‌ها اعمال نمی‌شود.
.INDENT 0.0
.TP
.B C\- == borg create (ساخت اولین آرشیو، بدون فشرده‌سازی، بدون استفاده از files cache)
C\-Z\- == فایل‌های تماماً صفر. deduplication کامل؛ این مورد عمدتاً عملکرد reader/chunker/hasher را می‌سنجد.
C\-R\- == فایل‌های تصادفی. بدون deduplication، سنجش توان عملیاتی در تمام مراحل پردازش.
.TP
.B R\- == borg extract (استخراج آرشیو، اجرای آزمایشی dry\-run، انجام تمام مراحل بدون نوشتن فایل‌ها روی دیسک)
R\-Z\- == فایل‌های تماماً صفر. سنجش فایل‌هایی با تکرار بسیار بالا.
R\-R\- == فایل‌های تصادفی. بدون داده‌های تکراری، سنجش توان عملیاتی در تمام مراحل پردازش به‌جز نوشتن روی دیسک.
.TP
.B U\- == borg create (ساخت دومین آرشیو از فایل‌های ورودیِ دست‌نخورده، سنجش سرعت files cache)
مقدار توان عملیاتی در اینجا تا حدی مجازی است، چرا که در واقع فایل را بازخوانی نمی‌کند.
U\-Z\- == نیازمند بررسی وجود دو قطعه‌ی (chunk) تماماً صفر در مخزن است.
U\-R\- == نیازمند بررسی وجود تعداد زیادی قطعه‌ی (chunks) متفاوت در مخزن است.
.TP
.B D\- == borg delete archive (حذف آخرین آرشیو باقی‌مانده، سنجش عملیات حذف + یکپارچه‌سازی compaction)
D\-Z\- == قطعه‌های (chunks) اندک برای حذف / سگمنت‌های (segments) اندک برای یکپارچه‌سازی/حذف.
D\-R\- == قطعه‌های (chunks) بسیار برای حذف / سگمنت‌های (segments) بسیار برای یکپارچه‌سازی/حذف.
.UNINDENT
.sp
لطفاً توجه داشته باشید که ممکن است نوسان و پراکندگی قابل‌توجهی در این اندازه‌گیری‌ها وجود داشته باشد.
اندازه‌گیری را چندین بار تکرار کنید و سیستم (و در صورت استفاده، شبکه) را در حالت بیکار (idle) قرار دهید.
.SH "گزینه‌ها (OPTIONS)"
.sp
برای مشاهده گزینه‌های عمومی دستورهای Borg، به \fIborg\-common(1)\fP مراجعه کنید.
.SS "آرگومان‌ها (arguments)"
.INDENT 0.0
.TP
.B REPOSITORY
مخزن مورد استفاده برای بنچمارک (باید از قبل وجود داشته باشد)
.TP
.B PATH
مسیری که داده‌های ورودی بنچمارک در آن ایجاد می‌شوند
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fIborg\-common(1)\fP
.SH "نویسندگان (AUTHORS)"
The Borg Collective
.\" End of generated man page.