'\" t
.\"     Title: git-backfill
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-06-29
.\"    Manual: راهنمای گیت
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-BACKFILL" "1" "2026\-06\-29" "Git 2\&.55\&.0" "دستورات عمومی کاربر"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
git-backfill \- دانلود اشیای گمشده در کلون‌های کم‌عمق یا جزیی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBgit\fR \fBbackfill\fR [\fB\-\-min\-batch\-size=\fR\fI<n>\fR] [\fB\-\-\fR[\fBno\-\fR]\fBsparse\fR] [\fB\-\-\fR[\fBno\-\fR]\fBinclude\-edges\fR] [\fI<revision\-range>\fR]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
کلون‌های جزئی بدون بلاب (Blobless partial clones) با استفاده از
\fBgit\fR \fBclone\fR \fB\-\-filter=blob:none\fR
ایجاد می‌شوند و سپس مخزن محلی را به گونه‌ای پیکربندی می‌کنند که کلاینت گیت از دانلود اشیاء blob خودداری کند، مگر اینکه برای یک عملیات محلی مورد نیاز باشند\&. این در ابتدا بدین معناست که کلون و دریافت‌های بعدی (fetches)، کامیت‌ها و درخت‌های در دسترس را دانلود می‌کنند اما هیچ blobای دانلود نمی‌شود\&. عملیات بعدی که اشاره‌گر
\fBHEAD\fR
را تغییر می‌دهند، مانند
\fBgit\fR \fBcheckout\fR
یا
\fBgit\fR \fBmerge\fR،
ممکن است برای تکمیل عملیات خود نیاز به دانلود blobهای گمشده داشته باشند\&.
.sp
در بدترین حالت‌ها، دستوراتی که تفاضل (diff) بلاب‌ها را محاسبه می‌کنند، مانند
\fBgit\fR \fBblame\fR،
بسیار کند می‌شوند زیرا برای تامین شیء ناموجود به محض نیاز دستور گیت، blobهای گمشده را در قالب درخواست‌های تک‌بلابی دانلود می‌کنند\&. این امر منجر به درخواست‌های دانلود متعدد می‌شود و سرور گیت امکان ارائه فشرده‌سازی دلتا (delta compression) روی آن اشیاء را نخواهد داشت\&.
.sp
دستور
\fBgit\fR \fBbackfill\fR
روشی را برای کاربر فراهم می‌کند تا از گیت درخواست کند blobهای گمشده را (با فیلترهای اختیاری) دانلود کند، به طوری که blobهای گمشده‌ای که نسخه‌های پیشین فایل‌ها را نشان می‌دهند بتوانند به‌صورت دسته‌ای دانلود شوند\&. دستور
\fBbackfill\fR
تلاش می‌کند تا با گروه‌بندی blobهایی که در یک مسیر یکسان قرار دارند، این درخواست را بهینه‌سازی کند که امید می‌رود منجر به فشرده‌سازی دلتای مناسب در packfile ارسال‌شده توسط سرور شود\&.
.sp
به این ترتیب،
\fBgit\fR \fBbackfill\fR
سازوکاری برای تقسیم یک کلون بزرگ به بخش‌های کوچک‌تر ارائه می‌دهد\&. شروع با یک کلون جزئی بدون بلاب با
\fBgit\fR \fBclone\fR \fB\-\-filter=blob:none\fR
و سپس اجرای
\fBgit\fR \fBbackfill\fR
در مخزن محلی، راهکاری فراهم می‌آورد تا به جای دانلود کل مخزن در زمان کلون کردن، تمامی اشیاء قابل دسترس از طریق چند فراخوانی شبکه کوچک‌تر دانلود شوند\&.
.sp
به‌طور پیش‌فرض،
\fBgit\fR \fBbackfill\fR
تمام blobهای قابل دسترس از کامیت
\fBHEAD\fR
را دانلود می‌کند\&. این مجموعه می‌تواند با استفاده از گزینه‌های مختلف زیر محدود یا گسترش یابد\&.
.sp
این دستور آزمایشی است\&. رفتار آن ممکن است در آینده تغییر کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-min\-batch\-size=\fR\fI<n>\fR
.RS 4
حداقل اندازه یک دسته از اشیای گمشده برای درخواست از سرور را تعیین می‌کند\&. ممکن است آخرین مجموعه از blobهای دیده‌شده در یک مسیر مشخص از این اندازه فراتر رود\&. اندازه دسته‌ای حداقل پیش‌فرض 50,000 است\&.
.RE
.PP
\fB\-\-sparse\fR, \fB\-\-no\-sparse\fR
.RS 4
تنها اشیایی را دانلود می‌کند که در مسیری مطابق با sparse\-checkout فعلی ظاهر شوند\&. اگر ویژگی sparse\-checkout فعال باشد، گزینه
\fB\-\-sparse\fR
فرض می‌شود و می‌توان آن را با
\fB\-\-no\-sparse\fR
غیرفعال کرد\&.
.RE
.PP
\fB\-\-include\-edges\fR, \fB\-\-no\-include\-edges\fR
.RS 4
اشیاء blob حاصل از کامیت‌های مرزی (boundary commits) را در فرآیند backfill لحاظ می‌کند\&. برای آماده‌سازی دستوراتی مانند
\fBgit\fR
\fBlog\fR
\fB\-p\fR
\fBA\fR\fB\&.\&.\fR\fBB\fR
یا
\fBgit\fR
\fBreplay\fR
\fB\-\-onto\fR
\fBTARGET\fR
\fBA\fR\fB\&.\&.\fR\fBB\fR،
جایی که A\&.\&.B به‌طور معمول A را حذف می‌کند اما به blobهای A نیز نیاز دارید، مفید است\&. گزینه
\fB\-\-include\-edges\fR
پیش‌فرض است\&.
.RE
.PP
\fI<revision\-range>\fR
.RS 4
فقط blobهای قابل دسترس از کامیت‌ها در محدوده بازنگری مشخص‌شده را دانلود (backfill) می‌کند\&. هنگامی که هیچ
\fI<revision\-range>\fR
مشخص نشده باشد، پیش‌فرض آن
\fBHEAD\fR
است (یعنی تمام تاریخچه منتهی به کامیت فعلی)\&. برای فهرست کاملی از روش‌های نگارش
\fI<revision\-range>\fR،
بخش "Specifying Ranges" در
\fBgitrevisions\fR(7)
را ببینید\&.
.sp
شما همچنین می‌توانید از گزینه‌های محدودکننده کامیت که برای
\fBgit\-rev\-list\fR(1)
قابل فهم هستند مانند
\fB\-\-first\-parent\fR،
\fB\-\-since\fR
یا مشخص‌کننده‌های مسیر (pathspecs) استفاده کنید\&.
.sp
بیشتر گزینه‌های
\fB\-\-filter=\fR\fI<spec>\fR
با هدف
\fBgit\fR
\fBbackfill\fR
همخوانی ندارند و کار نمی‌کنند، اما فیلتر
\fBsparse:\fR\fI<oid>\fR
تعبیه شده است تا مجموعه‌ای متمرکز از مسیرها را برای دانلود فراهم کند که متمایز از گزینه
\fB\-\-sparse\fR
است\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgit\-clone\fR(1), \fBgit\-rev\-list\fR(1)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)