.TH BUPSTASH-LIST-CONTENTS 1 "2026-09-01" "bupstash" "User Commands"
.SH "نام (NAME)"
bupstash-list-contents \- فهرست کردن محتویات آیتم‌های ذخیره پشتیبان bupstash
.SH "خلاصه دستور (SYNOPSIS)"
فهرست کردن محتویات اسنپ‌شات\.
.P
\fBbupstash list\-contents\fR [\fIگزینه‌ها\fR] \fIپرس‌وجو\fR\|\.\|\.\|\.
.SH "توضیحات (DESCRIPTION)"
دستور
\fBbupstash list\-contents\fR
محتویات آیتم منطبق با پرس‌وجوی مشخص‌شده را فهرست می‌کند\.
.P
آیتم‌هایی که با استفاده از
\fBbupstash put\fR
بر روی یک دایرکتوری ایجاد شده‌اند دارای یک نمایه (index) مرتبط خواهند بود؛ سایر آیتم‌ها قابل فهرست‌کردن نیستند\.
.SH "قالب‌های خروجی (OUTPUT FORMATS)"
.SS "Human"
هنگامی که
\fB\-\-format\fR
روی
\fBhuman\fR
تنظیم شده باشد،
\fBbupstash list\-contents\fR
سطرهای تراز شده‌ای شامل موارد زیر خروجی می‌دهد:
.IP "" 4
.nf
PERMS SIZE YYYY/MM/DD HH:MM:SS PATH\|\.\|\.\|\.
.fi
.IP "" 0
.P
تاریخ گنجانده‌شده، زمان آخرین تغییر در فایل مربوطه است که توسط سیستم‌عامل در زمان تهیه اسنپ‌شات گزارش شده است\.
.P
هنگام نوشتن اسکریپت‌ها، استفاده از یکی از قالب‌های نسخه‌دار و خوانا توسط ماشین را ترجیح دهید\.
.SS "JSONl1"
هنگامی که
\fB\-\-format\fR
روی
\fBjsonl1\fR
تنظیم شده باشد،
\fBbupstash list\-contents\fR
در هر سطر یک شیء JSON خروجی می‌دهد\.
.P
هر سطر دارای طرح‌واره (schema) جیسون زیر است:
.IP "" 4
.nf
{
  "path": string | [ bytes\|\.\|\.\|\. ],
  "mode": number,
  "size": number,
  "uid": number,
  "gid": number,
  "mtime": number,
  "mtime_nsec": number,
  "ctime": number,
  "ctime_nsec": number,
  "norm_dev": number,
  "ino": number,
  "nlink": number,
  "link_target": string | null,
  "dev_major": number | null,
  "dev_minor": number | null,
  "xattrs": {string : string | [bytes\|\.\|\.\|\.] \|\.\|\.\|\.} | null,
  "sparse": boolean,
  "data_hash": "$KIND[:$HEXBYTE]" | null
}
.fi
.IP "" 0
.SH "زبان پرس‌وجو (QUERY LANGUAGE)"
برای مستندات کامل درباره زبان پرس‌وجو، به
.BR bupstash\-query\-language (7)
مراجعه کنید\.
.SH "حافظه موقت پرس‌وجو (QUERY CACHING)"
دستور
.B list\-contents
از همان سازوکارهای حافظه موقت پرس‌وجو مشابه با
.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 \-\-format " FORMAT"
تنظیم قالب خروجی به یکی از موارد 'human' یا 'jsonl'\.
.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
.BI \-\-pick " PATH"
فهرست کردن یک زیردایرکتوری از پرس‌وجو\.
.TP
.B \-\-utc\-timestamps
نمایش و جستجو بر اساس برچسب‌های زمانی به وقت جهانی (UTC) به جای زمان محلی\.
.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 list\-contents id="14eb*"
drwxr\-xr\-x 0     2020/10/30 13:32:04 \.
\-rw\-r\-\-r\-\- 1967  2020/10/30 13:32:04 data\.txt
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR bupstash (1),
.BR bupstash\-put (1),
.BR bupstash\-diff (1),
.BR bupstash\-keyfiles (7),
.BR bupstash\-query\-language (7)