.TH BUPSTASH-SYNC 1 "2026-09-01" "bupstash" "User Commands"
.SH "نام (NAME)"
bupstash-sync \- همگامسازی دادهها میان دو مخزن bupstash
.SH "خلاصه دستور (SYNOPSIS)"
همگام‌سازی آیتم‌ها و داده‌ها از یک مخزن bupstash به مخزنی دیگر\.
.P
\fBbupstash sync\fR [\fIگزینه‌ها\fR] \fB\-\-to\fR \fIREMOTE\fR [\fIپرس‌وجو\fR\|\.\|\.\|\.]
.SH "توضیحات (DESCRIPTION)"
دستور
\fBbupstash sync\fR
آیتم‌ها و داده‌ها را از یک مخزن به مخزنی دیگر رونوشت (کپی) می‌کند، در حالی که تلاش می‌نماید مصرف غیرضروری پهنای باند را به حداقل برساند\.
.P
یک کاربرد متداول این دستور، پشتیبان‌گیری از فایل‌ها در یک مخزن محلی (مانند یک درایو خارجی) و هم‌زمان بارگذاری بهینه آن‌ها در یک مکان دوردست برای نگهداری امن است\.
.P
توجه داشته باشید زمانی که هیچ پرس‌وجویی مشخص نشده باشد، تمام آیتم‌ها همگام‌سازی می‌شوند، حتی مواردی که با کلید فعلی bupstash مطابقت ندارند\.
.SH "زبان پرس‌وجو (QUERY LANGUAGE)"
برای مستندات کامل درباره زبان پرس‌وجو، به
.BR bupstash\-query\-language (7)
مراجعه کنید\.
.SH "حافظه موقت پرس‌وجو (QUERY CACHING)"
دستور
.B sync
از همان سازوکارهای حافظه موقت پرس‌وجو که در
.BR bupstash\-list (1)
استفاده شده بهره می‌برد؛ برای اطلاعات بیشتر در مورد حافظه موقت پرس‌وجو، آن صفحه را بررسی کنید\.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-r\fR, \fB\-\-repository\fR \fIREPO\fR
مخزنی که باید داده‌ها از آن همگام‌سازی شوند\. در صورت پیکربندی دسترسی ssh، می‌تواند برای مخازن راه‌دور به فرم
\fBssh://$SERVER/$PATH\fR
باشد\. اگر مشخص نشود، برابر با مقدار
\fBBUPSTASH_REPOSITORY\fR
تنظیم می‌شود\.
.TP
\fB\-\-to\fR \fIREPO\fR
مخزن مقصدی که آیتم‌ها باید با آن همگام‌سازی شوند\. در صورت پیکربندی دسترسی ssh، می‌تواند برای مخازن راه‌دور به فرم
\fBssh://$SERVER/$PATH\fR
باشد\. اگر مشخص نشود، برابر با مقدار
\fBBUPSTASH_TO_REPOSITORY\fR
تنظیم می‌شود\.
.TP
\fB\-k\fR, \fB\-\-key\fR \fIKEY\fR
کلید مورد استفاده برای رمزگشایی متاداده هنگام اجرای یک پرس‌وجو\. در صورت عدم تنظیم، مقدار پیش‌فرض آن
\fBBUPSTASH_KEY\fR
خواهد بود\.
.TP
\fB\-\-query\-cache\fR \fIPATH\fR
مسیر فایل حافظه موقت پرس‌وجو (query-cache)\. در صورت تنظیم بودن متغیرهای محیطی مربوطه، به ترتیب اولویت پیش‌فرض یکی از مقادیر زیر است:
\fB$BUPSTASH_QUERY_CACHE\fR
یا
\fB$XDG_CACHE_HOME/\.cache/bupstash/bupstash\.qcache\fR
یا
\fB$HOME/\.cache/bupstash/bupstash\.qcache\fR\.
.TP
\fB\-\-query\-encrypted\fR
پرس‌وجو هیچ متاداده‌ای را رمزگشایی نخواهد کرد؛ این امر به شما امکان می‌دهد آیتم‌هایی را که کلید رمزگشایی آن‌ها را ندارید فهرست کنید\. این گزینه برچسب پرس‌وجوی فرضی 'decryption\-key\-id' را درج می‌کند\.
.TP
\fB\-\-ids\-from\-stdin\fR
همگام‌سازی آیتم‌ها با شناسه‌های خوانده‌شده از stdin، هر شناسه در یک خط، به جای اجرای پرس‌وجو\.
.TP
\fB\-\-utc\-timestamps\fR
نمایش و جستجو بر اساس برچسب‌های زمانی در زمان UTC به جای زمان محلی\.
.TP
\fB\-\-no\-progress\fR
عدم نمایش نشانگرهای پیشرفت (نشانگرهای پیشرفت همچنین در صورتی که stderr یک ترمینال تعاملی نباشد، غیرفعال می‌شوند)\.
.TP
\fB\-q\fR, \fB\-\-quiet\fR
اجرای بی‌صدا؛ متضمن
\fB\-\-no\-progress\fR
است\.
.SH "متغیرهای محیطی (ENVIRONMENT)"
.TP
.B BUPSTASH_REPOSITORY
مخزنی که آیتم‌ها باید از آن واکشی شوند\. در صورت پیکربندی دسترسی ssh، می‌تواند برای مخازن راه‌دور به فرم
\fBssh://$SERVER/$PATH\fR
باشد\.
.TP
.B BUPSTASH_REPOSITORY_COMMAND
دستوری که برای اتصال به یک نمونه از
.BR bupstash\-serve (1)
اجرا می‌شود\. این متغیر امکان برقراری اتصالات پیچیده‌تر به مخزن را برای موارد کاربرد خاص فراهم می‌کند\.
.TP
.B BUPSTASH_TO_REPOSITORY
مخزن مقصدی که آیتم‌ها باید با آن همگام‌سازی شوند\. در صورت پیکربندی دسترسی ssh، می‌تواند برای مخازن راه‌دور به فرم
\fBssh://$SERVER/$PATH\fR
باشد\.
.TP
.B BUPSTASH_TO_REPOSITORY_COMMAND
دستوری که برای اتصال به یک نمونه از
.BR bupstash\-serve (1)
اجرا می‌شود\. این متغیر امکان برقراری اتصالات پیچیده‌تر به مخزن را برای موارد کاربرد خاص فراهم می‌کند\.
.TP
.B BUPSTASH_KEY
مسیر کلید اصلی که برای رمزگشایی داده‌ها و متاداده‌ها استفاده خواهد شد\.
.TP
.B BUPSTASH_KEY_COMMAND
دستوری که اجرا می‌شود و باید داده‌های کلید را چاپ کند؛ می‌تواند به جای
.B BUPSTASH_KEY
برای دریافت کلید از مکان‌های دلخواه مانند شبکه یا سایر فضاهای ذخیره‌سازی امن استفاده شود\.
.TP
.B BUPSTASH_QUERY_CACHE
مسیر فایل حافظه موقت پرس‌وجو (query cache) جهت استفاده\.
.SH "مثال‌ها (EXAMPLES)"
.SS "ارسال تمام آیتم‌ها از یک مخزن محلی به یک مخزن راه‌دور"
.nf
$ bupstash sync \-\-repository \./local\-repository \-\-to ssh://$REMOTE
.fi
.SS "اجرای پشتیبان‌گیری به صورت محلی و سپس همگام‌سازی یک نسخه با مخزن راه‌دور"
.nf
$ export BUPSTASH_REPOSITORY=\./local\-repository
$ id="$(bupstash put \./some\-files)"
$ bupstash sync \-\-to ssh://$REMOTE id="$id"
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR bupstash (1),
.BR bupstash\-query\-language (7)