.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 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 "BTRFS" "8" "15 ژوئیه 2026" "7.1" "BTRFS"
.SH "نام (NAME)"
btrfs \- ابزار جامع مدیریت و پیکربندی سیستم فایل Btrfs
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBbtrfs\fP [global options] <group> [<group>...] <command> [options] [<args>]
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار
.B btrfs
جعبه‌ابزاری جامع برای مدیریت سیستم فایل‌های btrfs است. در این ابزار گروه‌های گوناگونی از دستورها برای کار با زیرحجم‌ها (subvolumes)، دستگاه‌ها (devices)، کل سیستم فایل یا سایر عملیات ویژه فراهم شده است. برای مشاهده فهرست این گروه‌ها بخش
.B "دستورات (COMMANDS)"
را ببینید.
.sp
همچنین برای پاره‌ای از وظایف، ابزارهای مستقلی مانند
.BR btrfs\-convert (8)
یا
.BR btrfstune (8)
وجود دارند که به دلایل تاریخی به صورت مجزا توسعه یافته‌اند یا هنوز به ابزار اصلی الحاق نشده‌اند. برای جزئیات بیشتر به بخش
.B "ابزارهای مستقل (STANDALONE TOOLS)"
مراجعه کنید.
.sp
برای سایر مباحث (نظیر گزینه‌های اتصال و سوار کردن فایل‌سیستم)، لطفاً به صفحه راهنمای مجزای
.BR btrfs (5)
مراجعه فرمایید.
.SH "سینتکس دستورات (COMMAND SYNTAX)"
.sp
نام هر دستوری را تا زمانی که ابهامی ایجاد نکند می‌توان به صورت کوتاه‌شده نوشت، هرچند اکیداً توصیه می‌شود در اسکریپت‌ها از نام کامل دستورها استفاده کنید. تمامی گروه‌های دستور دارای صفحه راهنمای اختصاصی با نام
.B btrfs\-<group>
هستند.
.sp
برای نمونه: اجرای
.B btrfs sub snaps
به جای
.B btrfs subvolume snapshot
امکان‌پذیر است.
اما استفاده از
.B btrfs file s
مجاز نیست، چرا که
.B file s
می‌تواند هم به عنوان
.B filesystem show
و هم به صورت
.B filesystem sync
تفسیر شود.
.sp
چنانچه نام دستور مبهم باشد، فهرستی از گزینه‌های دارای تداخل در خروجی نمایش داده خواهد شد.
.sp
مقادیر مربوط به
.I اندازه‌ها (Sizes)
هم در ورودی و هم در خروجی می‌توانند در یکی از واحدهای SI یا IEC\-I همراه با پسوند
.I B
بیان شوند (به صفحه راهنمای
.BR numfmt (1)
مراجعه کنید).
تمام اعداد بر اساس قواعد لوکال (locale) استاندارد
.I C
قالب‌بندی می‌شوند و لوکال پوسته نادیده گرفته خواهد شد (به صفحه راهنمای
.BR locale (7)
مراجعه کنید).
.sp
برای مشاهده خلاصه راهنمای هر دستور از
.B btrfs command \-\-help
یا برای چاپ تمام گزینه‌های در دسترس همه دستورها از
.B btrfs [command...] help \-\-full
استفاده کنید.
.sp
گزینه‌های عمومی (global options) بین نام
.I btrfs
و نام
.I group
قرار می‌گیرند و رفتاری را تنظیم می‌کنند که مختص دستور خاصی نیست؛ مانند سطح گزارش‌دهی یا قالب خروجی:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
btrfs \-q subvolume create ...
btrfs \-\-dry\-run subvolume create ...
.fi
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.BI \-\-format \ <format>
در صورت پشتیبانی دستور مربوطه، خروجی زیردستور را در قالب داده‌شده چاپ می‌کند (text یا json).
.UNINDENT
.INDENT 0.0
.TP
.B \-v|\-\-verbose
افزایش سطح جزئیات خروجی زیردستور.
.TP
.B \-q|\-\-quiet
تنها چاپ خطاها (حالت بی‌صدا).
.UNINDENT
.INDENT 0.0
.TP
.BI \-\-log \ <level>
تعیین سطح لاگ‌گیری (شامل default، info، verbose، debug، quiet).
.UNINDENT
.sp
گزینه‌های باقی‌مانده تنها مختص ابزار اصلی هستند:
.INDENT 0.0
.TP
.B  \-\-help
چاپ راهنمای فشرده برای تمامی زیردستورها.
.TP
.B  \-\-version
چاپ نسخه برنامه.
.UNINDENT
.SH "دستورات (COMMANDS)"
.INDENT 0.0
.TP
.B balance
تعادل‌بخشی و توزیع تکه‌های داده (chunks) در سیستم فایل btrfs روی یک یا چند دستگاه.
برای جزئیات بیشتر به
.BR btrfs\-balance (8)
مراجعه کنید.
.TP
.B check
بررسی آفلاین سیستم فایل btrfs برای عیب‌یابی و ترمیم.
برای جزئیات بیشتر به
.BR btrfs\-check (8)
مراجعه کنید.
.TP
.B device
مدیریت دستگاه‌های متصل به btrfs، از جمله افزودن، حذف، پویش (scan) و موارد مشابه.
برای جزئیات بیشتر به
.BR btrfs\-device (8)
مراجعه کنید.
.TP
.B filesystem
مدیریت سیستم فایل btrfs، از جمله تنظیم برچسب، همگام‌سازی (sync) و غیره.
برای جزئیات بیشتر به
.BR btrfs\-filesystem (8)
مراجعه کنید.
.TP
.B inspect\-internal
ابزارهای اشکال‌زدایی و بررسی ساختار داخلی سیستم فایل ویژه توسعه‌دهندگان.
برای جزئیات بیشتر به
.BR btrfs\-inspect\-internal (8)
مراجعه کنید.
.TP
.B property
دریافت یا تنظیم مشخصه‌ها و ویژگی‌های اشیاء گوناگون در btrfs.
برای جزئیات بیشتر به
.BR btrfs\-property (8)
مراجعه کنید.
.TP
.B qgroup
مدیریت گروه‌های سهمیه (qgroup) در سیستم فایل btrfs.
برای جزئیات بیشتر به
.BR btrfs\-qgroup (8)
مراجعه کنید.
.TP
.B quota
مدیریت سهمیه‌بندی فضای دیسک در سیستم فایل btrfs از قبیل فعال‌سازی، بازشماری و غیره.
برای جزئیات بیشتر به
.BR btrfs\-quota (8)
و
.BR btrfs\-qgroup (8)
مراجعه کنید.
.TP
.B receive
دریافت داده‌های زیرحجم از ورودی استاندارد یا فایل برای بازگردانی اطلاعات و غیره.
برای جزئیات بیشتر به
.BR btrfs\-receive (8)
مراجعه کنید.
.TP
.B replace
جایگزینی زنده دیسک‌ها و دستگاه‌های ذخیره‌سازی در btrfs.
برای جزئیات بیشتر به
.BR btrfs\-replace (8)
مراجعه کنید.
.TP
.B rescue
تلاش برای نجات و احیای سیستم فایل آسیب‌دیده btrfs.
برای جزئیات بیشتر به
.BR btrfs\-rescue (8)
مراجعه کنید.
.TP
.B restore
تلاش برای استخراج و بازیابی فایل‌ها از یک سیستم فایل آسیب‌دیده btrfs.
برای جزئیات بیشتر به
.BR btrfs\-restore (8)
مراجعه کنید.
.TP
.B scrub
بررسی دوره‌ای سلامت داده‌ها (Scrub) در پس‌زمینه و اصلاح خودکار موارد خرابی در صورت دسترسی به کپی سالم.
برای جزئیات بیشتر به
.BR btrfs\-scrub (8)
مراجعه کنید.
.TP
.B send
ارسال داده‌های زیرحجم به خروجی استاندارد یا فایل برای پشتیبان‌گیری و انتقال.
برای جزئیات بیشتر به
.BR btrfs\-send (8)
مراجعه کنید.
.TP
.B subvolume
ایجاد، حذف، فهرست‌برداری و مدیریت زیرحجم‌های (subvolumes) سیستم فایل btrfs.
برای جزئیات بیشتر به
.BR btrfs\-subvolume (8)
مراجعه کنید.
.UNINDENT
.SH "ابزارهای مستقل (STANDALONE TOOLS)"
.sp
گاهی قابلیت‌های نوین در ابتدا با یک ابزار مستقل ارائه می‌شوند. چنانچه این قابلیت‌ها کارآمد واقع شوند، ابزار مستقل منسوخ شناخته شده و عملکردهای آن به ابزار اصلی منتقل می‌گردد. ابزارهای منسوخ پس از سپری شدن یک دوره استهلاک طولانی (چندین سال) به کلی حذف می‌شوند.
.sp
ابزارهایی که کماکان استفاده می‌شوند و معادلی درون دستور
.B btrfs
ندارند عبارتند از:
.INDENT 0.0
.TP
.B btrfs\-convert
تبدیل درجا (in\-place) سیستم فایل‌های ext2/3/4 به btrfs بدون از دست رفتن داده‌ها.
.TP
.B btrfstune
تنظیم و اصلاح برخی پارامترهای سیستم فایل روی یک سیستم فایل سوارنشده (unmounted).
.TP
.B btrfs\-select\-super
ابزار نجات برای بازنویسی ابربلوک اصلی (primary superblock) از روی نسخه‌های پشتیبان.
.TP
.B btrfs\-find\-root
ابزار کمکی نجات به منظور یافتن ریشه‌های درخت (tree roots) در سیستم فایل.
.UNINDENT
.sp
برای محیط‌هایی با محدودیت فضا، امکان ساخت یک باینری واحد با قابلیت‌های چندین ابزار مستقل وجود دارد. این سازوکار پیرو ایده busybox است که در آن نام فایل، تعیین‌کننده عملکرد اجرایی است. این روش با استفاده از پیوندهای نمادین (symlinks) یا پیوندهای سخت (hardlinks) پیاده‌سازی می‌شود. فهرست کامل این موارد با دستور
.B btrfs help \-\-box
قابل دریافت است.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
دستور
.B btrfs
در صورت اجرای موفق، مقدار خروج صفر بازمی‌گرداند. در صورت بروز خطا، مقداری غیر از صفر بازگردانده می‌شود.
.SH "دسترسی (AVAILABILITY)"
.sp
ابزار
.B btrfs
بخشی از بسته btrfs\-progs است. لطفاً برای مشاهده مستندات به نشانی
\%<https://\:btrfs\:.readthedocs\:.io>
مراجعه فرمایید.
.SH "همچنین ببینید (SEE ALSO)"
.sp
.BR btrfs (5),
.BR btrfs\-balance (8),
.BR btrfs\-check (8),
.BR btrfs\-convert (8),
.BR btrfs\-device (8),
.BR btrfs\-filesystem (8),
.BR btrfs\-inspect\-internal (8),
.BR btrfs\-property (8),
.BR btrfs\-qgroup (8),
.BR btrfs\-quota (8),
.BR btrfs\-receive (8),
.BR btrfs\-replace (8),
.BR btrfs\-rescue (8),
.BR btrfs\-restore (8),
.BR btrfs\-scrub (8),
.BR btrfs\-send (8),
.BR btrfs\-subvolume (8),
.BR btrfstune (8),
.BR mkfs.btrfs (8)