نام (NAME)

bupstash-restore - بازیابی اسنپشات یا فایلها در دایرکتوری سیستمفایل

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

بازیابی کارآمد محتویات یک اسنپ‌شات در یک دایرکتوری محلی.

bupstash restore [گزینه‌ها] --into $PATH QUERY...

توضیحات (DESCRIPTION)

دستور bupstash restore مجموعه‌ای کارآمد از تغییرات افزایشی را بر روی یک دایرکتوری اعمال می‌کند تا محتوای آن دقیقاً مشابه اسنپ‌شات درخواستی شود. ماهیت افزایشی bupstash restore آن را برای جابه‌جایی مکرر میان چندین اسنپ‌شات مشابه بسیار مناسب می‌سازد. توجه داشته باشید که این عملیات خطرناک است زیرا فایل‌های اضافی موجود در دایرکتوری مقصد را حذف می‌کند.

به منظور تسهیل مرور فایل‌ها برای کاربران عادی (فاقد دسترسی ریشه)، bupstash restore به‌طور پیش‌فرض تلاشی برای بازیابی مالکان، گروه‌ها و xattrs انجام نمی‌دهد. برای تنظیم این موارد باید به ترتیب گزینه‌های --ownership و --xattrs را مشخص کنید.

آیتمی که واکشی و بازیابی می‌شود، بر اساس یک پرس‌وجوی ساده روی برچسب‌های مشخص‌شده هنگام ذخیره داده‌ها با bupstash put انتخاب می‌گردد.

زبان پرس‌وجو (QUERY LANGUAGE)

برای مستندات کامل درباره زبان پرس‌وجو، به bupstash-query-language(7) مراجعه کنید.

حافظه موقت پرس‌وجو (QUERY CACHING)

دستور restore از همان سازوکارهای کش‌کردن پرس‌وجو مانند bupstash-list(1) استفاده می‌کند؛ برای اطلاعات بیشتر درباره کش پرس‌وجو، آن صفحه را بررسی کنید.

فایل‌های کم‌پشت (SPARSE FILES)

اگر فایلی در حین اجرای 'put' به‌عنوان فایل کم‌پشت (sparse) شناسایی شده باشد، دستور restore آن را به‌صورت کم‌پشت بازیابی خواهد کرد، اما باید توجه داشت که این دستور یک فایل موجود با چکسام صحیح را برای بازسازی مجدد آن به‌صورت کم‌پشت حذف نخواهد کرد.

گزینه‌ها (OPTIONS)

--into PATH

دایرکتوری برای بازیابی فایل‌ها در آن؛ مقدار پیش‌فرض آن BUPSTASH_RESTORE_DIR است.

-r, --repository REPO

مخزنی که باید به آن متصل شد؛ در صورت پیکربندی دسترسی ssh برای مخازن راه دور، می‌تواند به شکل ssh://$SERVER/$PATH باشد. در صورت عدم تعیین، از BUPSTASH_REPOSITORY استفاده می‌شود.

-k, --key KEY

کلیدی که برای رمزگشایی داده‌ها و متاداده‌ها استفاده خواهد شد. در صورت عدم تنظیم، مقدار پیش‌فرض آن BUPSTASH_KEY است.

--pick PATH

انتخاب یک زیردایرکتوری از اسنپ‌شات برای بازیابی.

--ownership

تنظیم شناسه‌های کاربری (uid) و گروهی (gid).

--xattrs

تنظیم ویژگی‌های گسترده (xattrs).

--indexer-threads N

تعداد نخ‌های پردازنده مورد استفاده برای هش‌کردن موازی فایل‌ها به روش خط لوله‌ای و خواندن متاداده. پیش‌فرض برابر با تعداد پردازنده‌ها است.

--query-cache PATH

مسیر فایل حافظه موقت پرس‌وجو؛ در صورت تنظیم متغیرهای محیطی مربوطه، به‌ترتیب اولویت یکی از موارد $BUPSTASH_QUERY_CACHE، $XDG_CACHE_HOME/.cache/bupstash/bupstash.qcache یا $HOME/.cache/bupstash/bupstash.qcache خواهد بود.

--utc-timestamps

نمایش و جستجو بر اساس برچسب‌های زمانی با زمان UTC به‌جای زمان محلی.

--no-progress

غیرفعال کردن نشانگرهای پیشرفت (در صورتی که stderr یک ترمینال تعاملی نباشد نیز نشانگرهای پیشرفت غیرفعال می‌شوند).

-q, --quiet

حالت بی‌صدا؛ متضمن --no-progress است.

متغیرهای محیطی (ENVIRONMENT)

BUPSTASH_REPOSITORY

مخزنی که باید به آن متصل شد. در صورت پیکربندی دسترسی ssh برای مخازن راه دور، می‌تواند به شکل ssh://$SERVER/$PATH باشد.

BUPSTASH_REPOSITORY_COMMAND

دستوری که برای اتصال به یک نمونه از bupstash-serve(1) اجرا می‌شود. این امکان اتصالات پیچیده‌تر به مخزن را برای کاربردهای خاص فراهم می‌کند.

BUPSTASH_KEY

مسیر کلیدی که برای رمزگشایی داده‌ها و متاداده‌ها استفاده خواهد شد.

BUPSTASH_KEY_COMMAND

دستوری برای اجرا که باید داده‌های کلید را چاپ کند؛ می‌تواند به‌جای BUPSTASH_KEY برای واکشی کلید از مکان‌های دلخواه مانند شبکه یا سایر فضاهای ذخیره‌سازی امن استفاده شود.

BUPSTASH_QUERY_CACHE

مسیر فایل حافظه موقت پرس‌وجو جهت استفاده.

BUPSTASH_RESTORE_DIR

مسیر مقصد بازیابی؛ می‌تواند به‌جای گزینه --into استفاده شود.

مثال‌ها (EXAMPLES)

$ bupstash restore --into ./dir id=ad8*

$ bupstash restore --ownership --into ./dir id=ad8*

$ bupstash restore --into ./dir --pick sub/dir id=ad8*

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

bupstash(1), bupstash-get(1), bupstash-list(1), bupstash-keyfiles(7), bupstash-query-language(7)