.nh
.TH "restic backup" "1" "Jan 2017" "تولید شده توسط \fBrestic generate\fR" ""

.SH "نام (NAME)"
restic-ls \- فهرست کردن فایل‌های موجود در یک اسنپ‌شات


.SH "خلاصه دستور (SYNOPSIS)"
\fBrestic ls [flags] snapshotID [dir...]\fP


.SH "توضیحات (DESCRIPTION)"
دستور «ls» فایل‌ها و دایرکتوری‌های موجود در یک اسنپ‌شات را فهرست می‌کند.

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

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

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


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


.SH "گزینه‌ها (OPTIONS)"
\fB-h\fP, \fB--help\fP[=false]
	راهنمای ls

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

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

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

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

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

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

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

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

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


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB--cacert\fP=[]
	\fBfile\fR برای بارگذاری گواهی‌های ریشه از آن (پیش‌فرض: استفاده از گواهی‌های سیستم یا $RESTIC_CACERT)

.PP
\fB--cache-dir\fP=""
	تنظیم \fBdirectory\fR حافظهٔ پنهان\&. (پیش‌فرض: استفاده از دایرکتوری حافظهٔ پنهان پیش‌فرض سیستم)

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

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

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

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

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

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

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

.PP
\fB--limit-download\fP=0
	محدود کردن دانلودها به بیشینهٔ \fBrate\fR بر حسب KiB/s\&. (پیش‌فرض: نامحدود)

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

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

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

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

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

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

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

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

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

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

.PP
\fB--repository-file\fP=""
	\fBfile\fR برای خواندن مکان مخزن از آن (پیش‌فرض: $RESTIC_REPOSITORY_FILE)

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

.PP
\fB--stuck-request-timeout\fP=5m0s
	مدت‌زمان (\fBduration\fR) که پس از آن، درخواست‌های متوقف‌شده دوباره تلاش شوند

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

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


.SH "همچنین ببینید (SEE ALSO)"
\fBrestic(1)\fP