نام (NAME)

restic-stats - پویش مخزن و نمایش آمارهای پایه

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

restic stats [flags] [snapshot ID] [...]

توضیحات (DESCRIPTION)

دستور «stats» در یک یا چند اسنپ‌شات در مخزن پیمایش کرده و آمار مربوط به داده‌های ذخیره‌شده در آن‌ها را گردآوری می‌کند. این دستور تعداد فایل‌های یکتا و اندازه آن‌ها را بر اساس یکی از حالت‌های شمارش تعیین‌شده توسط گزینه --mode گزارش می‌دهد.

این دستور روی تمام اسنپ‌شات‌هایی که با معیارهای انتخاب مطابقت دارند یا در صورت عدم تعیین، روی همه اسنپ‌شات‌ها اعمال می‌شود. شناسه اسنپ‌شات ویژه «latest» نیز پشتیبانی می‌شود. بسته به این‌که قصد محاسبه چه چیزی را دارید، برخی حالت‌ها روی یک اسنپ‌شات منفرد معنادارتر هستند، در حالی که حالت‌های دیگر روی تمام اسنپ‌شات‌ها کاربرد دارند.

حالت‌ها عبارتند از:

• restore-size: (پیش‌فرض) اندازه فایل‌های بازیابی‌شده را شمارش می‌کند.
• files-by-contents: اندازه کل فایل‌های یکتا را شمارش می‌کند، در صورتی که یک فایل تنها زمانی یکتا در نظر گرفته می‌شود که محتوای یکتا داشته باشد.
• raw-data: اندازه blobها را در مخزن شمارش می‌کند، بدون در نظر گرفتن این‌که چه تعداد فایل به آن‌ها ارجاع داده باشند.
• blobs-per-file: ترکیبی از files-by-contents و raw-data است.

برای جزئیات بیشتر درباره هر حالت به راهنمای برخط مراجعه کنید.

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

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

گزینه‌ها (OPTIONS)

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

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

--mode="restore-size" حالت شمارش: restore-size (پیش‌فرض)، files-by-contents، blobs-per-file یا raw-data

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

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

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

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

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

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

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

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

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

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

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

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

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

--limit-upload=0 محدود کردن بارگذاری به حداکثر نرخ بر حسب KiB/s. (پیش‌فرض: نامحدود)

--no-cache[=false] عدم استفاده از کش محلی

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

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

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

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

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

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

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

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

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

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

--stuck-request-timeout=5m0s مدت‌زمان پیش از تلاش مجدد برای درخواست‌های متوقف‌شده

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

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

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

restic(1)