نام (NAME)

bupstash-sync - همگامسازی دادهها میان دو مخزن bupstash

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

همگام‌سازی آیتم‌ها و داده‌ها از یک مخزن bupstash به مخزنی دیگر.

bupstash sync [گزینه‌ها] --to REMOTE [پرس‌وجو...]

توضیحات (DESCRIPTION)

دستور bupstash sync آیتم‌ها و داده‌ها را از یک مخزن به مخزنی دیگر رونوشت (کپی) می‌کند، در حالی که تلاش می‌نماید مصرف غیرضروری پهنای باند را به حداقل برساند.

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

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

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

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

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

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

گزینه‌ها (OPTIONS)

-r, --repository REPO

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

--to REPO

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

-k, --key KEY

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

--query-cache PATH

مسیر فایل حافظه موقت پرس‌وجو (query-cache). در صورت تنظیم بودن متغیرهای محیطی مربوطه، به ترتیب اولویت پیش‌فرض یکی از مقادیر زیر است: $BUPSTASH_QUERY_CACHE یا $XDG_CACHE_HOME/.cache/bupstash/bupstash.qcache یا $HOME/.cache/bupstash/bupstash.qcache.

--query-encrypted

پرس‌وجو هیچ متاداده‌ای را رمزگشایی نخواهد کرد؛ این امر به شما امکان می‌دهد آیتم‌هایی را که کلید رمزگشایی آن‌ها را ندارید فهرست کنید. این گزینه برچسب پرس‌وجوی فرضی 'decryption-key-id' را درج می‌کند.

--ids-from-stdin

همگام‌سازی آیتم‌ها با شناسه‌های خوانده‌شده از stdin، هر شناسه در یک خط، به جای اجرای پرس‌وجو.

--utc-timestamps

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

--no-progress

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

-q, --quiet

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

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

BUPSTASH_REPOSITORY

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

BUPSTASH_REPOSITORY_COMMAND

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

BUPSTASH_TO_REPOSITORY

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

BUPSTASH_TO_REPOSITORY_COMMAND

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

BUPSTASH_KEY

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

BUPSTASH_KEY_COMMAND

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

BUPSTASH_QUERY_CACHE

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

مثال‌ها (EXAMPLES)

$ bupstash sync --repository ./local-repository --to ssh://$REMOTE

$ export BUPSTASH_REPOSITORY=./local-repository
$ id="$(bupstash put ./some-files)"
$ bupstash sync --to ssh://$REMOTE id="$id"

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

bupstash(1), bupstash-query-language(7)