'\" t
.\"     Title: git-lfs-pull
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "GIT\-LFS\-PULL" "1" "" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
git-lfs-pull \- بارگیری تمام فایل‌های Git LFS برای مرجع جاری و تحویل گرفتن (checkout)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
.fam C
\fBgit lfs pull\fP [\fIoptions\fP] [\fI<remote>\fP]
.fam
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
اشیاء Git LFS را برای مرجعِ جاریِ تحویل‌گرفته‌شده (checked out) بارگیری می‌کند و در صورت نیاز، نسخهٔ کاری (working copy) را با محتوای بارگیری‌شده به‌روزرسانی می‌نماید\&.
.sp
این کار معمولاً معادل اجرای دو دستور زیر است:
.sp
.if n .RS 4
.nf
.fam C
$ git lfs fetch [options] [<remote>]
$ git lfs checkout
.fam
.fi
.if n .RE
.sp
اگر نسخهٔ گیتِ نصب‌شده حداقل ۲.۴۲.۰ باشد، در یک مخزن غیر bare این دستور به‌طور پیش‌فرض اشیاء Git LFS را برای فایل‌هایی دریافت و تحویل (checkout) می‌گیرد که فقط در نمایهٔ (index) گیت موجود باشند و با یک صفت فیلتر Git LFS از فایل \f(CR.gitattributes\fP موجود در نمایه یا درخت کاری فعلی مطابقت داشته باشند (یا مانند همیشه، اگر با یک صفت فیلتر Git LFS در یک فایل محلی \f(CRgitattributes\fP مانند \f(CR$GIT_DIR/info/attributes\fP مطابقت داشته باشند)\&. این محدودیت‌ها در نسخه‌های قبلی گیت اعمال نمی‌شوند\&.
.sp
بنابراین، در مخزنی با شبیه‌سازی جزئی (partial clone) یا تحویل پراکنده (sparse checkout)، در صورتی که گیت نسخهٔ v2.42.0 یا بالاتر نصب شده باشد، توصیه می‌شود پیش از استفاده از این دستور، تمام فایل‌های \f(CR.gitattributes\fP را از \f(CRHEAD\fP تحویل بگیرید (check out کنید)\&. متناوباً، می‌توان متغیر محیطی \f(CRGIT_ATTR_SOURCE\fP را برابر \f(CRHEAD\fP تنظیم کرد که باعث می‌شود گیت صفات را تنها از فایل‌های \f(CR.gitattributes\fP موجود در \f(CRHEAD\fP بخواند و موارد موجود در نمایه یا درخت کاری را نادیده بگیرد\&.
.sp
در یک مخزن bare، اگر نسخهٔ گیت نصب‌شده حداقل ۲.۴۲.۰ باشد، این دستور به‌طور پیش‌فرض اشیاء Git LFS را برای فایل‌ها تنها در صورتی دریافت می‌کند که در نمایهٔ گیت وجود داشته باشند و با یک صفت فیلتر Git LFS از فایل محلی \f(CRgitattributes\fP مانند \f(CR$GIT_DIR/info/attributes\fP مطابقت داشته باشند\&. هرگونه فایل \f(CR.gitattributes\fP موجود در \f(CRHEAD\fP نادیده گرفته خواهد شد، مگر آنکه متغیر محیطی \f(CRGIT_ATTR_SOURCE\fP برابر با \f(CRHEAD\fP تنظیم شده باشد، و هر فایل \f(CR.gitattributes\fP در نمایه یا درخت کاری فعلی همیشه نادیده گرفته می‌شود\&. این محدودیت‌ها در نسخه‌های قبلی گیت اعمال نمی‌شوند\&.
.SH "گزینه‌ها (OPTIONS)"
.sp
\f(CR\-I <paths>\fP, \f(CR\-\-include=<paths>\fP
.RS 4
تنظیم lfs.fetchinclude فقط برای همین فراخوانی؛ بخش «شامل و مستثنی کردن (INCLUDE AND EXCLUDE)» را ببینید\&.
.RE
.sp
\f(CR\-X <paths>\fP, \f(CR\-\-exclude=<paths>\fP
.RS 4
تنظیم lfs.fetchexclude فقط برای همین فراخوانی؛ بخش «شامل و مستثنی کردن (INCLUDE AND EXCLUDE)» را ببینید\&.
.RE
.SH "شامل و مستثنی کردن (INCLUDE AND EXCLUDE)"
.sp
می‌توانید Git LFS را طوری پیکربندی کنید که فقط اشیاء مربوط به ارجاعات در مسیرهای مشخصی از مخزن را دریافت کند، یا مسیرهای خاصی از مخزن را مستثنی سازد، تا زمان صرف‌شده برای بارگیری مواردی که استفاده نمی‌کنید کاهش یابد\&.
.sp
در پیکربندی گیت یا در یک فایل \f(CR.lfsconfig\fP، می‌توانید یکی از گزینه‌های \f(CRlfs.fetchinclude\fP و \f(CRlfs.fetchexclude\fP یا هر دو را با فهرستی از مسیرها که با کاما از هم جدا شده‌اند تنظیم کنید\&. اگر \f(CRlfs.fetchinclude\fP تعریف شده باشد، اشیاء Git LFS تنها در صورتی دریافت می‌شوند که مسیر آن‌ها با یکی از موارد موجود در آن فهرست مطابقت داشته باشد؛ و اگر \f(CRlfs.fetchexclude\fP تعریف شده باشد، اشیاء Git LFS تنها در صورتی دریافت می‌شوند که مسیر آن‌ها با هیچ‌یک از موارد موجود در آن فهرست مطابقت نداشته باشد\&. تطبیق مسیرها با استفاده از نویسه‌های عمومی (wildcard) مطابق با gitignore(5) انجام می‌شود\&.
.sp
توجه داشته باشید که استفاده از گزینه‌های خط فرمان \f(CR\-I\fP و \f(CR\-X\fP تنظیمات پیکربندی مربوطه را بازنویسی (override) می‌کند\&. تنظیم هر یک از این گزینه‌ها روی یک رشتهٔ خالی مقدار آن را پاک می‌کند\&.
.SH "مخزن دوردست پیش‌فرض (DEFAULT REMOTE)"
.sp
بدون آرگومان، دستور pull از مخزن دوردست پیش‌فرض بارگیری می‌کند\&. مخزن دوردست پیش‌فرض همانند دستور \f(CRgit pull\fP تعیین می‌شود؛ یعنی ابتدا بر اساس شاخهٔ دوردستی که در حال ردیابی آن هستید، و در غیر این صورت origin\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
git\-lfs\-fetch(1), git\-lfs\-checkout(1), gitattributes(5), gitignore(5).
.sp
بخشی از مجموعهٔ git\-lfs(1)\&.