نام (NAME)

bup-ls - فهرست کردن فایل‌ها و ساختار دایرکتوری درون مخزن bup

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

bup ls [-r host:[path]] [OPTION...] <paths...>

توضیحات (DESCRIPTION)

دستور bup ls فایل‌ها و دایرکتوری‌های موجود در مخزن bup شما را با استفاده از همان ساختار سلسله‌مراتبی دایرکتوری که در bup-fuse(1) دارند، فهرست می‌کند.

دایرکتوری بالاترین سطح حاوی شاخه (متناظر با گزینه -n در bup save) است، سطح بعدی تاریخ پشتیبان‌گیری است، و سطوح بعدی متناظر با فایل‌های موجود در نسخه پشتیبان هستند.

هنگامی که خروجی bup ls روی یک tty درخواست شود و -l مشخص نشده باشد، خروجی را در ستون‌هایی قالب‌بندی می‌کند تا بتواند بیشترین موارد ممکن را در کمترین خطوط ممکن فهرست کند. اما هنگامی که -l مشخص شده باشد یا خروجی bup به جایی غیر از tty هدایت شود (مثلاً خروجی را به دستوری دیگر لوله‌کشی (pipe) کنید یا آن را به یک فایل تغییر مسیر دهید)، نام هر فایل را در یک خط جداگانه چاپ خواهد کرد. این امر پردازش و تجزیه فهرست را با ابزارهای خارجی آسان‌تر می‌کند.

توجه داشته باشید که bup ls به صورت پیش‌فرض فایل‌های مخفی را نشان نمی‌دهد و برای نمایش آن‌ها باید از گزینه -a استفاده کنید. فایل‌ها زمانی مخفی در نظر گرفته می‌شوند که نام آن‌ها با یک نقطه آغاز شود. برای نمونه، در بالاترین سطح، دایرکتوری‌های ویژه‌ای به نام‌های .commit و .tag دایرکتوری‌های مخفی هستند.

پس از اینکه فایل مورد نظر خود را با استفاده از bup ls پیدا کردید، می‌توانید محتوای آن را با استفاده از bup join یا git show مشاهده کنید.

گزینه‌ها (OPTIONS)

-r, --remote=[user@]host:[path], --remote=URL

دریافت اطلاعات از مخزن دوردست مشخص‌شده، که به صورت پیش‌فرض از طریق SSH انجام می‌شود. برای اطلاعات بیشتر، بخش REMOTE OPTIONS در bup(1) را ببینید.

-s, --hash

نمایش هش (hash) برای هر فایل/دایرکتوری.

-a, --all

نمایش فایل‌های مخفی.

-A, --almost-all

نمایش فایل‌های مخفی، به جز “.” و “..”.

-d, --directory

نمایش اطلاعات خود دایرکتوری‌ها به جای محتویات آن‌ها، و دنبال نکردن پیوندهای نمادین (symlinks).

-l

ارائه فهرست تفصیلی و طولانی برای هر مورد.

-F, --classify

افزودن نشانگر نوع: dir/ برای دایرکتوری، symlink@ برای پیوند نمادین، fifo| برای لوله نام‌دار، socket= برای سوکت، و * برای فایل‌های اجرایی.

--file-type

افزودن نشانگر نوع: dir/ برای دایرکتوری، symlink@ برای پیوند نمادین، fifo| برای لوله نام‌دار، socket= برای سوکت.

--human-readable

چاپ اندازه فایل‌ها به صورت خوانا برای انسان (مانند 3.9K, 4.7M).

--numeric-ids

نمایش شناسه‌های عددی (کاربر، گروه و غیره) به جای نام‌ها.

مثال‌ها (EXAMPLES)

bup ls /myserver/latest/etc/profile
bup ls -a /

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

bup-join(1), bup-fuse(1), bup-ftp(1), bup-save(1), git-show(1), ssh_config(5)

BUP

بخشی از مجموعه‌ابزار bup(1).

نویسندگان (AUTHORS)

Avery Pennarun apenwarr@gmail.com.