نام (NAME)

bup-save - ذخیره یک درخت دایرکتوری در مخزن bup

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

bup save [-r host:path] <-t|-c|-n name> [-#] [-f indexfile] [-v] [-q] [--smaller=maxsize] <paths...>;

توضیحات (DESCRIPTION)

دستور bup save محتویات فایل‌ها یا مسیرهای داده‌شده را در یک مجموعه پشتیبان جدید ذخیره می‌کند و به‌صورت اختیاری روی آن مجموعه پشتیبان نام‌گذاری انجام می‌دهد.

توجه داشته باشید که برای ارجاع به مجموعه پشتیبان خود در آینده (مثلاً برای بازیابی)، باید یا گزینه --name را مشخص کنید (حالت معمول)، یا شناسه درخت (tree id) یا شناسه کامیت (commit id) چاپ‌شده توسط --tree یا --commit را ذخیره نمایید.

پیش از اقدام به ذخیره فایل‌ها با استفاده از bup save، ابتدا باید نمایه را با استفاده از bup index به‌روزرسانی کنید. دلایل تفکیک این دو مرحله در صفحه راهنمای bup-index(1) شرح داده شده است.

به‌طور پیش‌فرض، متاداده برای هر مسیر ذخیره می‌شود، و متاداده برای هر دایرکتوری والد نمایه‌نشده از مسیرهای دارای نمایه، مستقیماً از سیستم‌فایل برداشته خواهد شد. با این حال، اگر --strip، --strip-path، یا --graft مشخص شده باشد، متاداده برای دایرکتوری ریشه (/) ذخیره نخواهد شد. برای اطلاعات بیشتر در مورد مدیریت متاداده‌ها، bup-restore(1) را ببینید.

گزینه‌ها (OPTIONS)

-r, --remote=[user@]host:[path], --remote=URL: داده‌ها را در مخزن دوردست مشخص‌شده ذخیره می‌کند، به‌طور پیش‌فرض از طریق SSH. برای اطلاعات بیشتر به بخش REMOTE OPTIONS در bup(1) مراجعه کنید.
-t, --tree: پس از ایجاد مجموعه پشتیبان، شناسه درخت گیت (git tree id) نسخه پشتیبان حاصل را چاپ می‌کند.
-c, --commit: پس از ایجاد مجموعه پشتیبان، شناسه کامیت گیت (git commit id) نسخه پشتیبان حاصل را چاپ می‌کند.
-n, --name=name: پس از ایجاد مجموعه پشتیبان، یک شاخه گیت با نام name ایجاد می‌کند تا بتوان با استفاده از آن نام به پشتیبان دسترسی پیدا کرد. اگر name از قبل وجود داشته باشد، پشتیبان جدید به‌عنوان فرزندی از name قدیمی در نظر گرفته می‌شود. (بنابراین، می‌توانید مرتباً مجموعه‌های پشتیبان جدیدی با همان نام ایجاد کنید، و بعداً تاریخچه آن مجموعه پشتیبان را بررسی کنید تا ببینید فایل‌ها در طول زمان چگونه تغییر کرده‌اند.)
-d, --date=date: تاریخ پشتیبان‌گیری را برحسب ثانیه‌های گذشته از مبدأ زمان (epoch)، به‌جای زمان کنونی مشخص می‌کند.
-f, --indexfile=indexfile: استفاده از یک نام فایل نمایه متفاوت به‌جای $BUP_DIR/bupindex.
-v, --verbose: افزایش پرگویی گزارش رویدادها (می‌توان بیش از یک بار از آن استفاده کرد). با یک بار استفاده از -v، نام هر دایرکتوری هنگام پشتیبان‌گیری چاپ می‌شود. با دو بار استفاده از -v، نام تمامی فایل‌ها نیز چاپ خواهد شد.
-q, --quiet: غیرفعال کردن پیام‌های پیشرفت کار.
--smaller=maxsize: از فایل‌هایی با اندازه بزرگ‌تر یا مساوی maxsize بایت پشتیبان‌گیری نمی‌کند. می‌توانید از این گزینه برای پشتیبان‌گیری افزایشی متناوب و سریع از فایل‌های کوچک خود استفاده کنید، و فایل‌های بزرگی (مانند ایمیج‌های ماشین مجازی) را که زمان بیشتری می‌برند نادیده بگیرید. سپس می‌توانید از فایل‌های بزرگ در فواصل زمانی طولانی‌تری پشتیبان تهیه کنید. برای مشخص کردن مضارب ۱۰۲۴، ۱۰۲۴*۱۰۲۴، یا ۱۰۲۴*۱۰۲۴*۱۰۲۴ به‌ترتیب از پسوندهایی مانند k، M یا G استفاده کنید.
--bwlimit=bytes/sec: بیش از bytes/sec بایت در ثانیه به سرور ارسال نمی‌کند. این گزینه برای جلوگیری از مصرف تمام پهنای باند شبکه شما توسط فرآیند پشتیبان‌گیری مناسب است. برای مشخص کردن مضارب ۱۰۲۴، ۱۰۲۴*۱۰۲۴، یا ۱۰۲۴*۱۰۲۴*۱۰۲۴ به‌ترتیب از پسوندهایی مانند k، M یا G استفاده کنید.
--strip: مسیر داده‌شده را از تمامی فایل‌ها و دایرکتوری‌ها می‌پیراید (حذف می‌کند).

یک دایرکتوری /root/chroot/etc که با “bup save -n chroot --strip /root/chroot” ذخیره شده باشد، به‌صورت /etc ذخیره خواهد شد. توجه داشته باشید که در حال حاضر، هنگام مشخص شدن این گزینه، متاداده برای دایرکتوری ریشه (/) ذخیره نخواهد شد.

--strip-path=path-prefix: پیشوند مسیر داده‌شده path-prefix را از تمامی فایل‌ها و دایرکتوری‌ها حذف می‌کند.

یک دایرکتوری /root/chroot/webserver/etc که با “bup save -n webserver --strip-path=/root/chroot /root/chroot/webserver/etc” ذخیره شده باشد، به‌صورت /webserver/etc ذخیره خواهد شد. توجه داشته باشید که در حال حاضر، هنگام مشخص شدن این گزینه، متاداده برای دایرکتوری ریشه (/) ذخیره نخواهد شد.

--graft=old_path=new_path: یک نقطه پیوند old_path=new_path تعیین می‌کند (می‌تواند بیش از یک بار استفاده شود).

یک دایرکتوری /root/chroot/a/etc که با “bup save -n chroot --graft /root/chroot/a=/chroot/a” ذخیره شده باشد، به‌صورت /chroot/a/etc ذخیره خواهد شد. توجه داشته باشید که در حال حاضر، هنگام مشخص شدن این گزینه، متاداده برای دایرکتوری ریشه (/) ذخیره نخواهد شد.

-#, --compress=#: سطح فشرده‌سازی را روی # تنظیم می‌کند (مقداری از ۰ تا ۹، که ۹ بالاترین سطح و ۰ بدون فشرده‌سازی است). پیش‌فرض بر روی pack.compression یا core.compression پیکربندی‌شده، یا ۱ (فشرده‌سازی سریع و سبک) است.

تنظیمات (SETTINGS)

دستور bup save از گزینه پیکربندی bup.split.trees تبعیت می‌کند (صفحه راهنمای bup-config(5) را ببینید). توجه داشته باشید که این گزینه باید در مخزنی که در حال نوشتن روی آن است تنظیم شود؛ بنابراین برای مثال، در مخزن BUP_DIR یا مخزن تعیین‌شده با -d برای bup save ... بدون -r، و در مخزن دوردست برای bup save -r ....

مثال‌ها (EXAMPLES)

$ bup index -ux /etc
Indexing: 1981, done.
$ bup save -r myserver: -n my-pc-backup --bwlimit=50k /etc
Reading index: 1981, done.
Saving: 100.00% (998/998k, 1981/1981 files), done.
$ ls /home/joe/chroot/httpd
bin var
$ bup index -ux /home/joe/chroot/httpd
Indexing: 1337, done.
$ bup save --strip -n joes-httpd-chroot /home/joe/chroot/httpd
Reading index: 1337, done.
Saving: 100.00% (998/998k, 1337/1337 files), done.
$ bup ls joes-httpd-chroot/latest/
bin/
var/
$ bup save --strip-path=/home/joe/chroot -n joes-chroot \
     /home/joe/chroot/httpd
Reading index: 1337, done.
Saving: 100.00% (998/998k, 1337/1337 files), done.
$ bup ls joes-chroot/latest/
httpd/
$ bup save --graft /home/joe/chroot/httpd=/http-chroot \
     -n joe
     /home/joe/chroot/httpd
Reading index: 1337, done.
Saving: 100.00% (998/998k, 1337/1337 files), done.
$ bup ls joe/latest/
http-chroot/

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

bup-index(1), bup-split(1), bup-on(1), bup-restore(1), ssh_config(5)

درباره BUP (BUP)

بخشی از مجموعه bup(1).

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

Avery Pennarun apenwarr@gmail.com.