XFS_HEALER(8) دستورات مدیریت سیستم XFS_HEALER(8)

xfs_healer - ترمیم و بازیابی خودکار فرادادههای آسیبدیده سیستم پرونده XFS

xfs_healer [ گزینه‌ها ] نقطه-اتصال
xfs_healer -V

سرویس xfs_healer لاگهای خطای هسته را برای شناسایی خطاهای فراداده در فایلسیستمهای XFS پایش کرده و به طور خودکار دستورات تعمیر آنلاین را اجرا میکند.

هشدار! این برنامه آزمایشی (EXPERIMENTAL) است، به این معنی که رفتار و رابط کاربری آن ممکن است در هر زمان تغییر کند!

xfs_healer از هسته درخواست می‌کند که تمامی مشاهدات مربوط به فراداده‌های آسیب‌دیده، خطاهای رسانه، توقف‌های سیستم پرونده (shutdowns) و خطاهای ورودی/خروجی (I/O) فایل را گزارش کند. این برنامه می‌تواند با آغاز تعمیرات هدفمند فراداده‌های مشکوک یا اجرای کامل fsck آنلاین سیستم پرونده، به خطاهای زمان اجرای خرابی فراداده پاسخ دهد.

به طور معمول این برنامه به عنوان یک سرویس systemd اجرا می‌شود. در صورت پشتیبانی از systemd، این سرویس از طریق سرویس xfs_healer_start فعال می‌شود.

هسته ممکن است از تعمیر یا بهینه‌سازی سیستم پرونده پشتیبانی نکند. در این صورت، سیستم پرونده باید غیرفعال (unmount) شده و xfs_repair(8) برای رفع مشکلات روی سیستم پرونده اجرا شود.

از هسته درخواست می‌کند رویدادهای سلامت فراداده‌های سالم را نیز ارسال کند، نه فقط رویدادهای مربوط به خرابی فراداده، خطاهای رسانه، توقف‌ها و خطاهای I/O.
تعداد نخ‌های پردازش رویداد کافی برای امکان استفاده از تمام پردازنده‌های آنلاین را راه‌اندازی می‌کند. در صورت عدم تعیین، دقیقاً یک نخ پردازش رویداد راه‌اندازی می‌شود.
از ویژگی سیستم پرونده autofsck برای تصمیم‌گیری درباره تعمیر یا عدم تعمیر فراداده‌های آسیب‌دیده استفاده نمی‌کند. اگر گزینه --repair داده شود، تمام خرابی‌ها تعمیر خواهند شد. اگر گزینه --repair داده نشود، برنامه هرگز برای تعمیر سیستم پرونده تلاشی نخواهد کرد.
از چاپ تمامی رویدادها در خروجی استاندارد خودداری می‌کند.
همیشه هنگامی که هسته خرابی فراداده را گزارش می‌دهد، برای تعمیر آن تلاش می‌کند. اگر یک تعمیر مجزا با شکست مواجه شود یا هسته اعلام کند که رویدادهای سلامت از دست رفته‌اند، سرویس xfs_scrub برای این نقطه اتصال اجرا خواهد شد. حالت پیش‌فرض تلاش نکردن برای تعمیر هیچ موردی است. اگر این گزینه مشخص شود اما هسته از تعمیرات پشتیبانی نکند، برنامه خارج می‌شود.
بررسی می‌کند که آیا سیستم پرونده از ارسال رویدادهای سلامت پشتیبانی می‌کند یا خیر. در صورت پشتیبانی با کد ۰ و در غیر این صورت با مقدار غیر صفر خارج می‌شود.
شماره نسخه را چاپ کرده و خارج می‌شود.

به‌طور پیش‌فرض، این برنامه ویژگی سیستم پرونده autofsck را برای تصمیم‌گیری درباره تلاش برای تعمیر خرابی‌ها می‌خواند. اگر این ویژگی روی مقادیر زیر تنظیم شده باشد:

خرابی‌ها تعمیر خواهند شد.
خرابی‌ها ثبت (log) خواهند شد.
برنامه خارج می‌شود.

اگر این ویژگی تنظیم نشده باشد اما سیستم پرونده از هرگونه فراداده ارجاع به عقب (نگاشت‌های معکوس و اشاره‌گرهای والد) پشتیبانی کند، خرابی‌ها ثبت خواهند شد. اگر هیچ فراداده ارجاع به عقبی موجود نباشد، برنامه خارج می‌شود.

برای جزئیات بیشتر درباره این ویژگی سیستم پرونده، صفحه راهنمای xfs_scrub(8) را ببینید.

xfs_healer یک ابزار نابالغ و در حال توسعه است! هرگز این برنامه را اجرا نکنید مگر اینکه از داده‌های خود نسخه پشتیبان داشته باشید! این برنامه از قابلیت پاکسازی درون هسته (in-kernel scrubbing) برای اعتبارسنجی ساختار داده مشخص در حین نگه‌داشتن قفل‌ها استفاده می‌کند و می‌تواند سیستم پرونده را برای مدتی طولانی مشغول نگه دارد. هسته باید به اندازه کافی جدید باشد تا از فراخوانی ioctl مربوط به SCRUB_METADATA پشتیبانی کند.

اگر خطاهایی یافت شوند و قابل تعمیر نباشند، سیستم پرونده باید غیرفعال (unmount) شده و تعمیر شود.

xfs_repair(8) و xfs_scrub(8).

مه ۲۰۲۵ xfsprogs