.TH BUPSTASH-RESTORE 1 "2026-09-01" "bupstash" "User Commands"
.SH "نام (NAME)"
bupstash-restore \- بازیابی اسنپشات یا فایلها در دایرکتوری سیستمفایل
.SH "خلاصه دستور (SYNOPSIS)"
بازیابی کارآمد محتویات یک اسنپ‌شات در یک دایرکتوری محلی.
.P
\fBbupstash restore\fR [\fIگزینه‌ها\fR] \fB\-\-into\fR \fI$PATH\fR \fIQUERY\fR\|\.\|\.\|\.
.SH "توضیحات (DESCRIPTION)"
دستور
.B bupstash restore
مجموعه‌ای کارآمد از تغییرات افزایشی را بر روی یک دایرکتوری اعمال می‌کند تا محتوای آن دقیقاً مشابه اسنپ‌شات درخواستی شود. ماهیت افزایشی
.B bupstash restore
آن را برای جابه‌جایی مکرر میان چندین اسنپ‌شات مشابه بسیار مناسب می‌سازد. توجه داشته باشید که این عملیات خطرناک است زیرا فایل‌های اضافی موجود در دایرکتوری مقصد را حذف می‌کند.
.P
به منظور تسهیل مرور فایل‌ها برای کاربران عادی (فاقد دسترسی ریشه)،
.B bupstash restore
به‌طور پیش‌فرض تلاشی برای بازیابی مالکان، گروه‌ها و xattrs انجام نمی‌دهد. برای تنظیم این موارد باید به ترتیب گزینه‌های
.B \-\-ownership
و
.B \-\-xattrs
را مشخص کنید.
.P
آیتمی که واکشی و بازیابی می‌شود، بر اساس یک پرس‌وجوی ساده روی برچسب‌های مشخص‌شده هنگام ذخیره داده‌ها با
.B bupstash put
انتخاب می‌گردد.
.SH "زبان پرس‌وجو (QUERY LANGUAGE)"
برای مستندات کامل درباره زبان پرس‌وجو، به
.BR bupstash\-query\-language (7)
مراجعه کنید.
.SH "حافظه موقت پرس‌وجو (QUERY CACHING)"
دستور restore از همان سازوکارهای کش‌کردن پرس‌وجو مانند
.BR bupstash\-list (1)
استفاده می‌کند؛ برای اطلاعات بیشتر درباره کش پرس‌وجو، آن صفحه را بررسی کنید.
.SH "فایل‌های کم‌پشت (SPARSE FILES)"
اگر فایلی در حین اجرای 'put' به‌عنوان فایل کم‌پشت (sparse) شناسایی شده باشد، دستور restore آن را به‌صورت کم‌پشت بازیابی خواهد کرد، اما باید توجه داشت که این دستور یک فایل موجود با چکسام صحیح را برای بازسازی مجدد آن به‌صورت کم‌پشت حذف نخواهد کرد.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-into\fR \fIPATH\fR
دایرکتوری برای بازیابی فایل‌ها در آن؛ مقدار پیش‌فرض آن
.B BUPSTASH_RESTORE_DIR
است.
.TP
\fB\-r\fR, \fB\-\-repository\fR \fIREPO\fR
مخزنی که باید به آن متصل شد؛ در صورت پیکربندی دسترسی ssh برای مخازن راه دور، می‌تواند به شکل
\fBssh://$SERVER/$PATH\fR
باشد. در صورت عدم تعیین، از
.B BUPSTASH_REPOSITORY
استفاده می‌شود.
.TP
\fB\-k\fR, \fB\-\-key\fR \fIKEY\fR
کلیدی که برای رمزگشایی داده‌ها و متاداده‌ها استفاده خواهد شد. در صورت عدم تنظیم، مقدار پیش‌فرض آن
.B BUPSTASH_KEY
است.
.TP
\fB\-\-pick\fR \fIPATH\fR
انتخاب یک زیردایرکتوری از اسنپ‌شات برای بازیابی.
.TP
\fB\-\-ownership\fR
تنظیم شناسه‌های کاربری (uid) و گروهی (gid).
.TP
\fB\-\-xattrs\fR
تنظیم ویژگی‌های گسترده (xattrs).
.TP
\fB\-\-indexer\-threads\fR \fIN\fR
تعداد نخ‌های پردازنده مورد استفاده برای هش‌کردن موازی فایل‌ها به روش خط لوله‌ای و خواندن متاداده. پیش‌فرض برابر با تعداد پردازنده‌ها است.
.TP
\fB\-\-query\-cache\fR \fIPATH\fR
مسیر فایل حافظه موقت پرس‌وجو؛ در صورت تنظیم متغیرهای محیطی مربوطه، به‌ترتیب اولویت یکی از موارد
\fB$BUPSTASH_QUERY_CACHE\fR،
\fB$XDG_CACHE_HOME/\.cache/bupstash/bupstash\.qcache\fR
یا
\fB$HOME/\.cache/bupstash/bupstash\.qcache\fR
خواهد بود.
.TP
\fB\-\-utc\-timestamps\fR
نمایش و جستجو بر اساس برچسب‌های زمانی با زمان UTC به‌جای زمان محلی.
.TP
\fB\-\-no\-progress\fR
غیرفعال کردن نشانگرهای پیشرفت (در صورتی که stderr یک ترمینال تعاملی نباشد نیز نشانگرهای پیشرفت غیرفعال می‌شوند).
.TP
\fB\-q\fR, \fB\-\-quiet\fR
حالت بی‌صدا؛ متضمن
.B \-\-no\-progress
است.
.SH "متغیرهای محیطی (ENVIRONMENT)"
.TP
.B BUPSTASH_REPOSITORY
مخزنی که باید به آن متصل شد. در صورت پیکربندی دسترسی ssh برای مخازن راه دور، می‌تواند به شکل
\fBssh://$SERVER/$PATH\fR
باشد.
.TP
.B BUPSTASH_REPOSITORY_COMMAND
دستوری که برای اتصال به یک نمونه از
.BR bupstash\-serve (1)
اجرا می‌شود. این امکان اتصالات پیچیده‌تر به مخزن را برای کاربردهای خاص فراهم می‌کند.
.TP
.B BUPSTASH_KEY
مسیر کلیدی که برای رمزگشایی داده‌ها و متاداده‌ها استفاده خواهد شد.
.TP
.B BUPSTASH_KEY_COMMAND
دستوری برای اجرا که باید داده‌های کلید را چاپ کند؛ می‌تواند به‌جای
.B BUPSTASH_KEY
برای واکشی کلید از مکان‌های دلخواه مانند شبکه یا سایر فضاهای ذخیره‌سازی امن استفاده شود.
.TP
.B BUPSTASH_QUERY_CACHE
مسیر فایل حافظه موقت پرس‌وجو جهت استفاده.
.TP
.B BUPSTASH_RESTORE_DIR
مسیر مقصد بازیابی؛ می‌تواند به‌جای گزینه
.B \-\-into
استفاده شود.
.SH "مثال‌ها (EXAMPLES)"
.SS "بازیابی یک اسنپ‌شات در یک دایرکتوری محلی"
.nf
$ bupstash restore \-\-into \./dir id=ad8*
.fi
.SS "بازیابی به همراه مالکان و گروه‌ها"
.nf
$ bupstash restore \-\-ownership \-\-into \./dir id=ad8*
.fi
.SS "بازیابی یک زیردایرکتوری از اسنپ‌شات"
.nf
$ bupstash restore \-\-into \./dir \-\-pick sub/dir id=ad8*
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR bupstash (1),
.BR bupstash\-get (1),
.BR bupstash\-list (1),
.BR bupstash\-keyfiles (7),
.BR bupstash\-query\-language (7)