.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "bup\-ls" "1" "2026\-09\-01" "Bup 0.34+"
.SH "نام (NAME)"
bup\-ls \- فهرست کردن فایل‌ها و ساختار دایرکتوری درون مخزن bup
.SH "خلاصه دستور (SYNOPSIS)"
bup ls [\-r \f[I]host\f[R]:[\f[I]path\f[R]]] [OPTION\&...]
<paths\&...>
.SH "توضیحات (DESCRIPTION)"
دستور \f[CR]bup ls\f[R] فایل‌ها و دایرکتوری‌های موجود در مخزن bup شما را با استفاده از همان ساختار سلسله‌مراتبی دایرکتوری که در \f[CR]bup\-fuse\f[R](1) دارند، فهرست می‌کند.
.PP
دایرکتوری بالاترین سطح حاوی شاخه (متناظر با گزینه \f[CR]\-n\f[R] در \f[CR]bup save\f[R]) است، سطح بعدی تاریخ پشتیبان‌گیری است، و سطوح بعدی متناظر با فایل‌های موجود در نسخه پشتیبان هستند.
.PP
هنگامی که خروجی \f[CR]bup ls\f[R] روی یک tty درخواست شود و \f[CR]\-l\f[R] مشخص نشده باشد، خروجی را در ستون‌هایی قالب‌بندی می‌کند تا بتواند بیشترین موارد ممکن را در کمترین خطوط ممکن فهرست کند.
اما هنگامی که \f[CR]\-l\f[R] مشخص شده باشد یا خروجی bup به جایی غیر از tty هدایت شود (مثلاً خروجی را به دستوری دیگر لوله‌کشی (pipe) کنید یا آن را به یک فایل تغییر مسیر دهید)، نام هر فایل را در یک خط جداگانه چاپ خواهد کرد.
این امر پردازش و تجزیه فهرست را با ابزارهای خارجی آسان‌تر می‌کند.
.PP
توجه داشته باشید که \f[CR]bup ls\f[R] به صورت پیش‌فرض فایل‌های مخفی را نشان نمی‌دهد و برای نمایش آن‌ها باید از گزینه \f[CR]\-a\f[R] استفاده کنید.
فایل‌ها زمانی مخفی در نظر گرفته می‌شوند که نام آن‌ها با یک نقطه آغاز شود.
برای نمونه، در بالاترین سطح، دایرکتوری‌های ویژه‌ای به نام‌های \f[CR].commit\f[R] و \f[CR].tag\f[R] دایرکتوری‌های مخفی هستند.
.PP
پس از اینکه فایل مورد نظر خود را با استفاده از \f[CR]bup ls\f[R] پیدا کردید، می‌توانید محتوای آن را با استفاده از \f[CR]bup join\f[R] یا \f[CR]git show\f[R] مشاهده کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP
\-r, \-\-remote=[\f[I]user\f[R]\(at]\f[I]host\f[R]:[\f[I]path\f[R]], \-\-remote=URL
دریافت اطلاعات از مخزن دوردست مشخص‌شده، که به صورت پیش‌فرض از طریق SSH انجام می‌شود.
برای اطلاعات بیشتر، بخش REMOTE OPTIONS در \f[CR]bup\f[R](1) را ببینید.
.TP
\-s, \-\-hash
نمایش هش (hash) برای هر فایل/دایرکتوری.
.TP
\-a, \-\-all
نمایش فایل‌های مخفی.
.TP
\-A, \-\-almost\-all
نمایش فایل‌های مخفی، به جز \(lq.\(rq و \(lq..\(rq.
.TP
\-d, \-\-directory
نمایش اطلاعات خود دایرکتوری‌ها به جای محتویات آن‌ها، و دنبال نکردن پیوندهای نمادین (symlinks).
.TP
\-l
ارائه فهرست تفصیلی و طولانی برای هر مورد.
.TP
\-F, \-\-classify
افزودن نشانگر نوع: dir/ برای دایرکتوری، symlink\(at برای پیوند نمادین، fifo| برای لوله نام‌دار، socket= برای سوکت، و * برای فایل‌های اجرایی.
.TP
\-\-file\-type
افزودن نشانگر نوع: dir/ برای دایرکتوری، symlink\(at برای پیوند نمادین، fifo| برای لوله نام‌دار، socket= برای سوکت.
.TP
\-\-human\-readable
چاپ اندازه فایل‌ها به صورت خوانا برای انسان (مانند 3.9K, 4.7M).
.TP
\-\-numeric\-ids
نمایش شناسه‌های عددی (کاربر، گروه و غیره) به جای نام‌ها.
.SH "مثال‌ها (EXAMPLES)"
.IP
.EX
bup ls /myserver/latest/etc/profile

bup ls \-a /
.EE
.SH "همچنین ببینید (SEE ALSO)"
\f[CR]bup\-join\f[R](1), \f[CR]bup\-fuse\f[R](1),
\f[CR]bup\-ftp\f[R](1), \f[CR]bup\-save\f[R](1),
\f[CR]git\-show\f[R](1), \f[CR]ssh_config\f[R](5)
.SH "BUP"
بخشی از مجموعه‌ابزار \f[CR]bup\f[R](1).
.SH "نویسندگان (AUTHORS)"
Avery Pennarun \c
.MT apenwarr@gmail.com
.ME \c.