BTRFS(8) BTRFS BTRFS(8)

btrfs - ابزار جامع مدیریت و پیکربندی سیستم فایل Btrfs

btrfs [global options] <group> [<group>...] <command> [options] [<args>]

ابزار btrfs جعبه‌ابزاری جامع برای مدیریت سیستم فایل‌های btrfs است. در این ابزار گروه‌های گوناگونی از دستورها برای کار با زیرحجم‌ها (subvolumes)، دستگاه‌ها (devices)، کل سیستم فایل یا سایر عملیات ویژه فراهم شده است. برای مشاهده فهرست این گروه‌ها بخش دستورات (COMMANDS) را ببینید.

همچنین برای پاره‌ای از وظایف، ابزارهای مستقلی مانند btrfs-convert(8) یا btrfstune(8) وجود دارند که به دلایل تاریخی به صورت مجزا توسعه یافته‌اند یا هنوز به ابزار اصلی الحاق نشده‌اند. برای جزئیات بیشتر به بخش ابزارهای مستقل (STANDALONE TOOLS) مراجعه کنید.

برای سایر مباحث (نظیر گزینه‌های اتصال و سوار کردن فایل‌سیستم)، لطفاً به صفحه راهنمای مجزای btrfs(5) مراجعه فرمایید.

نام هر دستوری را تا زمانی که ابهامی ایجاد نکند می‌توان به صورت کوتاه‌شده نوشت، هرچند اکیداً توصیه می‌شود در اسکریپت‌ها از نام کامل دستورها استفاده کنید. تمامی گروه‌های دستور دارای صفحه راهنمای اختصاصی با نام btrfs-<group> هستند.

برای نمونه: اجرای btrfs sub snaps به جای btrfs subvolume snapshot امکان‌پذیر است. اما استفاده از btrfs file s مجاز نیست، چرا که file s می‌تواند هم به عنوان filesystem show و هم به صورت filesystem sync تفسیر شود.

چنانچه نام دستور مبهم باشد، فهرستی از گزینه‌های دارای تداخل در خروجی نمایش داده خواهد شد.

مقادیر مربوط به اندازه‌ها (Sizes) هم در ورودی و هم در خروجی می‌توانند در یکی از واحدهای SI یا IEC-I همراه با پسوند B بیان شوند (به صفحه راهنمای numfmt(1) مراجعه کنید). تمام اعداد بر اساس قواعد لوکال (locale) استاندارد C قالب‌بندی می‌شوند و لوکال پوسته نادیده گرفته خواهد شد (به صفحه راهنمای locale(7) مراجعه کنید).

برای مشاهده خلاصه راهنمای هر دستور از btrfs command --help یا برای چاپ تمام گزینه‌های در دسترس همه دستورها از btrfs [command...] help --full استفاده کنید.

گزینه‌های عمومی (global options) بین نام btrfs و نام group قرار می‌گیرند و رفتاری را تنظیم می‌کنند که مختص دستور خاصی نیست؛ مانند سطح گزارش‌دهی یا قالب خروجی:

btrfs -q subvolume create ...
btrfs --dry-run subvolume create ...
در صورت پشتیبانی دستور مربوطه، خروجی زیردستور را در قالب داده‌شده چاپ می‌کند (text یا json).
افزایش سطح جزئیات خروجی زیردستور.
تنها چاپ خطاها (حالت بی‌صدا).
تعیین سطح لاگ‌گیری (شامل default، info، verbose، debug، quiet).

گزینه‌های باقی‌مانده تنها مختص ابزار اصلی هستند:

چاپ راهنمای فشرده برای تمامی زیردستورها.
چاپ نسخه برنامه.

تعادل‌بخشی و توزیع تکه‌های داده (chunks) در سیستم فایل btrfs روی یک یا چند دستگاه. برای جزئیات بیشتر به btrfs-balance(8) مراجعه کنید.
بررسی آفلاین سیستم فایل btrfs برای عیب‌یابی و ترمیم. برای جزئیات بیشتر به btrfs-check(8) مراجعه کنید.
مدیریت دستگاه‌های متصل به btrfs، از جمله افزودن، حذف، پویش (scan) و موارد مشابه. برای جزئیات بیشتر به btrfs-device(8) مراجعه کنید.
مدیریت سیستم فایل btrfs، از جمله تنظیم برچسب، همگام‌سازی (sync) و غیره. برای جزئیات بیشتر به btrfs-filesystem(8) مراجعه کنید.
ابزارهای اشکال‌زدایی و بررسی ساختار داخلی سیستم فایل ویژه توسعه‌دهندگان. برای جزئیات بیشتر به btrfs-inspect-internal(8) مراجعه کنید.
دریافت یا تنظیم مشخصه‌ها و ویژگی‌های اشیاء گوناگون در btrfs. برای جزئیات بیشتر به btrfs-property(8) مراجعه کنید.
مدیریت گروه‌های سهمیه (qgroup) در سیستم فایل btrfs. برای جزئیات بیشتر به btrfs-qgroup(8) مراجعه کنید.
مدیریت سهمیه‌بندی فضای دیسک در سیستم فایل btrfs از قبیل فعال‌سازی، بازشماری و غیره. برای جزئیات بیشتر به btrfs-quota(8) و btrfs-qgroup(8) مراجعه کنید.
دریافت داده‌های زیرحجم از ورودی استاندارد یا فایل برای بازگردانی اطلاعات و غیره. برای جزئیات بیشتر به btrfs-receive(8) مراجعه کنید.
جایگزینی زنده دیسک‌ها و دستگاه‌های ذخیره‌سازی در btrfs. برای جزئیات بیشتر به btrfs-replace(8) مراجعه کنید.
تلاش برای نجات و احیای سیستم فایل آسیب‌دیده btrfs. برای جزئیات بیشتر به btrfs-rescue(8) مراجعه کنید.
تلاش برای استخراج و بازیابی فایل‌ها از یک سیستم فایل آسیب‌دیده btrfs. برای جزئیات بیشتر به btrfs-restore(8) مراجعه کنید.
بررسی دوره‌ای سلامت داده‌ها (Scrub) در پس‌زمینه و اصلاح خودکار موارد خرابی در صورت دسترسی به کپی سالم. برای جزئیات بیشتر به btrfs-scrub(8) مراجعه کنید.
ارسال داده‌های زیرحجم به خروجی استاندارد یا فایل برای پشتیبان‌گیری و انتقال. برای جزئیات بیشتر به btrfs-send(8) مراجعه کنید.
ایجاد، حذف، فهرست‌برداری و مدیریت زیرحجم‌های (subvolumes) سیستم فایل btrfs. برای جزئیات بیشتر به btrfs-subvolume(8) مراجعه کنید.

گاهی قابلیت‌های نوین در ابتدا با یک ابزار مستقل ارائه می‌شوند. چنانچه این قابلیت‌ها کارآمد واقع شوند، ابزار مستقل منسوخ شناخته شده و عملکردهای آن به ابزار اصلی منتقل می‌گردد. ابزارهای منسوخ پس از سپری شدن یک دوره استهلاک طولانی (چندین سال) به کلی حذف می‌شوند.

ابزارهایی که کماکان استفاده می‌شوند و معادلی درون دستور btrfs ندارند عبارتند از:

تبدیل درجا (in-place) سیستم فایل‌های ext2/3/4 به btrfs بدون از دست رفتن داده‌ها.
تنظیم و اصلاح برخی پارامترهای سیستم فایل روی یک سیستم فایل سوارنشده (unmounted).
ابزار نجات برای بازنویسی ابربلوک اصلی (primary superblock) از روی نسخه‌های پشتیبان.
ابزار کمکی نجات به منظور یافتن ریشه‌های درخت (tree roots) در سیستم فایل.

برای محیط‌هایی با محدودیت فضا، امکان ساخت یک باینری واحد با قابلیت‌های چندین ابزار مستقل وجود دارد. این سازوکار پیرو ایده busybox است که در آن نام فایل، تعیین‌کننده عملکرد اجرایی است. این روش با استفاده از پیوندهای نمادین (symlinks) یا پیوندهای سخت (hardlinks) پیاده‌سازی می‌شود. فهرست کامل این موارد با دستور btrfs help --box قابل دریافت است.

دستور btrfs در صورت اجرای موفق، مقدار خروج صفر بازمی‌گرداند. در صورت بروز خطا، مقداری غیر از صفر بازگردانده می‌شود.

ابزار btrfs بخشی از بسته btrfs-progs است. لطفاً برای مشاهده مستندات به نشانی https://btrfs.readthedocs.io مراجعه فرمایید.

btrfs(5), btrfs-balance(8), btrfs-check(8), btrfs-convert(8), btrfs-device(8), btrfs-filesystem(8), btrfs-inspect-internal(8), btrfs-property(8), btrfs-qgroup(8), btrfs-quota(8), btrfs-receive(8), btrfs-replace(8), btrfs-rescue(8), btrfs-restore(8), btrfs-scrub(8), btrfs-send(8), btrfs-subvolume(8), btrfstune(8), mkfs.btrfs(8)

15 ژوئیه 2026 7.1