نام (NAME)

bup - برنامه پشتیبان‌گیری با استفاده از مجموع کنترلی گردشی (rolling checksums) و قالب‌های فایل گیت

خلاصه دستور (SYNOPSIS)

bup [global options...] <command> [options...]

توضیحات (DESCRIPTION)

دستور bup برنامه‌ای برای پشتیبان‌گیری از فایل‌های شما با استفاده از قالب پرونده‌های گیت (git) است.

برخلاف خود git(1)، bup برای کار با مجموعه داده‌های عظیم از جمله فایل‌های منفرد بسیار بزرگ (مانند تصاویر ماشین‌های مجازی) بهینه‌سازی شده است. با این وجود، هنگامی که یک مجموعه پشتیبان ایجاد شد، همچنان می‌توان با ابزارهای گیت به آن دسترسی داشت.

زیردستورها در صفحات راهنمای جداگانه شرح داده شده‌اند. برای نمونه bup-init(1) دستور bup init را پوشش می‌دهد.

گزینه‌های عمومی (GLOBAL OPTIONS)

--version: چاپ شماره نسخه bup. معادل با bup version.
-d, --bup-dir=BUP_DIR: استفاده از پارامتر BUP_DIR داده‌شده به عنوان مکان مخزن bup، به جای خواندن آن از متغیر محیطی $BUP_DIR یا استفاده از مکان پیش‌فرض ~/.bup.

دستورات اصلی (PRIMARY COMMANDS)

bup-init(1): راه‌اندازی اولیه یک مخزن bup
bup-index(1): ایجاد یا نمایش نمایه‌نامه پرونده‌ها جهت پشتیبان‌گیری
bup-save(1): ذخیره پرونده‌ها در یک مجموعه پشتیبان (توجه: ابتدا “bup index” را اجرا کنید)
bup-restore(1): استخراج پرونده‌ها از یک مجموعه پشتیبان
bup-fsck(1): بررسی مجموعه‌های پشتیبان از نظر آسیب‌دیدگی و افزودن اطلاعات بازیابی
bup-on(1): اجرای نمایه‌سازی/ذخیره/تقسیم/دریافت/... روی یک ماشین دوردست
bup-help(1): چاپ راهنمای تفصیلی برای دستور مشخص‌شده

دستورات بازرسی (INSPECTION COMMANDS)

bup-ls(1): مرور پرونده‌های موجود در مجموعه‌های پشتیبان شما
bup-fuse(1): سوار کردن (mount) مجموعه‌های پشتیبان به عنوان یک سیستم‌فایل
bup-web(1): راه‌اندازی یک کارگزار وب برای بررسی مجموعه‌های پشتیبان
bup-ftp(1): مرور مجموعه‌های پشتیبان با استفاده از یک کلاینت شبه FTP

دستورات دستکاری (MANIPULATION COMMANDS)

bup-gc(1): پاکسازی داده‌های غیرضروری و بدون ارجاع (Garbage Collection)
bup-get(1): انتقال/تبدیل آیتم‌ها میان مخازن یا درون مخزن
bup-prune-older(1): حذف ذخیره‌های قدیمی‌تر
bup-rm(1): حذف ارجاعات به محتوای بایگانی

دستورات واردسازی (IMPORT COMMANDS)

bup-import-duplicity(1): واردسازی از duplicity(1)
bup-import-rdiff-backup(1): واردسازی از rdiff-backup(1)
bup-import-rsnapshot(1): واردسازی از rsnapshot(1)

سایر دستورات (OTHER COMMANDS)

bup-cat-file(1): استخراج محتوای بایگانی
bup-drecurse(1): فهرست کردن بازگشتی پرونده‌ها در سیستم‌فایل شما
bup-features(1): گزارش وضعیت فعلی و قابلیت‌های خود bup
bup-join(1): بازیابی پرونده‌ای که با استفاده از bup-split(1) پشتیبان‌گیری شده است
bup-server(1): بخش سمت سرور ارتباط کارخواه-کارگزار در bup
bup-split(1): تقسیم یک پرونده منفرد به مجموعه پشتیبان اختصاصی خود
bup-tag(1): برچسب‌گذاری (تگ) یک کامیت در مخزن bup
bup-validate-object-links(1): پیمایش مخزن برای یافتن پیوندهای خراب اشیاء
bup-validate-ref-links(1): بررسی ارجاعات مخزن برای پیوند به اشیاء مفقود
bup-version(1): گزارش شماره نسخه نسخه نصب‌شده bup شما.

دستورات تخصصی (ESOTERIC COMMANDS)

bup-bloom(1): تولید، بازتولید و به‌روزرسانی فیلترهای بلوم
bup-damage(1): تخریب عمدی داده‌ها (برای آزمون پایداری)
bup-margin(1): تعیین میزان نزدیکی مخزن bup به نقطه بحرانی ظرفیت
bup-memtest(1): آزمون آمار مصرف حافظه در bup
bup-meta(1): ایجاد یا استخراج یک بایگانی فراداده
bup-midx(1): نمایه‌سازی اشیاء برای تسریع پشتیبان‌گیری‌های آینده
bup-random(1): تولید یک جریان خروجی تصادفی
bup-tick(1): انتظار تا حداکثر یک ثانیه.

گزینه‌های دوردست (REMOTE OPTIONS)

برخی گزینه‌ها (در حال حاضر تنها --remote) امکان تعیین مسیر دوردست را به صورت یک نشانی وب URL (بخش نشانی‌های وب مخزن (REPOSITORY URLS) در زیر را ببینید) یا به صورت [*user*@]*host*:[*path*] فراهم می‌کنند.

برای هر دو فرمت، هنگامی که هیچ مسیری وجود ندارد، مسیر پیش‌فرض روی سرور استفاده خواهد شد (BUP_DIR در صورت تنظیم در محیط سرور یا ~/.bup)، و تنظیمات SSH برای اتصال می‌تواند توسط یک میزبان سفارشی در پرونده ~/.ssh/config شما تأمین شود (ssh_config(5)).

آرگومان ورودی زمانی به عنوان نشانی URL در نظر گرفته می‌شود که با یک پیشوند طرحواره URL معتبر آغاز شود که حاوی “مرجع اعتبار (authority)” باشد (به این معنا که با SCHEME:// آغاز شود، همانند ssh://...)، و طرحواره باید یکی از دو حالت ssh یا bup باشد؛ سایر موارد رد خواهند شد.

برای نحو [*user*@]*host*:[*path*]، اگر نماد @ وجود داشته باشد، هر آنچه قبل از راست‌ترین @ باشد در بخش user قرار می‌گیرد، بنابراین -r x@y@z نشان‌دهنده کاربر x@y و میزبان z است. پس از بخش host همواره باید دونقطه بیاید و هر چیزی بعد از اولین دونقطه به عنوان path در نظر گرفته می‌شود.

برای اهداف کلی، نشانی‌های URL نسبت به فرمت [*user*@]*host*:[*path*] ترجیح داده می‌شوند تا ابهامی وجود نداشته باشد. برای نمونه، مورد (نامحتمل) را در نظر بگیرید که در آن ssh://x/y برای میزبانی به نام ssh و مسیر //x/y تولید شود، که در این حالت به عنوان یک URL با میزبان x و مسیر /y تفسیر خواهد شد.

نشانی‌های وب مخزن (REPOSITORY URLS)

نرم‌افزار Bup از طرحواره‌های URL زیر (یعنی scheme:) برای ارجاع به یک مخزن پشتیبانی می‌کند. توجه داشته باشید که اصطلاح “مرجع اعتبار (authority)” در زیر صرفاً به معنای بخشی از URL است که پس از scheme:// و قبل از مسیر قرار می‌گیرد، به عنوان مثال “user@host:port” در یک URL از نوع SSH.

به عنوان استثنایی بر استاندارد، یک طرحواره می‌تواند “مسیرمحور (path-oriented)” باشد، که به این معناست که هیچ پرس‌وجو یا تکه مجزایی وجود ندارد. هر چیزی پس از مرجع اعتبار (اختیاری) به عنوان “مسیر” در نظر گرفته می‌شود و بایت‌های تشکیل‌دهنده آن رمزگشایی نمی‌شوند (مثلاً percent decoded نمی‌شوند). این امر به نشانی‌های وب ارائه‌شده در خط فرمان اجازه می‌دهد تا به طور طبیعی کار کنند. بنابراین ssh://host/x?z دارای مسیر /x?z است.

و از آنجا که نشانی‌های URL دارای مرجع اعتبار نمی‌توانند مسیرهای نسبی را نشان دهند، طرحواره‌های مسیرمحور یک /./ آغازین را به عنوان مسیر نسبی تفسیر می‌کنند. بنابراین ssh://host/./x، file:///./x، و file:/./x همگی مسیر x را نشان می‌دهند.

ssh:: طرحواره‌ای مسیرمحور (به بالا رجوع کنید) که دسترسی به مخزن را از طریق اجرای یک bup-server(1) روی میزبان از طریق SSH مشخص می‌کند. این طرحواره دارای نحو و معنایی منطبق با یک URL معمول ssh: است، از جمله پشتیبانی از کاربر و درگاه (مانند ssh://user@host:2222/some/repo)، و کاربر و میزبان می‌توانند percent-encode شوند.
bup:: طرحواره‌ای مسیرمحور (به بالا رجوع کنید) که اتصال مستقیم شبکه‌ای به یک bup-server(1) موجود را مشخص می‌کند. در غیر این صورت همسان با ssh: است، با این تفاوت که از کاربر پشتیبانی نمی‌کند. این اتصال احراز هویت یا رمزنگاری اختصاصی خود را ندارد، بنابراین بعید است که بخواهید از آن استفاده کنید؛ ترجیحاً از file: یا ssh: استفاده کنید.
file:: طرحواره‌ای مسیرمحور (به بالا رجوع کنید) که مسیر سیستم‌فایل یک مخزن را مشخص می‌کند. این طرحواره دارای نحو و مفاهیمی منطبق با یک URL معمول file: است، با این تفاوت که تنها مرجع اعتبار خالی را می‌پذیرد (یعنی بدون کاربر، میزبان و غیره).

در بیشتر موارد، احتمالاً ترجیح می‌دهید مرجع اعتبار خالی را لحاظ کنید تا نیازی به بررسی دقیق محتویات مسیر نداشته باشید؛ یعنی هنگامی که PATH با یک اسلش آغاز می‌شود از file://PATH یا ssh://user@hostPATH استفاده کنید، و هنگامی که با اسلش آغاز نمی‌شود از file:///./PATH یا ssh://user@host/./PATH استفاده کنید. حذف مرجع اعتبار امکان‌پذیر است، اما تنها در صورتی که مسیر با دو اسلش آغاز نشود. برای نمونه file:/ و file:some/where مشکلی ندارند، اما file://some/where معتبر نیست زیرا some به عنوان مرجع اعتبار خوانده خواهد شد.

محیط (ENVIRONMENT)

BUP_ASSUME_GIT_VERSION_IS_FINE: اگر روی true، yes یا 1 تنظیم شود، فرض می‌شود که نسخه git موجود در مسیر PATH مناسب و قابل قبول است.

همچنین ببینید (SEE ALSO)

پرونده README از توزیع bup، git(1)، و http://bup.github.io

نویسندگان (AUTHORS)

Avery Pennarun apenwarr@gmail.com.