'\" t
.\"     Title: lsbtr
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-07-19
.\"    Manual: Btrbk Manual
.\"    Source: Btrbk 0.32.7
.\"  Language: Persian
.\"
.TH "LSBTR" "1" "2026-07-19" "Btrbk 0.32.7" "Btrbk Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
lsbtr \- فهرست کردن زیرحجم‌های btrfs
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
lsbtr [\-h|\-\-help] [\-\-version]
      [\-l|\-\-long] [\-u|\-\-uuid] [\-1|\-\-single\-column] [\-\-raw]
      [\-\-format <output\-format>]
      [\-v|\-\-verbose]
      [\-c|\-\-config <file>]
      [\-\-override <config_option>=<value>]
      [[\-\-] <path>|<url>.\|.\|.]
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
فهرست کردن زیرحجم‌های btrfs و نقاط اتصال آن‌ها که برای سیستم‌فایل در زیر \fI<path>\fP قابل مشاهده هستند.
.sp
دستور \fBlsbtr\fP بخشی از \fBbtrbk\fP است (در واقع یک میان‌بر برای «btrbk ls») و در صورت وجود، برخی از گزینه‌های پیکربندی سراسری را از btrbk.conf(5) دریافت می‌کند.
.sp
دستور \fBlsbtr\fP برای اجرای صحیح نیازمند \fIدسترسی‌های ریشه (root privileges)\fP است. به عنوان جایگزین، می‌توانید استفاده از بک‌اندهای «btrfs\-progs\-sudo» یا «btrfs\-progs\-btrbk» را مد نظر قرار دهید، که هر دو به شما اجازه می‌دهند lsbtr را به عنوان یک کاربر عادی اجرا کنید. برای جزئیات بیشتر به گزینه پیکربندی \fIbackend\fP در btrbk.conf(5) مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.sp
\-h, \-\-help
.RS 4
خلاصه دستور و فهرستی از دستورات را چاپ می‌کند.
.RE
.sp
\-\-version
.RS 4
نسخه btrbk را چاپ می‌کند.
.RE
.sp
\-l, \-\-long
.RS 4
خروجی را در قالب جدول طولانی چاپ می‌کند (علاوه بر این، مسیر زیرحجم نیز چاپ می‌شود).
.RE
.sp
\-u, \-\-uuid
.RS 4
جدول UUID (روابط والد/دریافت‌شده [parent/received]) را چاپ می‌کند.
.RE
.sp
\-1, \-\-single\-column
.RS 4
تنها ستون مسیر را چاپ می‌کند (با خط جدید جدا می‌شود).
.RE
.sp
\-\-raw
.RS 4
جفت‌های کلید="مقدار" (key="value") جداشده با فاصله را چاپ می‌کند (خوانا برای ماشین).
.RE
.sp
\-\-format table|long|raw|col:[h:]<columns>
.RS 4
خروجی را در قالب مشخص‌شده چاپ می‌کند. در صورت تنظیم روی «raw»، جفت‌های کلید="مقدار" (key="value") جداشده با فاصله را چاپ می‌کند (خوانا برای ماشین).
.sp
در صورت تنظیم روی «col:»، تنها <columns> مشخص‌شده را چاپ می‌کند (فهرست جداشده با کاما). اگر اصلاح‌کننده «h:» وجود داشته باشد، خطوط سربرگ نادیده گرفته می‌شوند. ستون‌های دارای پیشوند «\-»، در صورت خالی بودن جمع می‌شوند (collapsed). ستون‌های دارای پسوند «:RALIGN»، راست‌چین می‌شوند.
.RE
.sp
\-v, \-\-verbose
.RS 4
سطح جزئیات خروجی را افزایش می‌دهد.
.RE
.sp
\-c, \-\-config <file>
.RS 4
پیکربندی را از <file> می‌خواند.
.RE
.sp
\-\-override <config_option>=<value>
.RS 4
یک گزینه پیکربندی <config_option> را با <value> بازنویسی (override) می‌کند.
.RE
.SH "فایل‌ها (FILES)"
.sp
\f(CR/etc/btrbk.conf\fP, \f(CR/etc/btrbk/btrbk.conf\fP
.RS 4
فایل پیکربندی پیش‌فرض. قالب فایل و گزینه‌های پیکربندی در \fBbtrbk.conf\fP(5) شرح داده شده‌اند.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.sp
دستور \fBlsbtr\fP کدهای خطای زیر را برمی‌گرداند:
.sp
0
.RS 4
هیچ مشکلی رخ نداد.
.RE
.sp
1
.RS 4
کد خطای عمومی.
.RE
.sp
2
.RS 4
خطای تجزیه: هنگام تجزیه گزینه‌های خط فرمان یا فایل پیکربندی.
.RE
.sp
255
.RS 4
خطای اسکریپت.
.RE
.SH "دسترس‌پذیری (AVAILABILITY)"
.sp
لطفاً برای جزئیات بیشتر به صفحه پروژه btrbk در \fB\c
.URL "https://digint.ch/btrbk" "" "\fP"
مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBbtrbk\fP(1),
\fBbtrbk.conf\fP(5),
\fBbtrfs\fP(8)
.SH "نویسندگان (AUTHORS)"
.sp
Axel Burri \c
.MTO "axel\(attty0.ch" "" ""