.TH "XFS_METADUMP" "8" "مه ۲۰۲۵" "xfsprogs" "دستورات مدیریت سیستم"
.SH "نام (NAME)"
xfs_metadump \- استخراج و ذخیره فرادادههای سیستم پرونده XFS در یک پرونده
.SH "خلاصه دستور (SYNOPSIS)"
.B xfs_metadump
[
.B \-aefFgow
] [
.B \-m
.I max_extents
] [
.B \-l
.I logdev
] [
.B \-r
.I rtdev
] [
.B \-v
.I version
]
.I source
.I target
.br
.B xfs_metadump \-V
.SH "توضیحات (DESCRIPTION)"
دستور \fBxfs_metadump\fR فرادادههای یک سیستم پرونده XFS را بدون کپی کردن دادههای کاربری در یک پرونده تصویر ذخیره میکند.
آرگومان
.I source
باید مسیر فایل یا دستگاه حاوی سیستم‌پرونده XFS باشد و آرگومان
.I target
نام پرونده مقصد را مشخص می‌کند.
اگر
.I target
برابر با \- باشد، خروجی به استاندارد خروجی (stdout) فرستاده می‌شود. این امر اجازه می‌دهد که خروجی به برنامه دیگری مانند ابزارهای فشرده‌سازی هدایت شود.
.PP
دستور
.B xfs_metadump
فقط برای رونوشت‌برداری از سیستم‌پرونده‌های سوارنشده (unmounted) یا سیستم‌پرونده‌های سوارشده به‌صورت فقط‌خواندنی قابل استفاده است.
.PP
دستور
.B xfs_metadump
به هیچ وجه سیستم‌پرونده مبدأ را تغییر نمی‌دهد. تصویر
.I target
یک پرونده پیوسته (non-sparse) است که تمام فراداده‌های سیستم‌پرونده و نمایه‌های مربوط به مکان کپی بلوک‌ها را در خود دارد.
.PP
به‌طور پیش‌فرض،
.B xfs_metadump
بیشتر نام‌های پرونده‌ها (پرونده‌های معمولی، دایرکتوری‌ها و پیوندهای نمادین) و نام ویژگی‌های گسترش‌یافته را مبهم‌سازی (obfuscate) می‌کند تا بتوان تصاویر ذخیره‌شده را بدون افشای اطلاعات محرمانه ارسال کرد. مقادیر ویژگی‌های گسترش‌یافته با صفر جایگزین شده و هیچ داده‌ای کپی نمی‌شود. تنها موارد استثنا، نام پرونده‌ها یا ویژگی‌هایی با طول ۴ کاراکتر یا کمتر هستند. همچنین نام پرونده‌هایی که در چندین اکستنت امتداد یافته‌اند (این حالت فقط با گزینه‌های
.BR mkfs.xfs (8)
که در آن
.B \-n
.I size
>
.B \-b
.I size
است رخ می‌دهد) مبهم‌سازی نمی‌شوند. نام‌هایی با طول بین ۵ تا ۸ کاراکتر به‌صورت جزئی مبهم‌سازی می‌شوند.
.PP
دستور
.B xfs_metadump
نمی‌تواند فراداده‌های موجود در گزارش وقایع (log) سیستم‌پرونده را مبهم‌سازی کند. بازیابی لاگ از یک تصویر metadump مبهم‌شده ممکن است فراداده‌های شفاف (متن آشکار) را نمایش دهد یا باعث خرابی سیستم‌پرونده در تصویر بازیابی‌شده شود. توصیه می‌شود در صورت امکان سیستم‌پرونده مبدأ ابتدا سوار و سپس پیاده شود تا از تمیز بودن لاگ اطمینان حاصل گردد. اجرای بعدی
.B xfs_metadump
یک لاگ تمیز را ضبط کرده و تمام فراداده‌ها را به درستی مبهم‌سازی می‌کند.
.PP
اگر ایجاد متادامپ از سیستم‌پرونده‌ای با لاگ ناپاک (dirty) الزامی باشد، توصیه می‌شود در صورتی که فراداده‌هایی مانند نام پرونده‌ها حساس نیستند، مبهم‌سازی با استفاده از گزینه \-o غیرفعال شود. اگر مبهم‌سازی روی متادامپ با لاگ ناپاک مورد نیاز باشد، لطفاً دریافت‌کننده تصویر متادامپ را از این موضوع مطلع سازید.
.PP
محتویات یک دستگاه لاگ خارجی را تنها در صورت استفاده از قالب v2 می‌توان ذخیره کرد.
متادامپ با قالب v2 را می‌توان با ارسال گزینه "\-v 2" تولید کرد.
اگر سیستم‌پرونده دارای یک لاگ خارجی باشد و نگارش متادامپ به طور صریح مشخص نشده باشد، قالب v2 به طور پیش‌فرض تولید می‌شود.
.PP
از
.B xfs_metadump
نباید برای هیچ هدفی غیر از خطایابی و گزارش مشکلات سیستم‌پرونده استفاده شود. رایج‌ترین سناریوی کاربرد این ابزار زمانی است که
.BR xfs_repair (8)
در تعمیر یک سیستم‌پرونده ناموفق باشد و بتوان تصویری از متادامپ را برای تحلیل ارسال کرد.
.PP
پرونده تولیدشده توسط
.B xfs_metadump
را می‌توان با استفاده از ابزار
.BR xfs_mdrestore (8)
به یک تصویر سیستم‌پرونده (منهای داده‌های کاربری) بازیابی کرد.
.PP
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-a
بلوک‌های فراداده را به‌طور کامل کپی می‌کند. در حالت عادی،
.B xfs_metadump
بایت‌های بی‌استفاده باقی‌مانده در میان فراداده‌های فعال را با صفر جایگزین می‌کند. از این گزینه برای کپی کامل بلوک‌های فراداده، جهت ارائه اطلاعات خطایابی بیشتر برای یک سیستم‌پرونده آسیب‌دیده استفاده کنید. توجه داشته باشید که این داده‌های اضافی مبهم‌سازی نخواهند شد.
.TP
.B \-e
با بروز خطای خواندن، عملیات ذخیره‌سازی را متوقف می‌کند. در حالت عادی، خطاهای خواندن نادیده گرفته می‌شوند و تمام فراداده‌های قابل دسترسی کپی خواهند شد.
.TP
.B \-f
مشخص می‌کند که تصویر سیستم‌پرونده مورد پردازش در یک پرونده معمولی ذخیره شده است (گزینه پرونده
.B mkfs.xfs \-d
را ببینید). این حالت همچنین زمانی رخ می‌دهد که یک نسخه تصویر از سیستم‌پرونده توسط
.BR xfs_copy (8)
در یک پرونده معمولی ایجاد شده باشد.
.TP
.B \-F
مشخص می‌کند که عملیات حتی در صورت نادرست بودن شناسه جادویی (magic) سوپربلوک ادامه یابد. اگر مبدأ واقعاً یک سیستم‌پرونده XFS نباشد، تصویر حاصل بی‌فایده خواهد بود و ممکن است xfs_metadump دچار فروپاشی (crash) شود.
.TP
.B \-g
پیشرفت عملیات ذخیره‌سازی را نمایش می‌دهد. اگر
.I target
یک پرونده باشد، این اطلاعات به stdout فرستاده می‌شود و اگر
.I target
برابر با stdout باشد، به stderr فرستاده می‌شود.
.TP
.BI \-l " logdev"
برای سیستم‌پرونده‌هایی که از یک لاگ خارجی استفاده می‌کنند، دستگاه حاوی لاگ خارجی را مشخص می‌کند.
اگر قالب metadump نگارش ۲ انتخاب شده باشد، محتویات لاگ خارجی در متادامپ کپی خواهد شد.
در صورت مشخص شدن این گزینه، قالب v2 metadump به‌طور خودکار انتخاب می‌شود.
.TP
.B \-m
حداکثر اندازه مجاز یک اکستنت (extent) فراداده را تعیین می‌کند. اکستنت‌های فراداده بسیار بزرگ احتمالاً خراب هستند و در صورت تجاوز از این مقدار، نادیده گرفته می‌شوند. اندازه پیش‌فرض 2097151 بلوک است.
.TP
.B \-o
مبهم‌سازی نام پرونده‌ها و ویژگی‌های گسترش‌یافته را غیرفعال می‌کند.
.TP
.BI \-r " rtdev"
برای سیستم‌پرونده‌هایی که بخش بی‌درنگ (realtime) دارند، دستگاه حاوی بخش realtime را مشخص می‌کند.
اگر قالب metadump نگارش ۲ انتخاب شود، سوپربلوک‌های گروه realtime در متادامپ کپی خواهند شد.
اگر سیستم‌پرونده دارای گروه‌های realtime باشد، قالب v2 به‌طور خودکار انتخاب می‌شود.
.TP
.B \-v
قالب پرونده metadump تولیدی را تعیین می‌کند.
مقادیر معتبر ۱ و ۲ هستند.
قالب پیش‌فرض متادامپ ۱ است.
.TP
.B \-w
هشدارهای مربوط به فراداده‌های ناسازگار مشاهده‌شده را در stderr چاپ می‌کند. فراداده‌های آسیب‌دیده همچنان کپی می‌شوند.
.TP
.B \-V
شماره نگارش را چاپ کرده و خارج می‌شود.
.SH "عیب‌یابی (DIAGNOSTICS)"
دستور
.B xfs_metadump
در صورت کپی موفقیت‌آمیز تمام فراداده‌های خواندنی کد خروج ۰ را بازمی‌گرداند؛ و در صورت بروز خطای نوشتن، یا وقوع خطای خواندن در صورت استفاده از گزینه
.BR \-e ،
کد خروج ۱ را برمی‌گرداند.
.SH "نکات (NOTES)"
از آنجا که
.B xfs_metadump
تنها فراداده‌ها را کپی می‌کند، تفاوتی نمی‌کند که سیستم‌پرونده
.I source
دارای بخش بی‌درنگ (realtime) باشد یا خیر. اگر سیستم‌پرونده دارای لاگ خارجی باشد، کپی نمی‌شود. لاگ‌های داخلی کپی می‌شوند و هر تراکنش انجام‌نشده لاگ اگر حاوی نام‌ها باشد، مبهم‌سازی نمی‌شود.
.PP
دستور
.B xfs_metadump
یک پوسته واسط پیرامون دستور
.B metadump
از ابزار
.BR xfs_db (8)
است.
.SH "همچنین ببینید (SEE ALSO)"
.BR xfs_repair (8),
.BR xfs_mdrestore (8),
.BR xfs_freeze (8),
.BR xfs_db (8),
.BR xfs_copy (8),
.BR xfs (5)
.SH "گزارش اشکالات (BUGS)"
گزارش اشکالات را به نشانی
.BR linux-xfs@vger.kernel.org
ارسال کنید.