.\" Man page generated from reStructuredText .\" by the Docutils 0.22.4 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "borg-list" "1" "2026-07-18" "" "borg backup tool" .SH "نام (NAME)" borg-list \- فهرست کردن محتوای بایگانی یا مخزن .SH "خلاصه دستور (SYNOPSIS)" .sp borg [common options] list [options] [REPOSITORY_OR_ARCHIVE] [PATH...] .SH "توضیحات (DESCRIPTION)" .sp این دستور محتویات یک مخزن یا بایگانی را فهرست می‌کند. .sp برای راهنمایی بیشتر درباره الگوهای گنجاندن/مستثنی کردن، خروجی دستور \fIborg_patterns\fP را ببینید. .SH "گزینه‌ها (OPTIONS)" .sp برای گزینه‌های مشترک دستورات Borg به \fIborg\-common(1)\fP مراجعه کنید. .SS "آرگومان‌ها (arguments)" .INDENT 0.0 .TP .B REPOSITORY_OR_ARCHIVE مخزن یا بایگانی برای فهرست کردن محتویات آن .TP .B PATH مسیرهایی که باید فهرست شوند؛ از الگوها پشتیبانی می‌شود .UNINDENT .SS "گزینه‌ها (options)" .INDENT 0.0 .TP .B \-\-consider\-checkpoints نمایش بایگانی‌های وارسی (checkpoint) در فهرست محتوای مخزن (پیش‌فرض: پنهان). .TP .B \-\-short فقط چاپ نام پرونده‌ها/پوشه‌ها، بدون اطلاعات دیگر .TP .BI \-\-format \ FORMAT تعیین قالب خروجی فهرست پرونده‌ها یا بایگانی‌ها (پیش‌فرض برای پرونده‌ها: \(dq{mode} {user:6} {group:6} {size:8} {mtime} {path}{extra}{NL}\(dq؛ برای بایگانی‌ها: \(dq{archive:<36} {time} [{id}]{NL}\(dq) .TP .B \-\-json تنها برای فهرست کردن محتوای مخزن معتبر است. قالب‌بندی خروجی به صورت JSON. ساختار \fB\-\-format\fP نادیده گرفته می‌شود، اما کلیدهای استفاده شده در آن به خروجی JSON افزوده می‌شوند. برخی کلیدها همواره وجود دارند. نکته: JSON تنها می‌تواند متن را بازنمایی کند؛ بنابراین کلید \(dqbarchive\(dq در دسترس نیست. .TP .B \-\-json\-lines تنها برای فهرست کردن محتوای بایگانی معتبر است. قالب‌بندی خروجی به صورت خطوط JSON (JSON Lines). ساختار \fB\-\-format\fP نادیده گرفته می‌شود، اما کلیدهای استفاده شده در آن به خروجی JSON افزوده می‌شوند. برخی کلیدها همواره وجود دارند. نکته: JSON تنها می‌تواند متن را بازنمایی کند؛ بنابراین کلید \(dqbpath\(dq در دسترس نیست. .UNINDENT .SS "پالایه‌های بایگانی (Archive filters)" .INDENT 0.0 .TP .BI \-P \ PREFIX\fR,\fB \ \-\-prefix \ PREFIX تنها در نظر گرفتن نام‌های بایگانی که با این پیشوند شروع می‌شوند. (منسوخ شده) .TP .BI \-a \ GLOB\fR,\fB \ \-\-glob\-archives \ GLOB تنها در نظر گرفتن نام‌های بایگانی مطابق با الگوی glob. قواعد sh: اعمال می‌شوند (بدون استفاده صریح از پیشوند sh:)، به \(dqborg help patterns\(dq مراجعه کنید. .TP .BI \-\-sort\-by \ KEYS فهرست جداشده با کاما از کلیدهای مرتب‌سازی؛ کلیدهای معتبر: timestamp, archive, name, id؛ پیش‌فرض: timestamp .TP .BI \-\-first \ N تنها بررسی N بایگانی اول پس از اعمال سایر پالایه‌ها .TP .BI \-\-last \ N تنها بررسی N بایگانی آخر پس از اعمال سایر پالایه‌ها .UNINDENT .SS "گزینه‌های گنجاندن/استثنا کردن (Include/Exclude options)" .INDENT 0.0 .TP .BI \-e \ PATTERN\fR,\fB \ \-\-exclude \ PATTERN مستثنی کردن مسیرهای مطابق با PATTERN .TP .BI \-\-exclude\-from \ EXCLUDEFILE خواندن الگوهای استثنا از EXCLUDEFILE، یک الگو در هر خط .TP .BI \-\-pattern \ PATTERN گنجاندن/مستثنی کردن مسیرهای مطابق با PATTERN .TP .BI \-\-patterns\-from \ PATTERNFILE خواندن الگوهای گنجاندن/استثنا از PATTERNFILE، یک الگو در هر خط .UNINDENT .SH "مثال‌ها (EXAMPLES)" .INDENT 0.0 .INDENT 3.5 .sp .EX $ 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 \(dq\- bin/ba*\(dq 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=\(dq{mode} {user:6} {group:6} {size:8d} {isomtime} {path}{extra}{NEWLINE}\(dq 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 \(aq+ re:\e.ext$\(aq \-\-pattern \(aq\- re:^.*$\(aq \-rw\-rw\-r\-\- user user 1416192 Sun, 2015\-02\-01 11:00:00 code/myproject/file.ext \&... $ borg list /path/to/repo/::archiveA \-\-pattern \(aq+ re:.ext$\(aq \-\-pattern \(aq\- re:^.*$\(aq \-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 \&... .EE .UNINDENT .UNINDENT .SH "یادداشت‌ها (NOTES)" .SS "نحو تعیین‌کننده FORMAT (The FORMAT specifier syntax)" .sp گزینه \fB\-\-format\fP از نحو رشته قالب پایتون بهره می‌برد: \%\&. .sp مثال‌ها: .INDENT 0.0 .INDENT 3.5 .sp .EX $ borg list \-\-format \(aq{archive}{NL}\(aq /path/to/repo ArchiveFoo ArchiveBar \&... # {VAR:NUMBER} \- فاصله‌گذاری تا NUMBER ستون. # رشته‌ها چپ‌چین و اعداد راست‌چین می‌شوند. # توجه: ستون‌های زمانی به جز isomtime، isoctime و isoatime قابلیت تنظیم فاصله ندارند. $ borg list \-\-format \(aq{archive:36} {time} [{id}]{NL}\(aq /path/to/repo ArchiveFoo Thu, 2021\-12\-09 10:22:28 [0b8e9a312bef3f2f6e2d0fc110c196827786c15eba0188738e81697a7fa3b274] $ borg list \-\-format \(aq{mode} {user:6} {group:6} {size:8} {mtime} {path}{extra}{NL}\(aq /path/to/repo::ArchiveFoo \-rw\-rw\-r\-\- user user 1024 Thu, 2021\-12\-09 10:22:17 file\-foo \&... # {VAR:NUMBER} \- فاصله‌گذاری تا NUMBER ستون به صورت راست‌چین. $ borg list \-\-format \(aq{mode} {user:>6} {group:>6} {size:<8} {mtime} {path}{extra}{NL}\(aq /path/to/repo::ArchiveFoo \-rw\-rw\-r\-\- user user 1024 Thu, 2021\-12\-09 10:22:17 file\-foo \&... .EE .UNINDENT .UNINDENT .sp کلیدهای زیر همواره در دسترس هستند: .INDENT 0.0 .IP \(bu 2 NEWLINE: جداکننده خط وابسته به سیستم‌عامل .IP \(bu 2 NL: نام مستعار NEWLINE .IP \(bu 2 NUL: نویسه NUL برای ایجاد خروجی مشابه print0 / xargs \-0، کلیدهای barchive و bpath را در زیر ببینید .IP \(bu 2 SPACE: نویسه فاصله .IP \(bu 2 TAB: نویسه جهش (تب) .IP \(bu 2 CR: بازگشت به ابتدای خط (Carriage Return) .IP \(bu 2 LF: تغذیه خط (Line Feed) .UNINDENT .sp کلیدهای در دسترس هنگام فهرست کردن بایگانی‌های یک مخزن: .INDENT 0.0 .IP \(bu 2 archive: نام بایگانی به عنوان متن (ممکن است فاقد نویسه‌های غیرمتنی باشد، barchive را ببینید) .IP \(bu 2 name: نام مستعار \(dqarchive\(dq .IP \(bu 2 barchive: نام دقیق بایگانی به صورت بایت، می‌تواند شامل هر نویسه‌ای به جز NUL باشد .IP \(bu 2 comment: توضیح بایگانی به عنوان متن (ممکن است فاقد نویسه‌های غیرمتنی باشد، bcomment را ببینید) .IP \(bu 2 bcomment: توضیح دقیق بایگانی به صورت بایت، می‌تواند شامل هر نویسه‌ای به جز NUL باشد .IP \(bu 2 id: شناسه داخلی بایگانی .IP \(bu 2 tam: وضعیت احراز هویت TAM این بایگانی .IP \(bu 2 start: زمان شروع ساخت بایگانی .IP \(bu 2 time: نام مستعار \(dqstart\(dq .IP \(bu 2 end: زمان پایان ساخت بایگانی .IP \(bu 2 command_line: خط فرمانی که برای ایجاد بایگانی استفاده شده است .IP \(bu 2 hostname: نام میزبانی که این بایگانی روی آن ایجاد شده .IP \(bu 2 username: نام کاربری که این بایگانی را ایجاد کرده .UNINDENT .sp کلیدهای در دسترس تنها هنگام فهرست کردن پرونده‌های درون یک بایگانی: .INDENT 0.0 .IP \(bu 2 type: نوع پرونده .IP \(bu 2 mode: مجوزهای دسترسی پرونده .IP \(bu 2 uid: شناسه کاربری مالک .IP \(bu 2 gid: شناسه گروه مالک .IP \(bu 2 user: نام کاربری مالک .IP \(bu 2 group: نام گروه مالک .IP \(bu 2 path: مسیر پرونده به عنوان متن (ممکن است فاقد نویسه‌های غیرمتنی باشد، bpath را ببینید) .IP \(bu 2 bpath: مسیر دقیق سازگار با POSIX به صورت بایت، می‌تواند شامل هر نویسه‌ای به جز NUL باشد .IP \(bu 2 source: مقصد پیوند برای پیوندها (همانند linktarget) .IP \(bu 2 linktarget: مقصد پیوند .IP \(bu 2 flags: پرچم‌های پرونده .IP \(bu 2 size: اندازه .IP \(bu 2 csize: اندازه فشرده‌شده .IP \(bu 2 dsize: اندازه با حذف داده‌های تکراری (deduplicated) .IP \(bu 2 dcsize: اندازه فشرده‌شده با حذف داده‌های تکراری .IP \(bu 2 num_chunks: تعداد تکه‌ها (چانک‌ها) در این پرونده .IP \(bu 2 unique_chunks: تعداد تکه‌های یکتا در این پرونده .IP \(bu 2 mtime: زمان آخرین تغییر محتوا .IP \(bu 2 ctime: زمان آخرین تغییر وضعیت پرونده .IP \(bu 2 atime: زمان آخرین دسترسی .IP \(bu 2 isomtime: زمان mtime در قالب ISO .IP \(bu 2 isoctime: زمان ctime در قالب ISO .IP \(bu 2 isoatime: زمان atime در قالب ISO .IP \(bu 2 blake2b: هش blake2b .IP \(bu 2 blake2s: هش blake2s .IP \(bu 2 md5: هش md5 .IP \(bu 2 sha1: هش sha1 .IP \(bu 2 sha224: هش sha224 .IP \(bu 2 sha256: هش sha256 .IP \(bu 2 sha384: هش sha384 .IP \(bu 2 sha3_224: هش sha3_224 .IP \(bu 2 sha3_256: هش sha3_256 .IP \(bu 2 sha3_384: هش sha3_384 .IP \(bu 2 sha3_512: هش sha3_512 .IP \(bu 2 sha512: هش sha512 .IP \(bu 2 xxh64: مجموع مقابله‌ای XXH64 این پرونده (توجه: این یک درهم‌سازی رمزنگاری نیست!) .IP \(bu 2 archiveid: شناسه بایگانی .IP \(bu 2 archivename: نام بایگانی .IP \(bu 2 extra: افزودن پیشوند \(dq \-> \(dq به {source} برای پیوندهای نرم و \(dq link to \(dq برای پیوندهای سخت .IP \(bu 2 health: وضعیت سلامت، یا \(dqhealthy\(dq (پرونده سالم) یا \(dqbroken\(dq (در صورت وجود تکه‌های جایگزین تماماً صفر) .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp \fIborg\-common(1)\fP, \fIborg\-info(1)\fP, \fIborg\-diff(1)\fP, \fIborg\-prune(1)\fP, \fIborg\-patterns(1)\fP .SH "نویسنده (AUTHOR)" The Borg Collective