نام (NAME)

restic-ls - فهرست کردن فایل‌های موجود در یک اسنپ‌شات

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

restic ls [flags] snapshotID [dir...]

توضیحات (DESCRIPTION)

دستور «ls» فایل‌ها و دایرکتوری‌های موجود در یک اسنپ‌شات را فهرست می‌کند.

شناسهٔ ویژهٔ اسنپ‌شات «latest» می‌تواند برای فهرست کردن فایل‌ها و دایرکتوری‌های تازه‌ترین اسنپ‌شات موجود در مخزن استفاده شود. پرچم --host می‌تواند در کنار آن به کار رود تا تنها تازه‌ترین اسنپ‌شات ایجادشده از یک میزبان خاص انتخاب گردد.

فهرست فایل‌ها را می‌توان به صورت اختیاری بر اساس دایرکتوری‌ها فیلتر کرد. هر آرگومان مکانی پس از شناسهٔ اسنپ‌شات، به عنوان مسیر مطلق دایرکتوری تفسیر می‌شود و تنها فایل‌های درون آن دایرکتوری‌ها فهرست خواهند شد. در صورت استفاده از پرچم --recursive، فیلتر اجازهٔ پیمایش درون زیرپوشه‌های دایرکتوری‌های منطبق را می‌دهد. هر مسیر دایرکتوری مشخص‌شده باید مطلق باشد (با یک جداکنندهٔ مسیر آغاز شود)؛ مسیرها از ممیز رو به جلو «/» به عنوان جداکننده استفاده می‌کنند.

فهرست فایل‌ها را می‌توان با تعیین --sort به همراه یکی از مشخص‌کننده‌های مرتب‌سازی «(name|size|time=mtime|atime|ctime|extension)» مرتب کرد. این مرتب‌سازی را می‌توان با مشخص کردن --reverse معکوس کرد.

وضعیت خروج (EXIT STATUS)

وضعیت خروج در صورت موفقیت‌آمیز بودن دستور 0 است. وضعیت خروج در صورت بروز هرگونه خطا 1 است. وضعیت خروج در صورتی که مخزن وجود نداشته باشد 10 است. وضعیت خروج در صورتی که مخزن از قبل قفل شده باشد 11 است. وضعیت خروج در صورتی که گذرواژه نادرست باشد 12 است.

گزینه‌ها (OPTIONS)

-h, --help[=false] راهنمای ls

-H, --host=[] تنها اسنپ‌شات‌های مربوط به این host در نظر گرفته شوند، هنگامی که شناسه اسنپ‌شات «latest» داده شده باشد (می‌تواند چندین بار مشخص شود، برای بازنشانی مقدار پیش‌فرض از رشته خالی استفاده کنید) (پیش‌فرض: $RESTIC_HOST)

--human-readable[=false] چاپ اندازه‌ها در قالب خوانا برای انسان

-l, --long[=false] استفاده از قالب فهرست‌بندی طولانی که اندازه و حالت دسترسی را نمایش می‌دهد

--ncdu[=false] خروجی در قالب صدور NCDU (ارسال با لوله به 'ncdu -f -')

--path=[] تنها اسنپ‌شات‌های شامل این path (مطلق) در نظر گرفته شوند، هنگامی که شناسه اسنپ‌شات «latest» داده شده باشد (می‌تواند چندین بار مشخص شود؛ اسنپ‌شات‌ها باید شامل تمام مسیرهای مشخص‌شده باشند)

--recursive[=false] شامل کردن فایل‌های موجود در زیرپوشه‌های دایرکتوری‌های فهرست‌شده

--reverse[=false] معکوس کردن خروجی مرتب‌شده

-s, --sort=name مرتب‌سازی خروجی بر اساس (name|size|time=mtime|atime|ctime|extension)

--tag=[] تنها اسنپ‌شات‌های شامل tag[,tag,...] در نظر گرفته شوند، هنگامی که شناسه اسنپ‌شات «latest» داده شده باشد (می‌تواند چندین بار مشخص شود)

گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)

--cacert=[] file برای بارگذاری گواهی‌های ریشه از آن (پیش‌فرض: استفاده از گواهی‌های سیستم یا $RESTIC_CACERT)

--cache-dir="" تنظیم directory حافظهٔ پنهان. (پیش‌فرض: استفاده از دایرکتوری حافظهٔ پنهان پیش‌فرض سیستم)

--cleanup-cache[=false] حذف خودکار دایرکتوری‌های قدیمی حافظهٔ پنهان

--compression=auto حالت فشرده‌سازی (تنها برای نسخهٔ ۲ قالب مخزن در دسترس است)، یکی از (auto|off|fastest|better|max) (پیش‌فرض: $RESTIC_COMPRESSION)

--http-user-agent="" تنظیم http user agent برای درخواست‌های خروجی http

--insecure-no-password[=false] استفاده از گذرواژهٔ خالی برای مخزن؛ باید به هر دستور restic داده شود (ناامن)

--insecure-tls[=false] صرف‌نظر از اعتبارسنجی گواهی TLS هنگام اتصال به مخزن (ناامن)

--json[=false] تنظیم حالت خروجی به JSON برای دستوراتی که از آن پشتیبانی می‌کنند

--key-hint="" شناسهٔ کلید (key ID) برای تلاش نخست جهت رمزگشایی (پیش‌فرض: $RESTIC_KEY_HINT)

--limit-download=0 محدود کردن دانلودها به بیشینهٔ rate بر حسب KiB/s. (پیش‌فرض: نامحدود)

--limit-upload=0 محدود کردن آپلودها به بیشینهٔ rate بر حسب KiB/s. (پیش‌فرض: نامحدود)

--no-cache[=false] عدم استفاده از حافظهٔ پنهان محلی

--no-extra-verify[=false] صرف‌نظر از اعتبارسنجی بیشتر داده‌ها پیش از آپلود (مستندات را ببینید)

--no-lock[=false] مخزن قفل نشود؛ این گزینه اجازهٔ برخی عملیات را روی مخازن فقط‌خواندنی می‌دهد

-o, --option=[] تنظیم گزینهٔ پیشرفته (key=value، می‌تواند چندین بار مشخص شود)

--pack-size=0 تنظیم size بستهٔ هدف بر حسب MiB؛ فایل‌های بستهٔ ایجادشده ممکن است بزرگ‌تر باشند (پیش‌فرض: $RESTIC_PACK_SIZE)

--password-command="" دستور شل (command) برای دریافت گذرواژهٔ مخزن از آن (پیش‌فرض: $RESTIC_PASSWORD_COMMAND)

-p, --password-file="" file برای خواندن گذرواژهٔ مخزن از آن (پیش‌فرض: $RESTIC_PASSWORD_FILE)

-q, --quiet[=false] عدم نمایش گزارش جامع پیشرفت در خروجی

-r, --repo="" مخزن (repository) برای پشتیبان‌گیری در آن یا بازیابی از آن (پیش‌فرض: $RESTIC_REPOSITORY)

--repository-file="" file برای خواندن مکان مخزن از آن (پیش‌فرض: $RESTIC_REPOSITORY_FILE)

--retry-lock=0s تلاش مجدد برای قفل کردن مخزن در صورتی که از قبل قفل باشد؛ مقداری مانند 5m یا 2h می‌پذیرد (پیش‌فرض: بدون تلاش مجدد)

--stuck-request-timeout=5m0s مدت‌زمان (duration) که پس از آن، درخواست‌های متوقف‌شده دوباره تلاش شوند

--tls-client-cert="" مسیر یک file حاوی گواهی کلاینت TLS و کلید خصوصی با کدگذاری PEM (پیش‌فرض: $RESTIC_TLS_CLIENT_CERT)

-v, --verbose[=0] پرگو بودن خروجی (چندین بار مشخص کنید یا با --verbose=n یک سطح تعیین نمایید، بیشینهٔ سطح/دفعات ۲ است)

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

restic(1)