نام (NAME)

bupstash-get - دریافت و بارگیری فایلها یا زیردرختها از یک اسنپشات

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

دریافت داده‌ها از یک مخزن bupstash.

bupstash get [گزینه‌ها] QUERY...

توضیحات (DESCRIPTION)

دستور bupstash get داده‌های ذخیره‌شده در یک مخزن bupstash را واکشی و رمزگشایی کرده و به خروجی استاندارد (stdout) ارسال می‌کند. اگر آیتم درخواستی به‌صورت یک دایرکتوری ذخیره شده باشد، این دستور آن را به یک جریان tar تبدیل می‌کند.

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

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

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

حافظه پنهان پرس‌وجو (QUERY CACHING)

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

فایل‌های تنک (SPARSE FILES)

هنگام دریافت یک دایرکتوری به‌صورت آرشیو tarball، با فایل‌های تنک رفتاری ویژه صورت نمی‌گیرد؛ برای بازیابی فایل‌های تنک با حفظ فضاهای خالی (holes) فایل، به‌جای این دستور از bupstash restore استفاده کنید.

گزینه‌ها (OPTIONS)

-r, --repository REPO: مخزنی که باید به آن متصل شد؛ در صورت پیکربندی دسترسی ssh برای مخازن راه‌دور، می‌تواند به صورت ssh://$SERVER/$PATH باشد. در صورت مشخص نشدن، بر روی مقدار BUPSTASH_REPOSITORY تنظیم می‌شود.
-k, --key KEY: کلیدی که برای رمزگشایی داده‌ها و متاداده استفاده می‌شود. در صورت عدم تنظیم، مقدار پیش‌فرض آن BUPSTASH_KEY خواهد بود.
--pick PATH: واکشی یک فایل مجزا یا زیردایرکتوری از یک اسنپ‌شات.
--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: مسیر فایل حافظه پنهان پرس‌وجو برای استفاده.

مثال‌ها (EXAMPLES)

دریافت یک آیتم با شناسه مشخص

$ bupstash get id=14ebd2073b258b1f55c5bbc889c49db4 > ./data.file

دریافت یک آیتم بر اساس نام و برچسب زمانی

$ bupstash get name=backup.tar and timestamp=2020/19/* > ./restore.tar

دریافت یک فایل یا زیر-tar از یک اسنپ‌شات دایرکتوری

$ bupstash get --pick=path/to/file.txt id=$id
$ bupstash get --pick=path/to/dir id=$id | tar ...

دریافت یک آرشیو tarball

قابلیت داخلی قرار دادن دایرکتوری، یک tarball از دایرکتوری ایجاد می‌کند، بنابراین برای استخراج آن از tar استفاده می‌کنیم.

# ایجاد اسنپ‌شات از یک دایرکتوری.
$ id=$(bupstash put ./data)
# واکشی محتویات یک اسنپ‌شات و استخراج با tar
$ mkdir restore
$ bupstash get id=$id | tar -C ./restore -xvf -

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

bupstash(1), bupstash-put(1), bupstash-list(1), bupstash-restore(1), bupstash-rm(1), bupstash-keyfiles(7), bupstash-query-language(7)