نام (NAME)

xfs_admin - تغییر پارامترهای سیستم پرونده XFS

خلاصه دستور (SYNOPSIS)

xfs_admin [ -eflpu ] [ -O featurelist ] [ -c 0|1 ] [ -L label ] [ -U uuid ] [ -r rtdev ] device [ logdev ]
xfs_admin -V

توضیحات (DESCRIPTION)

دستور xfs_admin برچسبها، شناسههای UUID و ویژگیهای ساختاری یک فایلسیستم XFS غیرمتصل را تغییر میدهد. دستور xfs_admin از دستور xfs_db(8) برای تغییر پارامترهای مختلف سیستم پرونده استفاده می‌کند.

دستگاه‌هایی که متصل (mount) هستند قابل تغییر نمی‌باشند. مدیران سیستم پیش از آنکه xfs_admin یا xfs_db(8) بتوانند پارامترها را تغییر دهند، باید سیستم‌های پرونده را از حالت اتصال خارج (unmount) کنند. تعدادی از پارامترهای یک سیستم پرونده متصل را می‌توان با استفاده از دستور xfs_growfs(8) بررسی و اصلاح کرد.

پارامتر اختیاری logdev فایل ویژه دستگاهی را مشخص می‌کند که لاگ خارجی سیستم پرونده در آن قرار دارد. این پارامتر تنها برای سیستم‌های پرونده‌ای که از لاگ خارجی استفاده می‌کنند لازم است. گزینه mkfs.xfs -l را ببینید و برای توضیحات دقیق درباره لاگ XFS به xfs(5) مراجعه کنید.

گزینه‌ها (OPTIONS)

-e: پشتیبانی از اکستنت نانوشته (unwritten extent) را روی سیستم پرونده‌ای که این قابلیت را ندارد فعال می‌کند (برای سیستم‌های پرونده قدیمی، دیگر در زمان mkfs امکان غیرفعال‌سازی آن وجود ندارد).

: این گزینه تنها برای فرمت منسوخ‌شده V4 اعمال می‌شود.

-f: مشخص می‌کند که تصویر سیستم پرونده مورد نظر در یک فایل معمولی در device ذخیره شده است (گزینه mkfs.xfs -d file را ببینید).
-j: فرمت لاگ نسخه ۲ (فرمت ژورنال با پشتیبانی از بافرهای لاگ بزرگ‌تر) را فعال می‌کند.

: این گزینه تنها برای فرمت منسوخ‌شده V4 اعمال می‌شود.

-l: برچسب (label) فعلی سیستم پرونده را چاپ می‌کند.
-p: پشتیبانی از شناسه پروژه ۳۲ بیتی (ویژگی PROJID32BIT) را فعال می‌کند.

: این گزینه تنها برای فرمت منسوخ‌شده V4 اعمال می‌شود.

-u: شناسه یکتای جهانی (UUID) فعلی سیستم پرونده را چاپ می‌کند.
-c 0|1: شمارنده‌های تنبل (lazy-counters) را در سیستم پرونده فعال (1) یا غیرفعال (0) می‌کند.

: شمارنده‌های تنبل در سیستم‌های پرونده با ابربلوک نسخه ۵ (یعنی دارای CRC فراداده فعال) قابل غیرفعال‌سازی نیستند.
: به عبارت دیگر، این گزینه تنها برای فرمت منسوخ‌شده V4 اعمال می‌شود.
: این عملیات ممکن است در سیستم‌های پرونده بزرگ زمان زیادی ببرد زیرا هنگام تغییر این گزینه باید کل سیستم پرونده پویش شود.
: با فعال بودن شمارنده‌های تنبل، ابربلوک در هر تغییر شمارنده‌های فضای خالی و inode تغییر نکرده یا لاگ نمی‌شود. در عوض، اطلاعات کافی در بخش‌های دیگر سیستم پرونده نگهداری می‌شود تا بتوان مقادیر شمارنده‌ها را بدون نیاز به نگهداری مداوم در ابربلوک مدیریت کرد. این امر در برخی پیکربندی‌ها و بارهای کاری متمرکز بر فراداده، بهبود کارایی چشمگیری ایجاد می‌کند.

-L label: برچسب سیستم پرونده را به label تنظیم می‌کند. برچسب سیستم‌های پرونده XFS می‌تواند حداکثر ۱۲ کاراکتر باشد؛ اگر label طولانی‌تر از ۱۲ کاراکتر باشد، xfs_admin آن را کوتاه کرده و یک پیام هشدار چاپ می‌کند. برچسب سیستم پرونده را می‌توان با استفاده از مقدار ویژه "--" برای label پاک کرد.
-O feature1=status,feature2=status...: ویژگی‌ها را روی یک سیستم پرونده موجود V5 اضافه یا حذف می‌کند. ویژگی‌ها باید به صورت یک لیست جدا شده با ویرگول مشخص شوند. status باید 0 برای غیرفعال‌سازی ویژگی یا 1 برای فعال‌سازی آن باشد. با این حال توجه داشته باشید که بیشتر ویژگی‌ها را نمی‌توان غیرفعال کرد.

: نکته: مدیران سیستم باید اطمینان حاصل کنند که سیستم پرونده تمیز است؛ این کار با اجرای xfs_repair -n برای بررسی سیستم پرونده پیش از ارتقا انجام می‌شود. اگر خرابی یافت شد، باید مراحل بازیابی (مثلاً فرمت مجدد و سپس بازیابی از نسخه پشتیبان، یا اجرای xfs_repair بدون -n) برای پاک‌سازی سیستم پرونده دنبال شود.
: ویژگی‌های پشتیبانی‌شده به شرح زیر است:

inobtcount: شمارش تعداد بلوک‌ها در هر btree اینود در AGI را نگه می‌دارد. این کار با سرعت بخشیدن به محاسبات رزرو فضای فراداده، زمان اتصال (mount) را کاهش می‌دهد. پس از فعال شدن این ویژگی، سیستم پرونده قابل تنزیل (downgrade) نیست. پس از فعال شدن، سیستم پرونده توسط هسته‌های قدیمی‌تر قابل نوشتن نخواهد بود. این قابلیت در لینوکس 5.10 اضافه شد.
bigtime: سیستم پرونده را برای پشتیبانی از برچسب‌های زمانی بزرگ‌تر تا سال ۲۴۸۶ ارتقا می‌دهد. پس از فعال شدن این ویژگی، سیستم پرونده قابل تنزیل نیست. پس از فعال شدن، سیستم پرونده توسط هسته‌های قدیمی‌تر قابل اتصال نخواهد بود. این قابلیت در لینوکس 5.10 اضافه شد.
nrext64: سیستم پرونده را برای پشتیبانی از شمارنده‌های بزرگ اکستنت به ازای هر اینود ارتقا می‌دهد. حداکثر تعداد اکستنت شاخه داده 2^48 - 1 و حداکثر تعداد اکستنت شاخه ویژگی 2^32 - 1 خواهد بود. پس از فعال شدن این ویژگی، سیستم پرونده قابل تنزیل نیست. پس از فعال شدن، سیستم پرونده توسط هسته‌های قدیمی‌تر قابل اتصال نخواهد بود. این قابلیت در لینوکس 5.19 اضافه شد.
exchange: سیستم پرونده را برای پشتیبانی از تبادل اتمی محتوای فایل از طریق فراخوان ioctl با نام XFS_IOC_EXCHANGE_RANGE و پشتیبانی از تعمیر برخط دایرکتوری‌ها، ویژگی‌های گسترش‌یافته، پیوندهای نمادین و فراداده فضای خالی realtime ارتقا می‌دهد. پس از فعال شدن این ویژگی، سیستم پرونده قابل تنزیل نیست. پس از فعال شدن، سیستم پرونده توسط هسته‌های قدیمی‌تر قابل اتصال نخواهد بود.

-U uuid: شناسه UUID سیستم پرونده را به uuid تنظیم می‌کند. یک نمونه UUID به این صورت است: "c1b9d5a2-f162-11cf-9ece-0020afc76f16". مقدار uuid می‌تواند nil نیز باشد که UUID سیستم پرونده را به null UUID تنظیم می‌کند. همچنین uuid می‌تواند generate باشد که یک UUID جدید برای سیستم پرونده تولید می‌کند. توجه داشته باشید که در سیستم‌های پرونده با CRC فعال، این کار یک فلگ ناسازگار تنظیم می‌کند به طوری که هسته‌های قدیمی‌تر قادر به اتصال سیستم پرونده نخواهند بود. برای حذف این فلگ ناسازگار، از restore استفاده کنید که UUID اصلی را بازیابی کرده و فلگ ویژگی ناسازگار را در صورت نیاز حذف می‌کند.
-r rtdev: فایل ویژه دستگاهی را مشخص می‌کند که بخش realtime سیستم پرونده در آن قرار دارد. تنها برای سیستم‌های پرونده‌ای که از بخش realtime استفاده می‌کنند.
-V: شماره نسخه را چاپ کرده و خارج می‌شود.

صفحه راهنمای mount(8) نحوه اتصال سیستم پرونده را با استفاده از برچسب یا UUID آن به جای نام دستگاه بلوکی ویژه توضیح می‌دهد.

همچنین ببینید (SEE ALSO)

mkfs.xfs(8), mount(8), xfs_db(8), xfs_growfs(8), xfs_repair(8), xfs(5)

مه ۲۰۲۵

xfsprogs