نام (NAME)

bupstash-list-contents - فهرست کردن محتویات آیتم‌های ذخیره پشتیبان bupstash

خلاصه دستور (SYNOPSIS)

فهرست کردن محتویات اسنپ‌شات.

bupstash list-contents [گزینه‌ها] پرس‌وجو...

توضیحات (DESCRIPTION)

دستور bupstash list-contents محتویات آیتم منطبق با پرس‌وجوی مشخص‌شده را فهرست می‌کند.

آیتم‌هایی که با استفاده از bupstash put بر روی یک دایرکتوری ایجاد شده‌اند دارای یک نمایه (index) مرتبط خواهند بود؛ سایر آیتم‌ها قابل فهرست‌کردن نیستند.

قالب‌های خروجی (OUTPUT FORMATS)

Human

هنگامی که --format روی human تنظیم شده باشد، bupstash list-contents سطرهای تراز شده‌ای شامل موارد زیر خروجی می‌دهد:

PERMS SIZE YYYY/MM/DD HH:MM:SS PATH...

تاریخ گنجانده‌شده، زمان آخرین تغییر در فایل مربوطه است که توسط سیستم‌عامل در زمان تهیه اسنپ‌شات گزارش شده است.

هنگام نوشتن اسکریپت‌ها، استفاده از یکی از قالب‌های نسخه‌دار و خوانا توسط ماشین را ترجیح دهید.

JSONl1

هنگامی که --format روی jsonl1 تنظیم شده باشد، bupstash list-contents در هر سطر یک شیء JSON خروجی می‌دهد.

هر سطر دارای طرح‌واره (schema) جیسون زیر است:

{
  "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
}

زبان پرس‌وجو (QUERY LANGUAGE)

برای مستندات کامل درباره زبان پرس‌وجو، به bupstash-query-language(7) مراجعه کنید.

حافظه موقت پرس‌وجو (QUERY CACHING)

دستور list-contents از همان سازوکارهای حافظه موقت پرس‌وجو مشابه با bupstash-list(1) استفاده می‌کند؛ برای اطلاعات بیشتر درباره حافظه موقت پرس‌وجو، آن صفحه را بررسی کنید.

گزینه‌ها (OPTIONS)

-r, --repository REPO: مخزنی که باید به آن متصل شد؛ در صورت پیکربندی دسترسی ssh برای مخازن دوردست، می‌تواند به شکل ssh://$SERVER/$PATH باشد. در صورت عدم تعیین، از مقدار متغیر BUPSTASH_REPOSITORY استفاده می‌شود.
-k, --key KEY: کلید اصلی مورد استفاده برای رمزگشایی داده‌ها و متاداده‌ها. در صورت تنظیم نشدن، مقدار پیش‌فرض آن BUPSTASH_KEY است.
--format FORMAT: تنظیم قالب خروجی به یکی از موارد 'human' یا 'jsonl'.
--query-cache PATH: مسیر فایل حافظه موقت پرس‌وجو (query-cache)؛ در صورت تنظیم بودن متغیرهای محیطی مربوطه، به ترتیب اولویت پیش‌فرض یکی از مقادیر زیر است: $BUPSTASH_QUERY_CACHE یا $XDG_CACHE_HOME/.cache/bupstash/bupstash.qcache یا $HOME/.cache/bupstash/bupstash.qcache.
--pick PATH: فهرست کردن یک زیردایرکتوری از پرس‌وجو.
--utc-timestamps: نمایش و جستجو بر اساس برچسب‌های زمانی به وقت جهانی (UTC) به جای زمان محلی.
-q, --quiet: اجرای بی‌صدا؛ متضمن --no-progress است.

محیط (ENVIRONMENT)

BUPSTASH_REPOSITORY: مخزنی که باید به آن متصل شد. در صورت پیکربندی دسترسی ssh می‌تواند برای مخازن دوردست به شکل ssh://$SERVER/$PATH باشد.
BUPSTASH_REPOSITORY_COMMAND: دستوری برای اجرا جهت اتصال به یک نمونه از bupstash-serve(1). این متغیر اتصالات پیچیده‌تری را به مخزن برای کاربردهای خاص فراهم می‌کند.
BUPSTASH_KEY: مسیر کلید اصلی که برای رمزگشایی داده‌ها و متاداده‌ها استفاده خواهد شد.
BUPSTASH_KEY_COMMAND: دستوری برای اجرا که باید داده‌های کلید را در خروجی چاپ کند؛ می‌تواند به جای BUPSTASH_KEY برای واکشی کلید از مکان‌های دلخواه مانند شبکه یا سایر فضاهای ذخیره‌سازی محرمانه به کار رود.
BUPSTASH_QUERY_CACHE: مسیر فایل حافظه موقت پرس‌وجو (query cache) جهت استفاده.

مثال‌ها (EXAMPLES)

دریافت یک آیتم با شناسه‌ای مشخص از مخزن

$ 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

همچنین ببینید (SEE ALSO)

bupstash(1), bupstash-put(1), bupstash-diff(1), bupstash-keyfiles(7), bupstash-query-language(7)