.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "bup\-get" "1" "2026\-09\-01" "Bup 0.34+"
.SH "نام (NAME)"
bup\-get \- کپی کردن یا دانلود زیرمجموعه‌ای از مخزن bup
.SH "خلاصه دستور (SYNOPSIS)"
bup get [\-s \f[I]source\-path\f[R]] [\-r \f[I]host\f[R]:\f[I]path\f[R]]
OPTIONS <(METHOD \f[I]ref\f[R] [\f[I]dest\f[R]])>\&...
.SH "توضیحات (DESCRIPTION)"
دستور \f[CR]bup get\f[R] مراجع مشخص‌شده (\f[I]ref\f[R]ها) را از مخزن مبدأ به مخزن مقصد (با رعایت \f[CR]\-\-bup\-dir\f[R] و \f[CR]BUP_DIR\f[R])، بر اساس METHOD مشخص‌شده منتقل می‌کند؛ این METHOD می‌تواند یکی از موارد
\f[CR]\-\-ff\f[R]،
\f[CR]\-\-ff:\f[R]، \f[CR]\-\-append\f[R]، \f[CR]\-\-append:\f[R]،
\f[CR]\-\-pick\f[R]، \f[CR]\-\-pick:\f[R]، \f[CR]\-\-force\-pick\f[R]،
\f[CR]\-\-force\-pick:\f[R]، \f[CR]\-\-new\-tag\f[R]،
\f[CR]\-\-new\-tag:\f[R]، \f[CR]\-\-replace\f[R]،
\f[CR]\-\-replace:\f[R] یا \f[CR]\-\-unnamed\f[R] باشد.
به‌طور پیش‌فرض، داده‌ها را بدون تغییر کپی می‌کند (\f[CR]\-\-copy\f[R])، اما همچنین می‌تواند آن‌ها را بازنویسی کند (\f[CR]\-\-rewrite\f[R]) که احتمالاً دانه‌بندی یکتاسازی (deduplication granularity) را تغییر می‌دهد، و برخی از انواع آسیب‌ها را تعمیر کند (\f[CR]\-\-repair\f[R]).
برای آشنایی سریع، بخش «مثال‌ها» در زیر را ببینید.
.PP
مقدار \f[I]ref\f[R] مرجع شیء مورد نظر برای دریافت در مخزن مبدأ است، و \f[I]dest\f[R] مرجع اختیاری در مقصد است.
مقدار \f[I]dest\f[R] تنها می‌تواند برای METHODهایی مشخص شود که نام آن‌ها با دونقطه پایان می‌یابد.
برای مثال:
.IP
.EX
bup get \-s /source/repo \-\-ff foo
bup get \-s /source/repo \-\-ff: foo/latest bar
bup get \-s /source/repo \-\-pick: foo/2010\-10\-10\-101010 bar
bup get \-s /source/repo \-\-pick: foo/2010\-10\-10\-101010 .tag/bar
.EE
.PP
رفتار هر METHOD مشخص تا حدی بر اساس انواع \f[I]ref\f[R] و \f[I]dest\f[R] تعیین می‌شود، یعنی شاخه (branch)، ذخیره (save)، برچسب (tag) و غیره.
.PP
به‌عنوان یک حالت خاص، اگر \f[I]ref\f[R] به پیوند نمادین ذخیره \(lqlatest\(rq اشاره کند، bup دقیقاً به گونه‌ای عمل می‌کند که گویی به ذخیره‌ای که \(lqlatest\(rq به آن اشاره دارد ارجاع داده شده است، نه به خود پیوند نمادین \(lqlatest\(rq؛ بنابراین \f[CR]bup get foo/latest\f[R] در عمل به چیزی مانند \f[CR]bup get foo/2013\-01\-01\-030405\f[R] تفسیر خواهد شد.
.PP
در برخی شرایط، \f[CR]bup get\f[R] یک عملیات شاخه را بر این اساس ارزیابی می‌کند که آیا یک «انتقال سریع به جلو» (\(lqfast\-forward\(rq) خواهد بود یا خیر (که مستلزم آن است که هر شاخه موجود در مقصد، نیای شاخه مبدأ باشد).
.PP
یک برچسب موجود در مقصد تنها می‌تواند توسط \f[CR]\-\-replace\f[R] یا \f[CR]\-\-force\-pick\f[R] بازنویسی شود.
.PP
هنگامی که یک کامیت جدید ایجاد می‌شود (یعنی از طریق \f[CR]\-\-append\f[R]، \f[CR]\-\-pick\f[R] و غیره)، همان پدیدآورنده (author)، تاریخ پدیدآورنده و پیام کامیت اصلی را خواهد داشت، اما ثبت‌کننده (committer) و تاریخ ثبت آن مربوط به کاربر فعلی و زمان کنونی خواهد بود.
.PP
اگر از طریق گزینه‌های مربوطه درخواست شود، bup هش کامیت، درخت (tree) یا برچسب را برای هر ارجاع به‌روزشده در مقصد چاپ می‌کند.
در صورت لزوم، هش درخت پیش از هش کامیت چاپ خواهد شد.
.PP
مراجع محلی (\f[I]ref\f[R]ها) را می‌توان با گزینه \f[CR]\-\-remote\f[R] به یک مخزن دوردست ارسال کرد، و مراجع دوردست را می‌توان از طریق دستور «\(lqbup on HOST get \&...\(rq» به مخزن محلی دریافت نمود.
برای اطلاعات بیشتر، \f[CR]bup\-on\f[R](1) و بخش «مثال‌ها» در زیر را ببینید.
.PP
\f[B]هشدار:\f[R] این یکی از معدود دستورات bup است که می‌تواند آرشیوهای شما را به شیوه‌های مخربِ عمدی تغییر دهد.
با این وجود، اگر پس از اجرای این دستور، تلاش برای اتصال (join) یا بازیابی داده‌هایی که همچنان برایتان اهمیت دارند موفقیت‌آمیز باشد، نشانه بسیار امیدوارکننده‌ای است که دستور به درستی کار کرده است.
(دستور dev/compare\-trees در درخت مبدأ می‌تواند برای کمک به بررسی نتایج قبل و بعد استفاده شود.)
.SH "روش‌ها (METHODS)"
.TP
\-\-ff \f[I]ref\f[R], \-\-ff: \f[I]ref\f[R] \f[I]dest\f[R]
انتقال سریع به جلو (fast\-forward) ارجاع \f[I]dest\f[R] برای تطبیق با \f[I]ref\f[R].
اگر \f[I]dest\f[R] مشخص نشده باشد و \f[I]ref\f[R] نام یک ذخیره (save) باشد، مقدار \f[I]dest\f[R] روی شاخه مربوط به آن ذخیره تنظیم می‌شود.
اگر \f[I]dest\f[R] مشخص نشده باشد و \f[I]ref\f[R] نام یک شاخه یا برچسب باشد، از همان نام برای \f[I]dest\f[R] استفاده می‌شود.
.TP
\-\-append \f[I]ref\f[R], \-\-append: \f[I]ref\f[R] \f[I]dest\f[R]
افزودن تمام کامیت‌های ارائه‌شده توسط \f[I]ref\f[R] به انتهای \f[I]dest\f[R] به‌عنوان کامیت‌های جدید.
اگر \f[I]ref\f[R] نام یک پوشه/درخت باشد، یک کامیت جدید برای آن درخت اضافه می‌کند.
اگر \f[I]dest\f[R] مشخص نشده باشد و \f[I]ref\f[R] نام یک ذخیره یا شاخه باشد، مقدار \f[I]dest\f[R] روی نام شاخه \f[I]ref\f[R] تنظیم می‌شود.
اگر \f[I]dest\f[R] مشخص نشده باشد و \f[I]ref\f[R] نام یک برچسب باشد، از همان نام برای \f[I]dest\f[R] استفاده می‌شود.
.TP
\-\-pick \f[I]ref\f[R], \-\-pick: \f[I]ref\f[R] \f[I]dest\f[R]
افزودن تک‌کامیت مشخص‌شده با \f[I]ref\f[R] به \f[I]dest\f[R] به‌عنوان یک کامیت جدید.
اگر \f[I]dest\f[R] مشخص نشده باشد و \f[I]ref\f[R] نام یک ذخیره باشد، مقدار \f[I]dest\f[R] روی نام شاخه \f[I]ref\f[R] تنظیم می‌شود.
اگر \f[I]dest\f[R] مشخص نشده باشد و \f[I]ref\f[R] نام یک برچسب باشد، از همان نام برای \f[I]dest\f[R] استفاده می‌شود.
.TP
\-\-force\-pick \f[I]ref\f[R], \-\-force\-pick: \f[I]ref\f[R] \f[I]dest\f[R]
همان عملیات \f[CR]\-\-pick\f[R] را انجام می‌دهد، با این تفاوت که از بازنویسی برچسب موجود امتناع نمی‌کند، و اگر برچسب به یک کامیت اشاره داشته باشد، آن را والد (parent) ارجاع \f[I]ref\f[R] قرار می‌دهد.
.TP
\-\-new\-tag \f[I]ref\f[R], \-\-new\-tag: \f[I]ref\f[R] \f[I]dest\f[R]
ایجاد یک برچسب \f[I]dest\f[R] برای \f[I]ref\f[R]، با این تفاوت که از بازنویسی برچسب موجود خودداری می‌کند.
اگر \f[I]dest\f[R] مشخص نشده باشد و \f[I]ref\f[R] نام یک برچسب باشد، از همان نام برای \f[I]dest\f[R] استفاده می‌شود.
.TP
\-\-replace \f[I]ref\f[R], \-\-replace: \f[I]ref\f[R] \f[I]dest\f[R]
جایگزینی کامل \f[I]dest\f[R] با \f[I]ref\f[R]، رونویسی هر برچسب موجود یا جایگزین کردن هر شاخه موجود.
اگر \f[I]dest\f[R] مشخص نشده باشد و \f[I]ref\f[R] نام یک شاخه یا برچسب باشد، از همان نام برای \f[I]dest\f[R] استفاده می‌شود.
.TP
\-\-unnamed \f[I]ref\f[R]
کپی کردن \f[I]ref\f[R] به مخزن مقصد، بدون هیچ نامی، که یک ارجاع بالقوه معلق باقی می‌گذارد مگر آن‌که/تا زمانی که شیء مشخص‌شده با \f[I]ref\f[R] به روش دیگری مورد ارجاع قرار گیرد
(مقایسه کنید با \f[CR]bup tag\f[R]).
در حال حاضر تنها با گزینه \f[CR]\-\-copy\f[R] سازگار است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\-s \f[I]path\f[R], \-S \f[I]url, \-\-source \f[R]path\f[I], \-\-source\-url \f[R]url*
استفاده از \f[I]path\f[R] یا \f[I]url\f[R] به‌عنوان مخزن مبدأ، به‌جای مقدار پیش‌فرض.
برای اطلاعات بیشتر، به بخش «REPOSITORY URLS» در \f[CR]bup\f[R](1) مراجعه کنید.
.TP
\-r, \-\-remote=[\f[I]user\f[R]\(at]\f[I]host\f[R]:[\f[I]path\f[R]], \-\-remote=URL
نوشتن مراجع \f[I]ref\f[R] در مخزن دوردست مشخص‌شده، که به‌طور پیش‌فرض از طریق SSH انجام می‌شود.
برای اطلاعات بیشتر، به بخش «REMOTE OPTIONS» در \f[CR]bup\f[R](1) مراجعه کنید.
.TP
\-c, \-\-print\-commits
برای هر شاخه به‌روزشده، شناسه کامیت گیت جدید را چاپ می‌کند.
.TP
\-t, \-\-print\-trees
برای هر شاخه به‌روزشده، شناسه درخت گیت جدید از ریشه فایل‌سیستم را چاپ می‌کند.
.TP
\-\-print\-tags
برای هر برچسب به‌روزشده، شناسه گیت جدید را چاپ می‌کند.
.TP
\-\-copy
کپی کردن داده‌ها بدون تغییر (یعنی بدون بازنویسی یا تعمیرات).
این مقدار پیش‌فرض است.
.TP
\-\-rewrite
بازنویسی داده‌ها بر اساس پیکربندی مخزن مقصد، برای نمونه مقادیر \f[CR]bup.split.files\f[R] و \f[CR]bup.split.trees\f[R] آن.
برخی از تعمیرات جزئی ممکن است در حین انتقال انجام شوند، مادامی که نتیجه را از نظر بنیادی تغییر ندهند (به بخش «تعمیرات» در زیر مراجعه کنید).
در حال حاضر، هرگاه پیکربندی مخزن مبدأ و مقصد به شیوه‌ای مرتبط تفاوت داشته باشد، باید یکی از گزینه‌های \f[CR]\-\-rewrite\f[R]، \f[CR]\-\-repair\f[R] یا \f[CR]\-\-copy\f[R] مشخص شود، و تا کنون، \f[CR]\-\-rewrite\f[R] تنها برای موارد الحاق (append) و انتخاب (pick) در ذخیره‌ها (و نه درخت‌ها) پشتیبانی می‌شود.
.RS
توجه داشته باشید که بازنویسی یک ذخیره ایجادشده توسط git ممکن است، و در حال حاضر قطعاً، تغییرات مربوط به bup ایجاد کند.
علاوه بر این، گرچه آزمایش شده است، اما گزینه \f[CR]\-\-rewrite\f[R] نسبتاً جدید است و از این رو احتیاط بیشتری را نسبت به خود \f[CR]bup get\f[R] می‌طلبد (به بخش «هشدار» در بالا مراجعه کنید).
لطفاً فعلاً نتایج را با دقت اعتبارسنجی نمایید.
این گزینه زمینه‌ای است (به بخش «گزینه‌های زمینه‌ای» مراجعه کنید).
.RE
.TP
\-\-repair
علاوه بر آنچه \f[CR]\-\-rewrite\f[R] انجام می‌دهد، تمام تعمیرات شناخته‌شده را در حین انتقال انجام می‌دهد.
به بخش «تعمیرات» در زیر مراجعه کنید.
این گزینه زمینه‌ای است (به بخش «گزینه‌های زمینه‌ای» مراجعه کنید).
.TP
\-\-repair\-id ID
شناسه نشست تعمیر را مشخص می‌کند که پیش‌فرض آن یک UUID (نسخه ۴) است.
این شناسه در هر یک از تعمیرات (\f[CR]\-\-repair\f[R]) انجام‌شده در طول انتقال گنجانده خواهد شد.
در حال حاضر، شناسه باید از نوع ASCII باشد و نویسه‌های کنترلی یا DEL را شامل نشود (یعنی باید از بایت‌های >= 20 و < 127 تشکیل شده باشد).
این گزینه زمینه‌ای است (به بخش «گزینه‌های زمینه‌ای» مراجعه کنید).
.TP
\-\-ignore\-missing
نادیده گرفتن اشیاء مفقودشده که در طول انتقال با آن‌ها مواجه می‌شوید.
در حال حاضر تنها توسط \f[CR]\-\-unnamed\f[R] پشتیبانی می‌شود و بالقوه \f[I]خطرناک\f[R] است.
.TP
\-\-exclude\-rx=\f[I]pattern\f[R]
مستثنی کردن هر مسیری که با الگوی \f[I]pattern\f[R] مطابقت داشته باشد، که باید یک عبارت منظم پایتون باشد (http://docs.python.org/library/re.html).
الگو با کل مسیر و بدون مهار (anchoring) مقایسه می‌شود، بنابراین «\(lqx/y\(rq» با «\(lqox/yard\(rq» یا «\(lqbox/yards\(rq» مطابقت خواهد داشت.
برای مستثنی کردن محتویات /tmp بدون مستثنی کردن خود دایرکتوری، از «\(lq\(ha/tmp/.\(rq» استفاده کنید.
(می‌تواند تکرار شود)
.RS
مثال‌ها:
.IP \(bu 2
\f[CR]/foo$\f[R] \- مستثنی کردن هر فایلی به نام foo
.IP \(bu 2
\f[CR]/foo/$\f[R] \- مستثنی کردن هر پوشه‌ای به نام foo
.IP \(bu 2
\f[CR]/foo/.\f[R] \- مستثنی کردن محتوای هر پوشه‌ای به نام foo
.IP \(bu 2
\f[CR]\(ha/tmp/.\f[R] \- مستثنی کردن محتوای پوشه tmp در سطح ریشه
تنها هنگام بازنویسی یا تعمیر پشتیبانی می‌شود.
این گزینه زمینه‌ای است (به بخش «گزینه‌های زمینه‌ای» مراجعه کنید).
.RE
.TP
\-\-exclude\-rx\-from=\f[I]filename\f[R]
خواندن الگوهای \-\-exclude\-rx از \f[I]filename\f[R]، هر الگو در یک خط (می‌تواند تکرار شود).
خطوط کاملاً خالی نادیده گرفته می‌شوند.
تنها هنگام بازنویسی پشتیبانی می‌شود.
این گزینه زمینه‌ای است (به بخش «گزینه‌های زمینه‌ای» مراجعه کنید).
.TP
\-\-no\-excludes
نادیده گرفتن و فراموش کردن هر یک از گزینه‌های قبلی \f[CR]\-\-exclude\-rx\f[R] یا \f[CR]\-\-exclude\-rx\-from\f[R].
این گزینه زمینه‌ای است (به بخش «گزینه‌های زمینه‌ای» مراجعه کنید).
.TP
\-v, \-\-verbose
افزایش سطح گزارش جزئیات (می‌تواند بیش از یک بار استفاده شود).
با \f[CR]\-v\f[R]، نام هر مورد دریافت‌شده چاپ می‌شود، با \f[CR]\-vv\f[R] نام پوشه‌ها افزوده می‌گردد، و با \f[CR]\-vvv\f[R] نام همه فایل‌ها چاپ می‌شود.
.TP
\-\-bwlimit=\f[I]bytes/sec\f[R]
عدم ارسال بیش از \f[I]bytes/sec\f[R] بایت در ثانیه به سرور.
این گزینه می‌تواند از اشغال تمام پهنای باند شبکه شما جلوگیری کند.
از پسوندهایی مانند k، M یا G به ترتیب برای تعیین مضارب ۱۰۲۴، ۱۰۲۴*۱۰۲۴ و ۱۰۲۴*۱۰۲۴*۱۰۲۴ استفاده کنید.
.TP
\-\f[I]#\f[R], \-\-compress=\f[I]#\f[R]
تنظیم سطح فشرده‌سازی روی # (مقداری از 0 تا 9، که 9 بیشترین فشرده‌سازی و 0 بدون فشرده‌سازی است).
پیش‌فرض روی مقادیر پیکربندی‌شده pack.compression یا core.compression، یا مقدار 1 (فشرده‌سازی سریع و سبک) است.
.SH "گزینه‌های زمینه‌ای (CONTEXTUAL OPTIONS)"
برخی از گزینه‌ها مانند \f[CR]\-\-repair\f[R] و \f[CR]\-\-ignore\-missing\f[R] می‌توانند در METHODهای مختلف تفاوت داشته باشند، و هر گزینه زمینه را برای METHOD بعدی تغییر می‌دهد.
بنابراین می‌توانید دستوری مانند زیر داشته باشید:
.IP
.EX
bup get ... \-\-ignore\-missing \-\-unnamed REF \(rs
    \-\-no\-ignore\-missing \-\-rewrite \-\-append REF
.EE
.PP
بدون گزینه \f[CR]\-\-no\-ignore\-missing\f[R] این دستور با شکست مواجه می‌شد، چرا که گزینه \f[CR]\-\-ignore\-missing\f[R] با \f[CR]\-\-rewrite\f[R] ناسازگار است.
.PP
تغییر موارد مستثنی‌شده (excludes) فعال کنونی پرهزینه است زیرا در حال حاضر حافظه موقت بازنویسی‌های به‌خاطرسپرده‌شده باید هر زمان که موارد مستثنی‌شده یک METHOD با موارد METHOD قبلی تفاوت داشته باشد، پاک شود.
.SH "تعمیرات (REPAIRS)"
دستور \f[CR]bup get\f[R] می‌تواند تعدادی از مشکلات شناخته‌شده را در طول انتقال در صورت درخواست گزینه \f[CR]\-\-repair\f[R] رفع کند (یا تخفیف دهد)، و زیرمجموعه‌ای از تعمیرات «اتفاقی و جزئی» نیز ممکن است در حین یک \f[CR]\-\-rewrite\f[R] انجام پذیرد.
.IP \(bu 2
نسخه‌های \f[CR]bup\f[R] از 0.25 به بعد و قبل از 0.30.1 ممکن است به‌ندرت ورودی‌های فراداده را برای موارد غیرپوشه از دست بدهند (که می‌تواند توسط \f[CR]bup\-validate\-refs\f[R](1) \f[CR]\-\-bupm\f[R] شناسایی شود).
این امر فراداده‌های همه مسیرهای غیرپوشه‌ای دیگر در همان پوشه را غیرقابل‌استفاده (مبهم) می‌سازد.
هنگامی که چنین \f[CR].bupm\f[R] خلاصه‌شده‌ای شناسایی شود، گزینه \f[CR]\-\-repair\f[R] تمام ورودی‌های \f[CR].bupm\f[R] را به جز ورودی مربوط به خود پوشه، یعنی «\(lq.\(rq»، حذف می‌کند و بنابراین مسیرهای متأثر بیشتر یا تمام فراداده‌های خود (مالکیت، مجوزها، نشان‌های زمانی و غیره) را از دست می‌دهند.
این مسیرها در هنگام نمایش، برای نمونه از طریق \f[CR]bup\-restore(1)\f[R]، \f[CR]bup\-ls(1)\f[R] و غیره، دارای مجوزهای محدودکننده خواهند بود (گویی با umask 077 ایجاد شده‌اند).
.IP \(bu 2
استفاده از نسخه‌های \f[CR]bup get\f[R] یا \f[CR]bup gc\f[R] قبل از 0.33.5 می‌تواند باعث شود مخازن در نهایت با اشیاء گم‌شده مواجه شوند (که توسط \f[CR]bup\-validate\-object\-links\f[R](1) قابل شناسایی است).
برای رفع درخت‌های تحت تأثیر، \f[CR]\-\-repair\f[R] «فایل‌های تعمیر» ساخته‌شده را جایگزین هر مسیری با اشیاء گم‌شده می‌کند.
توجه داشته باشید که در حال حاضر هیچ پشتیبانی برای بازیابی بخش‌های آسیب‌ندیده فایل‌های تکه‌شده وجود ندارد؛ کل فایل با یک فایل تعمیر جایگزین می‌شود.
این فایل‌های تعمیر شامل \f[CR]\-\-repair\-id\f[R] و اطلاعاتی درباره جایگزینی هستند.
پشتیبانی از درخت‌های تکه‌شده پس از برطرف شدن مشکل اضافه شد و بنابراین نباید متأثر شده باشد.
برای اطلاعات بیشتر، \c
.UR https://github.com/bup/bup/blob/main/note/0.33.5-from-0.33.4.md
یادداشت‌های انتشار نسخه 0.33.5 (0.33.5\-from\-0.33.4.md)
.UE \c
\ را ببینید.
.PP
تعمیرات «اتفاقی» نیز ممکن است انجام شود \(em تعمیراتی که نتیجه را از لحاظ عملکردی تغییر نمی‌دهند.
برای نمونه، bup مقاصد پیوندهای نمادین را در دو مکان ثبت می‌کند، اما عموماً تنها به یکی از آن‌ها ارجاع می‌دهد.
اگر مکان دیگر مفقود باشد، می‌تواند و باید از مکان اول بازیابی شود.
.SH "مثال‌ها (EXAMPLES)"
.IP
.EX
# به‌روزرسانی یا کپی شاخه archives در src\-repo به مخزن محلی.
$ bup get \-s src\-repo \-\-ff archives

# اضافه کردن یک ذخیره خاص archives به شاخه pruned\-archives.
$ bup get \-s src\-repo \-\-pick: archives/2013\-01\-01\-030405 pruned\-archives

# به‌روزرسانی یا کپی شاخه archives در remotehost به مخزن محلی.
$ bup on remotehost get \-\-ff archives

# به‌روزرسانی یا کپی شاخه محلی archives به remotehost.
$ bup get \-r remotehost: \-\-ff archives

# به‌روزرسانی یا کپی شاخه archives در src\-repo به remotehost.
$ bup get \-s src\-repo \-r remotehost: \-\-ff archives

# به‌روزرسانی شاخه archives\-2 در remotehost برای تطبیق با archives.
# اگر archives\-2 وجود داشته باشد و از نیاکان archives نباشد،
# دستور bup امتناع خواهد کرد.
$ bup get \-r remotehost: \-\-ff: archives archives\-2

# جایگزینی محتویات شاخه y با محتویات x.
$ bup get \-\-replace: x y

# کپی آخرین ذخیره محلی از شاخه archives به تگ دوردست foo.
$ bup get \-r remotehost: \-\-pick: archives/latest .tag/foo

# یا اگر foo از قبل وجود داشته باشد:
$ bup get \-r remotehost: \-\-force\-pick: archives/latest .tag/foo

# اضافه کردن foo (از بالا) به شاخه محلی other\-archives.
$ bup on remotehost get \-\-append: .tag/foo other\-archives

# اضافه کردن تنها پوشه /home از archives/latest به only\-home.
$ bup get \-s \(dq$BUP_DIR\(dq \-\-append: archives/latest/home only\-home

# تقسیم مجدد (بازنویسی) شاخه archives. توجه داشته باشید که انجام
# یک‌باره این کار ممکن است به فضای اضافی به اندازه شاخه archives
# نیاز داشته باشد. روش‌های pick می‌توانند بازنویسی را به‌طور انتخابی‌تر
# یا تدریجی‌تر انجام دهند. (فرض کنید BUP_DIR فاقد تنظیمات
# تقسیم است.)
#
$ git \-\-git\-dir \(dq$BUP_DIR\(dq config bup.split.trees true
$ git \-\-git\-dir \(dq$BUP_DIR\(dq config bup.split.files legacy:16
$ bup get \-\-rewrite \-\-append: archives archives\-resplit
#
# بررسی کنید که archives\-resplit مناسب به نظر برسد، شاید از طریق بازیابی‌های
# آزمایشی، اتصال آن و غیره (به بخش «هشدار» در بالا رجوع کنید)، و پس از
# اطمینان، شاید...
#
$ bup rm archives
$ bup gc
$ git \-\-git\-dir \(dq$BUP_DIR\(dq branch \-m archives\-resplit archives
#
# تعمیر یک ذخیره تکی.
$ bup get \-\-repair \-\-pick archives/latest fixed
#
# بررسی کنید که fixed/latest مناسب به نظر برسد، شاید از طریق بازیابی‌های
# آزمایشی، اتصال آن و غیره (به بخش «هشدار» در بالا رجوع کنید).
.EE
.SH "وضعیت خروج (EXIT STATUS)"
کد خروج 3 نشان می‌دهد که تعمیرات مورد نیاز بوده و با موفقیت انجام شده‌اند، و هیچ خطای دیگری رخ نداده است.
.SH "همچنین ببینید (SEE ALSO)"
\f[CR]bup\-on\f[R](1)، \f[CR]bup\-tag\f[R](1)، \f[CR]ssh_config\f[R](5)
.SH "مجموعه BUP (BUP)"
بخشی از مجموعه \f[CR]bup\f[R](1).
.SH "نویسندگان (AUTHORS)"
Rob Browning \c
.MT rlb@defaultvalue.org
.ME \c.