.TH BUPSTASH-DIFF 1 "2026-09-01" "bupstash" "User Commands"
.SH "نام (NAME)"
bupstash-diff \- مقایسه دو اسنپشات یا یک اسنپشات با دایرکتوری سیستمفایل
.SH "خلاصه دستور (SYNOPSIS)"
مقایسه دو اسنپ‌شات و چاپ خلاصه تفاوت‌ها در خروجی استاندارد (stdout)\.
.P
\fBbupstash diff\fR [\fIگزینه‌ها\fR] \fIپرس‌وجو۱\fR\|\.\|\.\|\. :: \fIپرس‌وجو۲\fR\|\.\|\.\|\.
.SH "توضیحات (DESCRIPTION)"
دستور
\fBbupstash diff\fR
فهرست دو اسنپ‌شات را از کارساز (سرور) دوردست واکشی کرده و آن‌ها را مقایسه می‌کند، سپس خروجی خطوط تفاوت (diff) را در خروجی استاندارد چاپ می‌نماید\. در یک حالت خاص، اگر هر یک از پرس‌وجوها با \&'\./' یا \&'/' آغاز شود، یک فهرست موقت برای آن دایرکتوری محلی جهت مقایسه ایجاد می‌گردد\.
.P
استفاده از
\fBbupstash diff\fR
بر اجرای دستور سنتی
\fBdiff\fR
روی خروجی
\fBbupstash list\-contents\fR
ترجیح داده می‌شود، زیرا هنگام انجام عملیات مقایسه، دقت کامل برچسب‌های زمانی و همچنین هش ذخیره‌شده فایل‌ها را در نظر می‌گیرد\.
.P
ابزار Bupstash از نادیده‌گرفتن موارد مشخص در مقایسه diff برای کمک به تحلیل پشتیبانی می‌کند\. نمونه‌های کاربردی شامل مقادیر
\fB\-\-ignore\fR
مانند
\fBtimes\fR
برای نادیده‌گرفتن برچسب زمانی تغییر فایل‌ها و
\fBcontent\fR
برای نادیده‌گرفتن تغییرات اندازه و هش فایل‌ها است\.
.SH "قالب خروجی (OUTPUT FORMAT)"
خروجی با ساختار
\fBbupstash list\-contents\fR
سازگار است، با این تفاوت که ابتدای هر خط با یکی از علامت‌های
\fB+\fR
یا
\fB\-\fR
پیشوندگذاری می‌شود که به ترتیب نشان‌دهنده موارد حذف‌شده یا اضافه‌شده هستند\.
.P
مشخص‌کردن
\fB\-\-format\fR
قالب خروجی پایه را همان‌طور که در
.BR bupstash\-list\-contents (1)
توضیح داده شده است تغییر می‌دهد\. بدون در نظر گرفتن قالب خروجی، خطوط همچنان با
\fB+\fR
یا
\fB\-\fR
پیشوندگذاری می‌شوند\.
.SH "زبان پرس‌وجو (QUERY LANGUAGE)"
برای مستندات کامل درباره زبان پرس‌وجو، به
.BR bupstash\-query\-language (7)
مراجعه کنید\.
.SH "حافظه موقت پرس‌وجو (QUERY CACHING)"
دستور diff از سازوکارهای کش (حافظه موقت) پرس‌وجوی مشابه
.BR bupstash\-list (1)
استفاده می‌کند؛ برای اطلاعات بیشتر درباره کش پرس‌وجو به آن صفحه مراجعه کنید\.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-r ", " \-\-repository " \fIREPO\fR"
مخزنی که باید به آن متصل شد؛ در صورت پیکربندی دسترسی ssh برای مخازن دوردست، می‌تواند به شکل
\fBssh://$SERVER/$PATH\fR
باشد\. در صورت عدم تعیین، از مقدار متغیر
\fBBUPSTASH_REPOSITORY\fR
استفاده می‌شود\.
.TP
.BR \-k ", " \-\-key " \fIKEY\fR"
کلید مورد استفاده برای رمزگشایی داده‌ها و متاداده‌ها\. در صورت تنظیم نشدن، مقدار پیش‌فرض آن
\fBBUPSTASH_KEY\fR
است\.
.TP
.BI \-\-query\-cache " PATH"
مسیر فایل حافظه موقت پرس‌وجو (query-cache)؛ در صورت تنظیم بودن متغیرهای محیطی مربوطه، به ترتیب اولویت پیش‌فرض یکی از مقادیر زیر است:
\fB$BUPSTASH_QUERY_CACHE\fR
یا
\fB$XDG_CACHE_HOME/\.cache/bupstash/bupstash\.qcache\fR
یا
\fB$HOME/\.cache/bupstash/bupstash\.qcache\fR\.
.TP
.BR \-i ", " \-\-ignore
فهرستی از مشخصه‌های فایل جداشده با ویرگول (کاما) برای نادیده‌گرفتن در مقایسه‌ها\. مقادیر معتبر عبارتند از:
\&'content,dev,devnos,inode,type,perms,nlink,uid,gid,times,xattrs'
.TP
.B \-\-relaxed
میان‌بری برای
.B \-\-ignore 'dev,inode,nlink,uid,gid,times,xattrs'
است\. این گزینه برای مقایسه محتوا بدون درگیر شدن با متاداده‌های وابسته به ماشین بسیار کاربردی است\.
.TP
\fB\-\-{left,right}\-pick\fR \fIPATH\fR
انجام مقایسه (diff) بر روی یک زیردایرکتوری از پرس‌وجوی سمت چپ یا راست\.
.TP
.BI \-\-indexer\-threads " N"
تعداد رشته‌های پردازنده (threads) برای محاسبه موازی و خط‌لوله‌ای هش فایل‌ها و خواندن متاداده‌ها\. پیش‌فرض برابر با تعداد پردازنده‌ها است\.
.TP
.B \-\-xattrs
واکشی ویژگی‌های گسترش‌یافته (xattrs) هنگام نمایه‌سازی دایرکتوری‌های محلی\.
.TP
.BI \-\-format " FORMAT"
تنظیم قالب خروجی به یکی از موارد 'human' یا 'jsonl'\.
.TP
.B \-\-utc\-timestamps
نمایش و جستجو بر اساس برچسب‌های زمانی به وقت جهانی (UTC) به جای زمان محلی\.
.TP
.B \-\-no\-progress
غیرفعال‌سازی نشانگرهای پیشرفت (اگر stderr یک ترمینال تعاملی نباشد نیز نشانگرهای پیشرفت غیرفعال می‌شوند)\.
.TP
.BR \-q ", " \-\-quiet
اجرای بی‌صدا؛ شامل
.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
مسیر فایل حافظه موقت پرس‌وجو (query cache) جهت استفاده\.
.SH "مثال‌ها (EXAMPLES)"
.SS "مقایسه دو اسنپ‌شات با پرس‌وجو"
.nf
$ bupstash diff id="14eb*" :: id="57de*"
\- \-rw\-r\-\-r\-\- 1\.1kB hello\.txt
+ \-rw\-r\-\-r\-\- 1\.3kB goodbye\.txt
.fi
.SS "مقایسه یک اسنپ‌شات با یک دایرکتوری محلی"
.nf
$ bupstash diff \-\-left\-pick files \-\-relaxed id="57de*" :: \./files
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR bupstash (1),
.BR bupstash\-list (1),
.BR bupstash\-keyfiles (7),
.BR bupstash\-query\-language (7)