| borg-list(1) | borg backup tool | borg-list(1) |
نام (NAME)
borg-list - فهرست کردن محتوای بایگانی یا مخزن
خلاصه دستور (SYNOPSIS)
borg [common options] list [options] [REPOSITORY_OR_ARCHIVE] [PATH...]
توضیحات (DESCRIPTION)
این دستور محتویات یک مخزن یا بایگانی را فهرست میکند.
برای راهنمایی بیشتر درباره الگوهای گنجاندن/مستثنی کردن، خروجی دستور borg_patterns را ببینید.
گزینهها (OPTIONS)
برای گزینههای مشترک دستورات Borg به borg-common(1) مراجعه کنید.
آرگومانها (arguments)
- REPOSITORY_OR_ARCHIVE
- مخزن یا بایگانی برای فهرست کردن محتویات آن
- PATH
- مسیرهایی که باید فهرست شوند؛ از الگوها پشتیبانی میشود
گزینهها (options)
- --consider-checkpoints
- نمایش بایگانیهای وارسی (checkpoint) در فهرست محتوای مخزن (پیشفرض: پنهان).
- --short
- فقط چاپ نام پروندهها/پوشهها، بدون اطلاعات دیگر
- --format FORMAT
- تعیین قالب خروجی فهرست پروندهها یا بایگانیها (پیشفرض برای پروندهها: "{mode} {user:6} {group:6} {size:8} {mtime} {path}{extra}{NL}"؛ برای بایگانیها: "{archive:<36} {time} [{id}]{NL}")
- --json
- تنها برای فهرست کردن محتوای مخزن معتبر است. قالببندی خروجی به صورت JSON. ساختار --format نادیده گرفته میشود، اما کلیدهای استفاده شده در آن به خروجی JSON افزوده میشوند. برخی کلیدها همواره وجود دارند. نکته: JSON تنها میتواند متن را بازنمایی کند؛ بنابراین کلید "barchive" در دسترس نیست.
- --json-lines
- تنها برای فهرست کردن محتوای بایگانی معتبر است. قالببندی خروجی به صورت خطوط JSON (JSON Lines). ساختار --format نادیده گرفته میشود، اما کلیدهای استفاده شده در آن به خروجی JSON افزوده میشوند. برخی کلیدها همواره وجود دارند. نکته: JSON تنها میتواند متن را بازنمایی کند؛ بنابراین کلید "bpath" در دسترس نیست.
پالایههای بایگانی (Archive filters)
- -P PREFIX, --prefix PREFIX
- تنها در نظر گرفتن نامهای بایگانی که با این پیشوند شروع میشوند. (منسوخ شده)
- -a GLOB, --glob-archives GLOB
- تنها در نظر گرفتن نامهای بایگانی مطابق با الگوی glob. قواعد sh: اعمال میشوند (بدون استفاده صریح از پیشوند sh:)، به "borg help patterns" مراجعه کنید.
- --sort-by KEYS
- فهرست جداشده با کاما از کلیدهای مرتبسازی؛ کلیدهای معتبر: timestamp, archive, name, id؛ پیشفرض: timestamp
- --first N
- تنها بررسی N بایگانی اول پس از اعمال سایر پالایهها
- --last N
- تنها بررسی N بایگانی آخر پس از اعمال سایر پالایهها
گزینههای گنجاندن/استثنا کردن (Include/Exclude options)
- -e PATTERN, --exclude PATTERN
- مستثنی کردن مسیرهای مطابق با PATTERN
- --exclude-from EXCLUDEFILE
- خواندن الگوهای استثنا از EXCLUDEFILE، یک الگو در هر خط
- --pattern PATTERN
- گنجاندن/مستثنی کردن مسیرهای مطابق با PATTERN
- --patterns-from PATTERNFILE
- خواندن الگوهای گنجاندن/استثنا از PATTERNFILE، یک الگو در هر خط
مثالها (EXAMPLES)
$ borg list /path/to/repo
Monday Mon, 2016-02-15 19:15:11
repo Mon, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
newname Mon, 2016-02-15 19:50:19
...
$ borg list /path/to/repo::root-2016-02-15
drwxr-xr-x root root 0 Mon, 2016-02-15 17:44:27 .
drwxrwxr-x root root 0 Mon, 2016-02-15 19:04:49 bin
-rwxr-xr-x root root 1029624 Thu, 2014-11-13 00:08:51 bin/bash
lrwxrwxrwx root root 0 Fri, 2015-03-27 20:24:26 bin/bzcmp -> bzdiff
-rwxr-xr-x root root 2140 Fri, 2015-03-27 20:24:22 bin/bzdiff
...
$ borg list /path/to/repo::root-2016-02-15 --pattern "- bin/ba*"
drwxr-xr-x root root 0 Mon, 2016-02-15 17:44:27 .
drwxrwxr-x root root 0 Mon, 2016-02-15 19:04:49 bin
lrwxrwxrwx root root 0 Fri, 2015-03-27 20:24:26 bin/bzcmp -> bzdiff
-rwxr-xr-x root root 2140 Fri, 2015-03-27 20:24:22 bin/bzdiff
...
$ borg list /path/to/repo::archiveA --format="{mode} {user:6} {group:6} {size:8d} {isomtime} {path}{extra}{NEWLINE}"
drwxrwxr-x user user 0 Sun, 2015-02-01 11:00:00 .
drwxrwxr-x user user 0 Sun, 2015-02-01 11:00:00 code
drwxrwxr-x user user 0 Sun, 2015-02-01 11:00:00 code/myproject
-rw-rw-r-- user user 1416192 Sun, 2015-02-01 11:00:00 code/myproject/file.ext
-rw-rw-r-- user user 1416192 Sun, 2015-02-01 11:00:00 code/myproject/file.text
...
$ borg list /path/to/repo/::archiveA --pattern '+ re:\.ext$' --pattern '- re:^.*$'
-rw-rw-r-- user user 1416192 Sun, 2015-02-01 11:00:00 code/myproject/file.ext
...
$ borg list /path/to/repo/::archiveA --pattern '+ re:.ext$' --pattern '- re:^.*$'
-rw-rw-r-- user user 1416192 Sun, 2015-02-01 11:00:00 code/myproject/file.ext
-rw-rw-r-- user user 1416192 Sun, 2015-02-01 11:00:00 code/myproject/file.text
...
یادداشتها (NOTES)
نحو تعیینکننده FORMAT (The FORMAT specifier syntax)
گزینه --format از نحو رشته قالب پایتون بهره میبرد: https://docs.python.org/3.10/library/string.html#formatstrings.
مثالها:
$ borg list --format '{archive}{NL}' /path/to/repo
ArchiveFoo
ArchiveBar
...
# {VAR:NUMBER} - فاصلهگذاری تا NUMBER ستون.
# رشتهها چپچین و اعداد راستچین میشوند.
# توجه: ستونهای زمانی به جز isomtime، isoctime و isoatime قابلیت تنظیم فاصله ندارند.
$ borg list --format '{archive:36} {time} [{id}]{NL}' /path/to/repo
ArchiveFoo Thu, 2021-12-09 10:22:28 [0b8e9a312bef3f2f6e2d0fc110c196827786c15eba0188738e81697a7fa3b274]
$ borg list --format '{mode} {user:6} {group:6} {size:8} {mtime} {path}{extra}{NL}' /path/to/repo::ArchiveFoo
-rw-rw-r-- user user 1024 Thu, 2021-12-09 10:22:17 file-foo
...
# {VAR:<NUMBER} - فاصلهگذاری تا NUMBER ستون به صورت چپچین.
# {VAR:>NUMBER} - فاصلهگذاری تا NUMBER ستون به صورت راستچین.
$ borg list --format '{mode} {user:>6} {group:>6} {size:<8} {mtime} {path}{extra}{NL}' /path/to/repo::ArchiveFoo
-rw-rw-r-- user user 1024 Thu, 2021-12-09 10:22:17 file-foo
...
کلیدهای زیر همواره در دسترس هستند:
- NEWLINE: جداکننده خط وابسته به سیستمعامل
- NL: نام مستعار NEWLINE
- NUL: نویسه NUL برای ایجاد خروجی مشابه print0 / xargs -0، کلیدهای barchive و bpath را در زیر ببینید
- SPACE: نویسه فاصله
- TAB: نویسه جهش (تب)
- CR: بازگشت به ابتدای خط (Carriage Return)
- LF: تغذیه خط (Line Feed)
کلیدهای در دسترس هنگام فهرست کردن بایگانیهای یک مخزن:
- archive: نام بایگانی به عنوان متن (ممکن است فاقد نویسههای غیرمتنی باشد، barchive را ببینید)
- name: نام مستعار "archive"
- barchive: نام دقیق بایگانی به صورت بایت، میتواند شامل هر نویسهای به جز NUL باشد
- comment: توضیح بایگانی به عنوان متن (ممکن است فاقد نویسههای غیرمتنی باشد، bcomment را ببینید)
- bcomment: توضیح دقیق بایگانی به صورت بایت، میتواند شامل هر نویسهای به جز NUL باشد
- id: شناسه داخلی بایگانی
- tam: وضعیت احراز هویت TAM این بایگانی
- start: زمان شروع ساخت بایگانی
- time: نام مستعار "start"
- end: زمان پایان ساخت بایگانی
- command_line: خط فرمانی که برای ایجاد بایگانی استفاده شده است
- hostname: نام میزبانی که این بایگانی روی آن ایجاد شده
- username: نام کاربری که این بایگانی را ایجاد کرده
کلیدهای در دسترس تنها هنگام فهرست کردن پروندههای درون یک بایگانی:
- type: نوع پرونده
- mode: مجوزهای دسترسی پرونده
- uid: شناسه کاربری مالک
- gid: شناسه گروه مالک
- user: نام کاربری مالک
- group: نام گروه مالک
- path: مسیر پرونده به عنوان متن (ممکن است فاقد نویسههای غیرمتنی باشد، bpath را ببینید)
- bpath: مسیر دقیق سازگار با POSIX به صورت بایت، میتواند شامل هر نویسهای به جز NUL باشد
- source: مقصد پیوند برای پیوندها (همانند linktarget)
- linktarget: مقصد پیوند
- flags: پرچمهای پرونده
- size: اندازه
- csize: اندازه فشردهشده
- dsize: اندازه با حذف دادههای تکراری (deduplicated)
- dcsize: اندازه فشردهشده با حذف دادههای تکراری
- num_chunks: تعداد تکهها (چانکها) در این پرونده
- unique_chunks: تعداد تکههای یکتا در این پرونده
- mtime: زمان آخرین تغییر محتوا
- ctime: زمان آخرین تغییر وضعیت پرونده
- atime: زمان آخرین دسترسی
- isomtime: زمان mtime در قالب ISO
- isoctime: زمان ctime در قالب ISO
- isoatime: زمان atime در قالب ISO
- blake2b: هش blake2b
- blake2s: هش blake2s
- md5: هش md5
- sha1: هش sha1
- sha224: هش sha224
- sha256: هش sha256
- sha384: هش sha384
- sha3_224: هش sha3_224
- sha3_256: هش sha3_256
- sha3_384: هش sha3_384
- sha3_512: هش sha3_512
- sha512: هش sha512
- xxh64: مجموع مقابلهای XXH64 این پرونده (توجه: این یک درهمسازی رمزنگاری نیست!)
- archiveid: شناسه بایگانی
- archivename: نام بایگانی
- extra: افزودن پیشوند " -> " به {source} برای پیوندهای نرم و " link to " برای پیوندهای سخت
- health: وضعیت سلامت، یا "healthy" (پرونده سالم) یا "broken" (در صورت وجود تکههای جایگزین تماماً صفر)
همچنین ببینید (SEE ALSO)
borg-common(1), borg-info(1), borg-diff(1), borg-prune(1), borg-patterns(1)
نویسنده (AUTHOR)
The Borg Collective
| 2026-07-18 |