.TH BUPSTASH-GET 1 "2026-09-01" "bupstash" "User Commands"
.SH "نام (NAME)"
bupstash-get \- دریافت و بارگیری فایلها یا زیردرختها از یک اسنپشات
.SH "خلاصه دستور (SYNOPSIS)"
دریافت داده‌ها از یک مخزن bupstash.
.P
\fBbupstash get\fR [\fIگزینه‌ها\fR] \fIQUERY\fR\|\.\|\.\|\.
.SH "توضیحات (DESCRIPTION)"
دستور
.B bupstash get
داده‌های ذخیره‌شده در یک مخزن bupstash را واکشی و رمزگشایی کرده و به خروجی استاندارد (stdout) ارسال می‌کند. اگر آیتم درخواستی به‌صورت یک دایرکتوری ذخیره شده باشد، این دستور آن را به یک جریان tar تبدیل می‌کند.
.P
آیتمی که دریافت می‌شود بر اساس یک پرس‌وجوی ساده بر روی برچسب‌هایی (tags) انتخاب می‌شود که هنگام ذخیره داده‌ها با
.B bupstash put
مشخص شده‌اند.
.SH "زبان پرس‌وجو (QUERY LANGUAGE)"
برای مستندات کامل در مورد زبان پرس‌وجو،
.BR bupstash\-query\-language (7)
را ببینید.
.SH "حافظه پنهان پرس‌وجو (QUERY CACHING)"
دستور get از همان سازوکارهای حافظه پنهان پرس‌وجو مانند
.BR bupstash\-list (1)
استفاده می‌کند؛ برای اطلاعات بیشتر درباره حافظه پنهان پرس‌وجو، آن صفحه را بررسی کنید.
.SH "فایل‌های تنک (SPARSE FILES)"
هنگام دریافت یک دایرکتوری به‌صورت آرشیو tarball، با فایل‌های تنک رفتاری ویژه صورت نمی‌گیرد؛ برای بازیابی فایل‌های تنک با حفظ فضاهای خالی (holes) فایل، به‌جای این دستور از
.B bupstash restore
استفاده کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-r\fR, \fB\-\-repository\fR \fIREPO\fR
مخزنی که باید به آن متصل شد؛ در صورت پیکربندی دسترسی ssh برای مخازن راه‌دور، می‌تواند به صورت
\fBssh://$SERVER/$PATH\fR
باشد. در صورت مشخص نشدن، بر روی مقدار
\fBBUPSTASH_REPOSITORY\fR
تنظیم می‌شود.
.TP
\fB\-k\fR, \fB\-\-key\fR \fIKEY\fR
کلیدی که برای رمزگشایی داده‌ها و متاداده استفاده می‌شود. در صورت عدم تنظیم، مقدار پیش‌فرض آن
\fBBUPSTASH_KEY\fR
خواهد بود.
.TP
\fB\-\-pick\fR \fIPATH\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
اجرای بی‌صدا؛ متضمن
\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_KEY
مسیر کلیدی که برای رمزگشایی داده‌ها و متاداده استفاده می‌شود.
.TP
.B BUPSTASH_KEY_COMMAND
دستوری که باید داده‌های کلید را چاپ کند؛ می‌تواند به‌جای
.B BUPSTASH_KEY
برای واکشی کلید از مکان‌های دلخواه مانند شبکه یا سایر فضاهای ذخیره‌سازی امن استفاده شود.
.TP
.B BUPSTASH_QUERY_CACHE
مسیر فایل حافظه پنهان پرس‌وجو برای استفاده.
.SH "مثال‌ها (EXAMPLES)"
.SS "دریافت یک آیتم با شناسه مشخص"
.nf
$ bupstash get id=14ebd2073b258b1f55c5bbc889c49db4 > \./data\.file
.fi
.SS "دریافت یک آیتم بر اساس نام و برچسب زمانی"
.nf
$ bupstash get name=backup\.tar and timestamp=2020/19/* > \./restore\.tar
.fi
.SS "دریافت یک فایل یا زیر-tar از یک اسنپ‌شات دایرکتوری"
.nf
$ bupstash get \-\-pick=path/to/file\.txt id=$id
$ bupstash get \-\-pick=path/to/dir id=$id | tar \|\.\|\.\|\.
.fi
.SS "دریافت یک آرشیو tarball"
قابلیت داخلی قرار دادن دایرکتوری، یک tarball از دایرکتوری ایجاد می‌کند، بنابراین برای استخراج آن از tar استفاده می‌کنیم.
.IP "" 4
.nf
# ایجاد اسنپ‌شات از یک دایرکتوری.
$ id=$(bupstash put \./data)

# واکشی محتویات یک اسنپ‌شات و استخراج با tar
$ mkdir restore
$ bupstash get id=$id | tar \-C \./restore \-xvf \-
.fi
.IP "" 0
.SH "همچنین ببینید (SEE ALSO)"
.BR bupstash (1),
.BR bupstash\-put (1),
.BR bupstash\-list (1),
.BR bupstash\-restore (1),
.BR bupstash\-rm (1),
.BR bupstash\-keyfiles (7),
.BR bupstash\-query\-language (7)