BTRFS-CHECK(8) BTRFS BTRFS-CHECK(8)

btrfs-check - بررسی یا ترمیم یک فایل‌سیستم Btrfs

btrfs check [گزینه‌ها] <device>

ابزار بررسی فایل‌سیستم جهت اعتبارسنجی یکپارچگی ساختاری فایل‌سیستم و تلاش برای ترمیم آن در صورت درخواست به کار می‌رود. اکیداً توصیه می‌شود پیش از اجرای بررسی، فایل‌سیستم را جدا (Unmount) کنید، هرچند بررسی فایل‌سیستم متصل‌شده نیز با گزینه --force امکان‌پذیر است.

به صورت پیش‌فرض، btrfs check تغییری در دیسک اعمال نمی‌کند؛ می‌توانید این موضوع را صریحاً با گزینه --readonly مشخص فرمایید. دستور btrfsck نام مستعار منسوخ‌شده این دستور است.

هشدار:

گزینه --repair تنها در صورتی باید استفاده شود که سایر راهکارهای بازیابی و نجات داده‌ها با شکست روبرو شده باشند یا توسط متخصصان Btrfs توصیه شده باشد.

استفاده از ریشه‌های پشتیبان درختی (Backup tree roots) در صورت در دسترس بودن.
تلاش برای ترمیم خطاهای ساختاری یافت‌شده در فایل‌سیستم.
اجرای بررسی در حالت فقط‌خواندنی بدون اعمال هیچ تغییری (رفتار پیش‌فرض).
استفاده از یک نسخه پشتیبان سوپربلاک در آفست بایت <bytenr> به جای سوپربلاک اصلی.
تأیید چکسام و یکپارچگی داده‌های تمامی فایل‌ها (فرایندی زمان‌بر).
تأیید و نمایش گزارش گروه‌های سهمیه دیسک (qgroups).
بررسی دقیق اکستنت‌های ساب‌والیوم با شناسه <subvolid>.
اجبار به اجرای بررسی حتی در صورت متصل بودن فایل‌سیستم (فقط در حالت فقط‌خواندنی مجاز است).

در صورت عدم یافتن خطا کد ۰ و در صورت وجود خرابی یا خطا مقداری غیر از صفر بازگردانده می‌شود.

btrfs(8), btrfs-rescue(8), fsck(8)

July 15, 2026 7.1