'\" t
.\"     Title: git-fetch-pack
.\"    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: Git Manual
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-FETCH\-PACK" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git Manual"
.\" -----------------------------------------------------------------
.\" * 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-fetch-pack \- دریافت اشیای ناموجود از یک مخزن دیگر
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit fetch\-pack\fR [\-\-all] [\-\-quiet|\-q] [\-\-keep|\-k] [\-\-thin] [\-\-include\-tag]
        [\-\-upload\-pack=<git\-upload\-pack>]
        [\-\-depth=<n>] [\-\-no\-progress]
        [\-v] <repository> [<refs>\&...]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
معمولاً ترجیح می‌دهید به جای این دستور، از \fIgit fetch\fR استفاده کنید که یک بسته‌بندی سطح بالاتر (wrapper) برای این دستور است\&.
.sp
دستور \fIgit\-upload\-pack\fR را بر روی یک مخزن که احتمالاً راه دور است فراخوانی می‌کند و از آن می‌خواهد تا اشیای ناموجود در این مخزن را ارسال نماید تا رأس‌های نام‌برده به‌روزرسانی شوند\&. فهرست کامیت‌های موجود به صورت محلی، با بررسی سلسله‌مراتب محلی refs/ به دست می‌آید و به \fIgit\-upload\-pack\fR که در سمت دیگر در حال اجراست فرستاده می‌شود\&.
.sp
اگر سمت محلی کامیت جد مشترکی نداشته باشد، این دستور برای تکمیل مراجع درخواستی از سمت راه دور، به دانلود همه‌چیز تنزل می‌یابد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-\-all
.RS 4
دریافت تمام مراجع (refs) راه دور\&.
.RE
.PP
\-\-stdin
.RS 4
گرفتن فهرست مراجع از ورودی استاندارد (stdin)، هر مورد در یک خط\&. اگر علاوه بر این گزینه، مراجعی نیز در خط فرمان مشخص شده باشند، مراجع ورودی استاندارد پس از موارد خط فرمان پردازش می‌شوند\&.
.sp
اگر
\fB\-\-stateless\-rpc\fR
همراه با این گزینه مشخص شود، فهرست مراجع باید در قالب بسته‌ای (pkt\-line) باشد\&. هر مرجع باید در یک بسته جداگانه قرار گیرد و فهرست باید با یک بسته خالی‌سازی (flush packet) پایان یابد\&.
.RE
.PP
\-q, \-\-quiet
.RS 4
ارسال پرچم
\fB\-q\fR
به
\fIgit unpack\-objects\fR؛ این کار فرآیند کلون‌سازی را کم‌توضیح‌تر می‌کند\&.
.RE
.PP
\-k, \-\-keep
.RS 4
روی داده‌های دریافت شده
\fIgit unpack\-objects\fR
را اجرا نمی‌کند، بلکه به جای آن یک packfile تکی از آن می‌سازد و در پایگاه‌داده اشیاء ذخیره می‌کند\&. اگر دوبار مشخص شود، بسته در برابر بازبسته‌بندی (repacking) قفل می‌شود\&.
.RE
.PP
\-\-thin
.RS 4
یک بسته «نازک» (thin) دریافت می‌کند که اشیاء را بر اساس اشیایی که در بسته وجود ندارند به شکل دلتا ثبت می‌کند تا ترافیک شبکه کاهش یابد\&.
.RE
.PP
\-\-include\-tag
.RS 4
اگر سمت راه دور پشتیبانی کند، در صورتی که شیء مورد ارجاع برچسب دانلود شود، اشیای برچسب‌های نشانه‌دار (annotated tags) نیز روی همان اتصال همراه با سایر اشیاء دانلود خواهند شد\&. در غیر این صورت، فراخواننده باید برچسب‌هایی را که این گزینه دردسترس قرار داده است تعیین کند\&.
.RE
.PP
\-\-upload\-pack=<git\-upload\-pack>
.RS 4
از این گزینه برای مشخص کردن مسیر
\fIgit\-upload\-pack\fR
در سمت راه دور استفاده می‌شود، در صورتی که در $PATH شما پیدا نشود\&. نصب‌های sshd اسکریپت‌های راه‌اندازی محیط کاربر برای شل‌های ورود (مانند \&.bash_profile) را نادیده می‌گیرند و ممکن است git نصب‌شده اختصاصی شما در $PATH پیش‌فرض سیستم یافت نشود\&. راهکار پیشنهادی دیگر تنظیم $PATH در «\&.bashrc» است، اما این پرچم برای افرادی است که نمی‌خواهند با داشتن یک فایل \&.bashrc سبک بار اضافی برای شل‌های غیرتعاملی ایجاد کنند (آن‌ها بیشتر تنظیمات را در \&.bash_profile قرار می‌دهند)\&.
.RE
.PP
\-\-exec=<git\-upload\-pack>
.RS 4
همانند \-\-upload\-pack=<git\-upload\-pack>\&.
.RE
.PP
\-\-depth=<n>
.RS 4
دریافت را به زنجیره‌های نیاکان که بلندتر از n نباشند محدود می‌کند\&.
دستور
\fIgit\-upload\-pack\fR
عمق ویژه 2147483647 را حتی در صورتی که زنجیره نیاکانی با این طول وجود داشته باشد، نامحدود در نظر می‌گیرد\&.
.RE
.PP
\-\-shallow\-since=<date>
.RS 4
عمیق‌تر یا کوتاه‌تر کردن تاریخچه یک مخزن کم‌عمق (shallow) برای گنجاندن تمام کامیت‌های در دسترس پس از <date>\&.
.RE
.PP
\-\-shallow\-exclude=<ref>
.RS 4
عمیق‌تر یا کوتاه‌تر کردن تاریخچه یک مخزن کم‌عمق برای مستثنی کردن کامیت‌های در دسترس از یک شاخه یا برچسب راه دور مشخص‌شده\&. این گزینه می‌تواند چندین بار مشخص شود\&.
.RE
.PP
\-\-deepen\-relative
.RS 4
آرگومان \-\-depth تعداد کامیت‌ها را از مرز کم‌عمق فعلی به جای نوک تاریخچه هر شاخه راه دور مشخص می‌کند\&.
.RE
.PP
\-\-refetch
.RS 4
صرف‌نظر کردن از مذاکره کامیت‌ها با سرور به منظور دریافت تمام اشیای منطبق\&. برای اعمال مجدد یک فیلتر شیء/درخت جدید در کلون جزئی (partial clone) استفاده می‌شود\&.
.RE
.PP
\-\-no\-progress
.RS 4
عدم نمایش درصد پیشرفت\&.
.RE
.PP
\-\-check\-self\-contained\-and\-connected
.RS 4
چاپ خروجی "connectivity\-ok" در صورتی که بسته دریافت‌شده خودبسنده و متصل باشد\&.
.RE
.PP
\-v
.RS 4
اجرا با جزئیات بیشتر (verbose)\&.
.RE
.PP
<repository>
.RS 4
نشانی اینترنتی (URL) مخزن راه دور\&.
.RE
.PP
<refs>\&...
.RS 4
رأس‌های راه دور برای به‌روزرسانی از آن‌ها\&. این مقدار نسبت به $GIT_DIR است (مانند "HEAD"، "refs/heads/master")\&. در صورت مشخص نشدن، از تمام رأس‌های موجود در سمت راه دور به‌روزرسانی انجام می‌شود\&.
.sp
اگر سمت راه دور گزینه‌های
\fBuploadpack\&.allowTipSHA1InWant\fR،
\fBuploadpack\&.allowReachableSHA1InWant\fR یا
\fBuploadpack\&.allowAnySHA1InWant\fR
را فعال کرده باشد، این مراجع می‌توانند مقادیر 40\-رقمی هگزادسیمال sha1 موجود در سمت راه دور نیز باشند\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgit-fetch\fR(1)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)