'\" t
.\"     Title: ostree pull
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/20/2026
.\"    Manual: ostree pull
.\"    Source: OSTree
.\"  Language: Persian
.\"
.TH "OSTREE PULL" "1" "" "OSTree" "ostree pull"
.\" -----------------------------------------------------------------
.\" * 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)"
ostree\-pull \- بارگیری داده‌ها از یک مخزن دوردست
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBostree\ pull\ \fR\fB{REMOTE}\fR\fB\ \fR\fB[BRANCH]\fR\ 'u
\fBostree pull \fR\fB{REMOTE}\fR\fB \fR\fB[BRANCH]\fR
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-commit\-metadata\-only\fR
.RS 4
تنها متاداده‌های کامیت را واکشی می‌کند\&.
.RE
.PP
\fB\-\-cache\-dir\fR=DIR
.RS 4
استفاده از یک پوشه کش جایگزین در
DIR\&.
.RE
.PP
\fB\-\-disable\-fsync\fR
.RS 4
عدم فراخوانی fsync()\&.
.RE
.PP
\fB\-\-localcache\-repo\fR
.RS 4
مانند
clone \-\-reference
در git\*(Aq\&. هنگام دریافت با HTTP، از مخزن OSTree داده‌شده به‌عنوان کش محلی شیء مجدداً استفاده می‌کند\&. می‌تواند چندین بار مشخص شود\&.
.RE
.PP
\fB\-\-untrusted\fR
.RS 4
به منابع محلی اعتماد نمی‌کند، چکسام‌ها را بررسی کرده و به منبع پیوند سخت ایجاد نمی‌کند\&.
.RE
.PP
\fB\-\-disable\-static\-deltas\fR
.RS 4
از دلتاهای ایستا (static deltas) استفاده نمی‌کند\&.
.RE
.PP
\fB\-\-mirror\fR
.RS 4
ارجاع‌ها (refs) را مناسب برای یک نسخه آینه‌ای (mirror) می‌نویسد؛ یعنی ارجاع‌ها به‌جای پوشه
remotes/
در پوشه
heads/
ذخیره می‌شوند\&. این کار مخزن مقصد را برای ارائه به دیگر کلاینت‌ها جهت دریافت به‌عنوان یک ریموت ostree مناسب می‌سازد\&. اگر ارجاع خاصی مشخص نشود، تمام ارجاع‌ها واکشی خواهند شد (ریموت باید دارای یک فایل summary باشد)\&.
.RE
.PP
\fB\-\-subpath\fR=SUBPATH
.RS 4
تنها زیرمسیر ارائه‌شده را دریافت می‌کند\&.
.RE
.PP
\fB\-\-depth\fR=DEPTH
.RS 4
پیمایش DEPTH والد (\-1=بی‌نهایت) (پیش‌فرض: 0)\&.
.RE
.PP
\fB\-\-network\-retries\fR=N
.RS 4
تعداد دفعاتی که دریافت هر بار پس از بروز خطا باید مجدداً تلاش شود را تعیین می‌کند (پیش‌فرض: 5)\&.
.RE
.PP
\fB\-\-disable\-retry\-on\-network\-errors\fR
.RS 4
در زمان بروز خطاهای شبکه مجدداً تلاش نمی‌کند، بلکه بلافاصله ناموفق می‌شود\&. (در حال حاضر تنها بر libcurl اثر می‌گذارد)
.RE
.PP
\fB\-\-low\-speed\-limit\-bytes\fR=N
.RS 4
میانگین سرعت انتقال بر حسب بایت در ثانیه در طول زمان تعیین‌شده با \*(Aqlow\-speed\-time\-seconds\*(Aq تا libcurl عملیات را لغو کند (پیش‌فرض: 1000)\&.
.RE
.PP
\fB\-\-low\-speed\-time\-seconds\fR=N
.RS 4
مدت‌زمان بر حسب ثانیه که سرعت انتقال باید پایین‌تر از تنظیم \*(Aqlow\-speed\-limit\-bytes\*(Aq بماند تا libcurl عملیات را متوقف کند (پیش‌فرض: 30)\&.
.RE
.PP
\fB\-\-max\-outstanding\-fetcher\-requests\fR=N
.RS 4
حداکثر تعداد مجاز اتصالات همزمان\&. (پیش‌فرض: 8)
.RE
.PP
\fB\-\-disable\-verify\-bindings\fR
.RS 4
غیرفعال‌سازی بررسی پیوندهای متاداده کامیت\&.
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
بدون گزینه \-\-mirror ، این دستور مراجع جدیدی در پوشه
remotes/REMOTE/
برای هر شاخه دریافت شده ایجاد خواهد کرد مگر آنکه از قبل ایجاد شده باشند\&. چنین ارجاع‌هایی سپس می‌توانند با
REMOTE:BRANCH
در زیردستورهای
ostree
مورد استفاده قرار گیرند (برای نمونه
ostree log origin:exampleos/x86_64/standard)\&.
.PP
این دستور می‌تواند فقط یک کامیت خاص را دریافت کند، یا یک آینه‌سازی کامل از مخزن دوردست را به سرانجام برساند\&. اگر هیچ
BRANCH
(شاخه‌ای) مشخص نشود، تمام شاخه‌های پیکربندی‌شده دریافت می‌گردند\&.
.PP
یک ساختار نحوی ویژه با نویسه
@
امکان مشخص‌کردن یک کامیت خاص برای دریافت از یک شاخه را فراهم می‌کند\&. موارد کاربرد این قابلیت تا حدی شبیه به دریافت یک تگ خاص در git است؛ به‌عنوان مثال می‌توان اسکریپتی برای ارتقای سیستم به یک نسخه مطمئن مشخص نوشت، به‌جای دریافت آخرین نسخه از سوی ارائه‌دهنده محتوا\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
\fB$ ostree \-\-repo=repo pull \-\-depth=\-1 \-\-mirror remote_name\fR
.PP
انجام یک آینه‌سازی کامل از مخزن دوردست\&. (این حالت بیشتر زمانی سودمند است که مخزن شما نیز در حالت
archive
باشد)
.PP
\fB$ ostree \-\-repo=repo pull remote_name exampleos/x86_64/standard\fR
.PP
واکشی جدیدترین کامیت در
exampleos/x86_64/standard\&.
.PP
\fB$ ostree \-\-repo=repo pull remote_name exampleos/x86_64/standard@98ea6e4f216f2fb4b69fff9b3a44842c38686ca685f3f55dc48c5d3fb1107be4\fR
.PP
بارگیری کامیت خاصی که با
98ea6e
آغاز می‌شود، درست مانند اینکه آخرین کامیت برای
exampleos/x86_64/standard
بوده است\&.