.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "bup" "1" "2026\-09\-01" "Bup 0.34+"
.SH "نام (NAME)"
bup \- برنامه پشتیبان‌گیری با استفاده از مجموع کنترلی گردشی (rolling checksums) و قالب‌های فایل گیت
.SH "خلاصه دستور (SYNOPSIS)"
bup [global options\&...]
<command> [options\&...]
.SH "توضیحات (DESCRIPTION)"
دستور \f[CR]bup\f[R] برنامه‌ای برای پشتیبان‌گیری از فایل‌های شما با استفاده از قالب پرونده‌های گیت (git) است.
.PP
برخلاف خود \f[CR]git\f[R](1)، bup برای کار با مجموعه داده‌های عظیم از جمله فایل‌های منفرد بسیار بزرگ (مانند تصاویر ماشین‌های مجازی) بهینه‌سازی شده است.
با این وجود، هنگامی که یک مجموعه پشتیبان ایجاد شد، همچنان می‌توان با ابزارهای گیت به آن دسترسی داشت.
.PP
زیردستورها در صفحات راهنمای جداگانه شرح داده شده‌اند.
برای نمونه \f[CR]bup\-init\f[R](1) دستور \f[CR]bup init\f[R] را پوشش می‌دهد.
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.TP
\-\-version
چاپ شماره نسخه bup.
معادل با \f[CR]bup version\f[R].
.TP
\-d, \-\-bup\-dir=\f[I]BUP_DIR\f[R]
استفاده از پارامتر BUP_DIR داده‌شده به عنوان مکان مخزن bup، به جای خواندن آن از متغیر محیطی $BUP_DIR یا استفاده از مکان پیش‌فرض \f[CR]\(ti/.bup\f[R].
.SH "دستورات اصلی (PRIMARY COMMANDS)"
.TP
\f[CR]bup\-init\f[R](1)
راه‌اندازی اولیه یک مخزن bup
.TP
\f[CR]bup\-index\f[R](1)
ایجاد یا نمایش نمایه‌نامه پرونده‌ها جهت پشتیبان‌گیری
.TP
\f[CR]bup\-save\f[R](1)
ذخیره پرونده‌ها در یک مجموعه پشتیبان (توجه: ابتدا \(lqbup index\(rq را اجرا کنید)
.TP
\f[CR]bup\-restore\f[R](1)
استخراج پرونده‌ها از یک مجموعه پشتیبان
.TP
\f[CR]bup\-fsck\f[R](1)
بررسی مجموعه‌های پشتیبان از نظر آسیب‌دیدگی و افزودن اطلاعات بازیابی
.TP
\f[CR]bup\-on\f[R](1)
اجرای نمایه‌سازی/ذخیره/تقسیم/دریافت/\&...
روی یک ماشین دوردست
.TP
\f[CR]bup\-help\f[R](1)
چاپ راهنمای تفصیلی برای دستور مشخص‌شده
.SH "دستورات بازرسی (INSPECTION COMMANDS)"
.TP
\f[CR]bup\-ls\f[R](1)
مرور پرونده‌های موجود در مجموعه‌های پشتیبان شما
.TP
\f[CR]bup\-fuse\f[R](1)
سوار کردن (mount) مجموعه‌های پشتیبان به عنوان یک سیستم‌فایل
.TP
\f[CR]bup\-web\f[R](1)
راه‌اندازی یک کارگزار وب برای بررسی مجموعه‌های پشتیبان
.TP
\f[CR]bup\-ftp\f[R](1)
مرور مجموعه‌های پشتیبان با استفاده از یک کلاینت شبه FTP
.SH "دستورات دستکاری (MANIPULATION COMMANDS)"
.TP
\f[CR]bup\-gc\f[R](1)
پاکسازی داده‌های غیرضروری و بدون ارجاع (Garbage Collection)
.TP
\f[CR]bup\-get\f[R](1)
انتقال/تبدیل آیتم‌ها میان مخازن یا درون مخزن
.TP
\f[CR]bup\-prune\-older\f[R](1)
حذف ذخیره‌های قدیمی‌تر
.TP
\f[CR]bup\-rm\f[R](1)
حذف ارجاعات به محتوای بایگانی
.SH "دستورات واردسازی (IMPORT COMMANDS)"
.TP
\f[CR]bup\-import\-duplicity\f[R](1)
واردسازی از \f[CR]duplicity\f[R](1)
.TP
\f[CR]bup\-import\-rdiff\-backup\f[R](1)
واردسازی از \f[CR]rdiff\-backup\f[R](1)
.TP
\f[CR]bup\-import\-rsnapshot\f[R](1)
واردسازی از \f[CR]rsnapshot\f[R](1)
.SH "سایر دستورات (OTHER COMMANDS)"
.TP
\f[CR]bup\-cat\-file\f[R](1)
استخراج محتوای بایگانی
.TP
\f[CR]bup\-drecurse\f[R](1)
فهرست کردن بازگشتی پرونده‌ها در سیستم‌فایل شما
.TP
\f[CR]bup\-features\f[R](1)
گزارش وضعیت فعلی و قابلیت‌های خود bup
.TP
\f[CR]bup\-join\f[R](1)
بازیابی پرونده‌ای که با استفاده از \f[CR]bup\-split\f[R](1) پشتیبان‌گیری شده است
.TP
\f[CR]bup\-server\f[R](1)
بخش سمت سرور ارتباط کارخواه-کارگزار در bup
.TP
\f[CR]bup\-split\f[R](1)
تقسیم یک پرونده منفرد به مجموعه پشتیبان اختصاصی خود
.TP
\f[CR]bup\-tag\f[R](1)
برچسب‌گذاری (تگ) یک کامیت در مخزن bup
.TP
\f[CR]bup\-validate\-object\-links\f[R](1)
پیمایش مخزن برای یافتن پیوندهای خراب اشیاء
.TP
\f[CR]bup\-validate\-ref\-links\f[R](1)
بررسی ارجاعات مخزن برای پیوند به اشیاء مفقود
.TP
\f[CR]bup\-version\f[R](1)
گزارش شماره نسخه نسخه نصب‌شده bup شما.
.SH "دستورات تخصصی (ESOTERIC COMMANDS)"
.TP
\f[CR]bup\-bloom\f[R](1)
تولید، بازتولید و به‌روزرسانی فیلترهای بلوم
.TP
\f[CR]bup\-damage\f[R](1)
تخریب عمدی داده‌ها (برای آزمون پایداری)
.TP
\f[CR]bup\-margin\f[R](1)
تعیین میزان نزدیکی مخزن bup به نقطه بحرانی ظرفیت
.TP
\f[CR]bup\-memtest\f[R](1)
آزمون آمار مصرف حافظه در bup
.TP
\f[CR]bup\-meta\f[R](1)
ایجاد یا استخراج یک بایگانی فراداده
.TP
\f[CR]bup\-midx\f[R](1)
نمایه‌سازی اشیاء برای تسریع پشتیبان‌گیری‌های آینده
.TP
\f[CR]bup\-random\f[R](1)
تولید یک جریان خروجی تصادفی
.TP
\f[CR]bup\-tick\f[R](1)
انتظار تا حداکثر یک ثانیه.
.SH "گزینه‌های دوردست (REMOTE OPTIONS)"
برخی گزینه‌ها (در حال حاضر تنها \f[CR]\-\-remote\f[R]) امکان تعیین مسیر دوردست را به صورت یک نشانی وب URL (بخش \f[CR]نشانی‌های وب مخزن (REPOSITORY URLS)\f[R] در زیر را ببینید) یا به صورت \f[CR][*user*\(at]*host*:[*path*]\f[R] فراهم می‌کنند.
.PP
برای هر دو فرمت، هنگامی که هیچ مسیری وجود ندارد، مسیر پیش‌فرض روی سرور استفاده خواهد شد (\f[CR]BUP_DIR\f[R] در صورت تنظیم در محیط سرور یا \f[CR]\(ti/.bup\f[R])، و تنظیمات SSH برای اتصال می‌تواند توسط یک میزبان سفارشی در پرونده \f[CR]\(ti/.ssh/config\f[R] شما تأمین شود (\f[CR]ssh_config(5)\f[R]).
.PP
آرگومان ورودی زمانی به عنوان نشانی URL در نظر گرفته می‌شود که با یک پیشوند طرحواره URL معتبر آغاز شود که حاوی \(lqمرجع اعتبار (authority)\(rq باشد (به این معنا که با \f[CR]SCHEME://\f[R] آغاز شود، همانند \f[CR]ssh://...\f[R])، و طرحواره باید یکی از دو حالت \f[CR]ssh\f[R] یا \f[CR]bup\f[R] باشد؛ سایر موارد رد خواهند شد.
.PP
برای نحو \f[CR][*user*\(at]*host*:[*path*]\f[R]، اگر نماد \(at وجود داشته باشد، هر آنچه قبل از راست‌ترین \(at باشد در بخش \f[I]user\f[R] قرار می‌گیرد، بنابراین \f[CR]\-r x\(aty\(atz\f[R] نشان‌دهنده کاربر \f[CR]x\(aty\f[R] و میزبان \f[CR]z\f[R] است.
پس از بخش \f[I]host\f[R] همواره باید دونقطه بیاید و هر چیزی بعد از اولین دونقطه به عنوان \f[I]path\f[R] در نظر گرفته می‌شود.
.PP
برای اهداف کلی، نشانی‌های URL نسبت به فرمت \f[CR][*user*\(at]*host*:[*path*]\f[R] ترجیح داده می‌شوند تا ابهامی وجود نداشته باشد.
برای نمونه، مورد (نامحتمل) را در نظر بگیرید که در آن \f[CR]ssh://x/y\f[R] برای میزبانی به نام \f[CR]ssh\f[R] و مسیر \f[CR]//x/y\f[R] تولید شود، که در این حالت به عنوان یک URL با میزبان \f[CR]x\f[R] و مسیر \f[CR]/y\f[R] تفسیر خواهد شد.
.SH "نشانی‌های وب مخزن (REPOSITORY URLS)"
نرم‌افزار Bup از طرحواره‌های URL زیر (یعنی \f[CR]scheme:\f[R]) برای ارجاع به یک مخزن پشتیبانی می‌کند.
توجه داشته باشید که اصطلاح \(lqمرجع اعتبار (authority)\(rq در زیر صرفاً به معنای بخشی از URL است که پس از \f[CR]scheme://\f[R] و قبل از مسیر قرار می‌گیرد، به عنوان مثال \(lquser\(athost:port\(rq در یک URL از نوع SSH.
.PP
به عنوان استثنایی بر استاندارد، یک طرحواره می‌تواند \(lqمسیرمحور (path\-oriented)\(rq باشد، که به این معناست که هیچ پرس‌وجو یا تکه مجزایی وجود ندارد.
هر چیزی پس از مرجع اعتبار (اختیاری) به عنوان \(lqمسیر\(rq در نظر گرفته می‌شود و بایت‌های تشکیل‌دهنده آن رمزگشایی نمی‌شوند (مثلاً percent decoded نمی‌شوند).
این امر به نشانی‌های وب ارائه‌شده در خط فرمان اجازه می‌دهد تا به طور طبیعی کار کنند.
بنابراین \f[CR]ssh://host/x?z\f[R] دارای مسیر \f[CR]/x?z\f[R] است.
.PP
و از آنجا که نشانی‌های URL دارای مرجع اعتبار نمی‌توانند مسیرهای نسبی را نشان دهند، طرحواره‌های مسیرمحور یک \f[CR]/./\f[R] آغازین را به عنوان مسیر نسبی تفسیر می‌کنند.
بنابراین \f[CR]ssh://host/./x\f[R]، \f[CR]file:///./x\f[R]، و \f[CR]file:/./x\f[R] همگی مسیر \f[CR]x\f[R] را نشان می‌دهند.
.TP
\f[CR]ssh:\f[R]
طرحواره‌ای مسیرمحور (به بالا رجوع کنید) که دسترسی به مخزن را از طریق اجرای یک \f[CR]bup\-server(1)\f[R] روی میزبان از طریق SSH مشخص می‌کند.
این طرحواره دارای نحو و معنایی منطبق با یک URL معمول \f[CR]ssh:\f[R] است، از جمله پشتیبانی از کاربر و درگاه (مانند \f[CR]ssh://user\(athost:2222/some/repo\f[R])، و کاربر و میزبان می‌توانند percent-encode شوند.
.TP
\f[CR]bup:\f[R]
طرحواره‌ای مسیرمحور (به بالا رجوع کنید) که اتصال مستقیم شبکه‌ای به یک \f[CR]bup\-server(1)\f[R] موجود را مشخص می‌کند.
در غیر این صورت همسان با \f[CR]ssh:\f[R] است، با این تفاوت که از کاربر پشتیبانی نمی‌کند.
این اتصال احراز هویت یا رمزنگاری اختصاصی خود را ندارد، بنابراین بعید است که بخواهید از آن استفاده کنید؛ ترجیحاً از \f[CR]file:\f[R] یا \f[CR]ssh:\f[R] استفاده کنید.
.TP
\f[CR]file:\f[R]
طرحواره‌ای مسیرمحور (به بالا رجوع کنید) که مسیر سیستم‌فایل یک مخزن را مشخص می‌کند.
این طرحواره دارای نحو و مفاهیمی منطبق با یک URL معمول \f[CR]file:\f[R] است، با این تفاوت که تنها مرجع اعتبار خالی را می‌پذیرد (یعنی بدون کاربر، میزبان و غیره).
.RS
در بیشتر موارد، احتمالاً ترجیح می‌دهید مرجع اعتبار خالی را لحاظ کنید تا نیازی به بررسی دقیق محتویات مسیر نداشته باشید؛
یعنی هنگامی که \f[CR]PATH\f[R] با یک اسلش آغاز می‌شود از \f[CR]file://PATH\f[R] یا \f[CR]ssh://user\(athostPATH\f[R] استفاده کنید،
و هنگامی که با اسلش آغاز نمی‌شود از \f[CR]file:///./PATH\f[R] یا \f[CR]ssh://user\(athost/./PATH\f[R] استفاده کنید.
حذف مرجع اعتبار امکان‌پذیر است، اما تنها در صورتی که مسیر با دو اسلش آغاز نشود.
برای نمونه \f[CR]file:/\f[R] و \f[CR]file:some/where\f[R] مشکلی ندارند،
اما \f[CR]file://some/where\f[R] معتبر نیست زیرا \f[CR]some\f[R] به عنوان مرجع اعتبار خوانده خواهد شد.
.RE
.SH "محیط (ENVIRONMENT)"
.TP
\f[CR]BUP_ASSUME_GIT_VERSION_IS_FINE\f[R]
اگر روی \f[CR]true\f[R]، \f[CR]yes\f[R] یا \f[CR]1\f[R] تنظیم شود، فرض می‌شود که نسخه \f[CR]git\f[R] موجود در مسیر PATH مناسب و قابل قبول است.
.SH "همچنین ببینید (SEE ALSO)"
پرونده \f[I]README\f[R] از توزیع bup، \f[CR]git\f[R](1)، و http://bup.github.io
.SH "نویسندگان (AUTHORS)"
Avery Pennarun \c
.MT apenwarr@gmail.com
.ME \c.