BTRFS-BALANCE(8) BTRFS BTRFS-BALANCE(8)

btrfs-balance - توازن و بازتوزیع گروههای بلوکی در فایلسیسم Btrfs

btrfs balance <زیردستور> <آرگومان‌ها>

هدف اصلی ویژگی توازن (Balance)، بازتوزیع و پخش گروه‌های بلوکی در تمامی دیسک‌ها و دستگاه‌ها به گونه‌ای است که با قیود تعریف‌شده در پروفایل‌های متناظر مطابقت داشته باشند. برای جزئیات بیشتر به بخش PROFILES در mkfs.btrfs(8) مراجعه فرمایید.

دامنه و گستره فرایند توازن را می‌توان با استفاده از فیلترهایی که گروه‌های بلوکی مورد پردازش را انتخاب می‌کنند، دقیق‌تر تنظیم کرد. عملیات توازن تنها بر روی سیستم‌فایل‌های متصل‌شده (Mount شده) کار می‌کند. اشتراک‌گذاری اکستنت‌ها (Extent sharing) حفظ شده و پیوندهای انعکاسی (reflinks) شکسته نمی‌شوند. فایل‌ها مجدداً دیفرگمنت یا فشرده‌سازی نمی‌شوند؛ اکستنت‌های فایل حفظ می‌شوند اما مکان فیزیکی آن‌ها بر روی دستگاه‌ها تغییر می‌کند.

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

هشدار:

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

لغو عملیات توازن در حال اجرا بر روی سیستم فایل مسیر <path>.
توقف موقت عملیات توازن در حال اجرا.
ادامه عملیات توازنی که متوقف شده است.
شروع عملیات توازن بر روی سیستم‌فایل واقع در مسیر <path>.

گزینه‌ها:

اعمال فیلترهای داده (Data block groups).
اعمال فیلترهای متاداده (Metadata block groups).
اعمال فیلترهای سیستمی (System block groups).
نمایش خروجی با جزئیات بیشتر.
نادیده گرفتن هشدارهای مربوط به توازن کامل بدون فیلتر.
نمایش وضعیت و پیشرفت عملیات توازن در حال اجرا بر روی مسیر <path>.

فیلترها تعیین می‌کنند کدام گروه‌های بلوکی پردازش شوند. فیلترها با کاما از یکدیگر جدا می‌شوند:

پردازش گروه‌های بلوکی مطابق با پروفایل‌های مشخص‌شده (مانند raid0, raid1, raid10, single, dup).
پردازش گروه‌های بلوکی که درصد اشغال فضای آن‌ها کمتر یا مساوی <percent> است.
پردازش گروه‌های بلوکی که تنها بر روی شناسه دستگاه <devid> قرار دارند.
محدود کردن تعداد گروه‌های بلوکی مورد پردازش به حداکثر <count> گروه.
تبدیل پروفایل بلوک‌های پردازش‌شده به پروفایل جدید <profile>.

ابزار btrfs balance در صورت موفقیت کد خروج صفر و در صورت بروز خطا کد غیرصفر بازمی‌گرداند.

btrfs(8), btrfs-device(8), mkfs.btrfs(8)

July 15, 2026 7.1