نام (NAME)

xfs_metadump - استخراج و ذخیره فرادادههای سیستم پرونده XFS در یک پرونده

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

xfs_metadump [ -aefFgow ] [ -m max_extents ] [ -l logdev ] [ -r rtdev ] [ -v version ] source target
xfs_metadump -V

توضیحات (DESCRIPTION)

دستور xfs_metadump فرادادههای یک سیستم پرونده XFS را بدون کپی کردن دادههای کاربری در یک پرونده تصویر ذخیره میکند. آرگومان source باید مسیر فایل یا دستگاه حاوی سیستم‌پرونده XFS باشد و آرگومان target نام پرونده مقصد را مشخص می‌کند. اگر target برابر با - باشد، خروجی به استاندارد خروجی (stdout) فرستاده می‌شود. این امر اجازه می‌دهد که خروجی به برنامه دیگری مانند ابزارهای فشرده‌سازی هدایت شود.

دستور xfs_metadump فقط برای رونوشت‌برداری از سیستم‌پرونده‌های سوارنشده (unmounted) یا سیستم‌پرونده‌های سوارشده به‌صورت فقط‌خواندنی قابل استفاده است.

دستور xfs_metadump به هیچ وجه سیستم‌پرونده مبدأ را تغییر نمی‌دهد. تصویر target یک پرونده پیوسته (non-sparse) است که تمام فراداده‌های سیستم‌پرونده و نمایه‌های مربوط به مکان کپی بلوک‌ها را در خود دارد.

به‌طور پیش‌فرض، xfs_metadump بیشتر نام‌های پرونده‌ها (پرونده‌های معمولی، دایرکتوری‌ها و پیوندهای نمادین) و نام ویژگی‌های گسترش‌یافته را مبهم‌سازی (obfuscate) می‌کند تا بتوان تصاویر ذخیره‌شده را بدون افشای اطلاعات محرمانه ارسال کرد. مقادیر ویژگی‌های گسترش‌یافته با صفر جایگزین شده و هیچ داده‌ای کپی نمی‌شود. تنها موارد استثنا، نام پرونده‌ها یا ویژگی‌هایی با طول ۴ کاراکتر یا کمتر هستند. همچنین نام پرونده‌هایی که در چندین اکستنت امتداد یافته‌اند (این حالت فقط با گزینه‌های mkfs.xfs(8) که در آن -n size > -b size است رخ می‌دهد) مبهم‌سازی نمی‌شوند. نام‌هایی با طول بین ۵ تا ۸ کاراکتر به‌صورت جزئی مبهم‌سازی می‌شوند.

دستور xfs_metadump نمی‌تواند فراداده‌های موجود در گزارش وقایع (log) سیستم‌پرونده را مبهم‌سازی کند. بازیابی لاگ از یک تصویر metadump مبهم‌شده ممکن است فراداده‌های شفاف (متن آشکار) را نمایش دهد یا باعث خرابی سیستم‌پرونده در تصویر بازیابی‌شده شود. توصیه می‌شود در صورت امکان سیستم‌پرونده مبدأ ابتدا سوار و سپس پیاده شود تا از تمیز بودن لاگ اطمینان حاصل گردد. اجرای بعدی xfs_metadump یک لاگ تمیز را ضبط کرده و تمام فراداده‌ها را به درستی مبهم‌سازی می‌کند.

اگر ایجاد متادامپ از سیستم‌پرونده‌ای با لاگ ناپاک (dirty) الزامی باشد، توصیه می‌شود در صورتی که فراداده‌هایی مانند نام پرونده‌ها حساس نیستند، مبهم‌سازی با استفاده از گزینه -o غیرفعال شود. اگر مبهم‌سازی روی متادامپ با لاگ ناپاک مورد نیاز باشد، لطفاً دریافت‌کننده تصویر متادامپ را از این موضوع مطلع سازید.

محتویات یک دستگاه لاگ خارجی را تنها در صورت استفاده از قالب v2 می‌توان ذخیره کرد. متادامپ با قالب v2 را می‌توان با ارسال گزینه "-v 2"; تولید کرد. اگر سیستم‌پرونده دارای یک لاگ خارجی باشد و نگارش متادامپ به طور صریح مشخص نشده باشد، قالب v2 به طور پیش‌فرض تولید می‌شود.

از xfs_metadump نباید برای هیچ هدفی غیر از خطایابی و گزارش مشکلات سیستم‌پرونده استفاده شود. رایج‌ترین سناریوی کاربرد این ابزار زمانی است که xfs_repair(8) در تعمیر یک سیستم‌پرونده ناموفق باشد و بتوان تصویری از متادامپ را برای تحلیل ارسال کرد.

پرونده تولیدشده توسط xfs_metadump را می‌توان با استفاده از ابزار xfs_mdrestore(8) به یک تصویر سیستم‌پرونده (منهای داده‌های کاربری) بازیابی کرد.

گزینه‌ها (OPTIONS)

-a

بلوک‌های فراداده را به‌طور کامل کپی می‌کند. در حالت عادی، xfs_metadump بایت‌های بی‌استفاده باقی‌مانده در میان فراداده‌های فعال را با صفر جایگزین می‌کند. از این گزینه برای کپی کامل بلوک‌های فراداده، جهت ارائه اطلاعات خطایابی بیشتر برای یک سیستم‌پرونده آسیب‌دیده استفاده کنید. توجه داشته باشید که این داده‌های اضافی مبهم‌سازی نخواهند شد.

-e

با بروز خطای خواندن، عملیات ذخیره‌سازی را متوقف می‌کند. در حالت عادی، خطاهای خواندن نادیده گرفته می‌شوند و تمام فراداده‌های قابل دسترسی کپی خواهند شد.

-f

مشخص می‌کند که تصویر سیستم‌پرونده مورد پردازش در یک پرونده معمولی ذخیره شده است (گزینه پرونده mkfs.xfs -d را ببینید). این حالت همچنین زمانی رخ می‌دهد که یک نسخه تصویر از سیستم‌پرونده توسط xfs_copy(8) در یک پرونده معمولی ایجاد شده باشد.

-F

مشخص می‌کند که عملیات حتی در صورت نادرست بودن شناسه جادویی (magic) سوپربلوک ادامه یابد. اگر مبدأ واقعاً یک سیستم‌پرونده XFS نباشد، تصویر حاصل بی‌فایده خواهد بود و ممکن است xfs_metadump دچار فروپاشی (crash) شود.

-g

پیشرفت عملیات ذخیره‌سازی را نمایش می‌دهد. اگر target یک پرونده باشد، این اطلاعات به stdout فرستاده می‌شود و اگر target برابر با stdout باشد، به stderr فرستاده می‌شود.

-l logdev

برای سیستم‌پرونده‌هایی که از یک لاگ خارجی استفاده می‌کنند، دستگاه حاوی لاگ خارجی را مشخص می‌کند. اگر قالب metadump نگارش ۲ انتخاب شده باشد، محتویات لاگ خارجی در متادامپ کپی خواهد شد. در صورت مشخص شدن این گزینه، قالب v2 metadump به‌طور خودکار انتخاب می‌شود.

-m

حداکثر اندازه مجاز یک اکستنت (extent) فراداده را تعیین می‌کند. اکستنت‌های فراداده بسیار بزرگ احتمالاً خراب هستند و در صورت تجاوز از این مقدار، نادیده گرفته می‌شوند. اندازه پیش‌فرض 2097151 بلوک است.

-o

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

-r rtdev

برای سیستم‌پرونده‌هایی که بخش بی‌درنگ (realtime) دارند، دستگاه حاوی بخش realtime را مشخص می‌کند. اگر قالب metadump نگارش ۲ انتخاب شود، سوپربلوک‌های گروه realtime در متادامپ کپی خواهند شد. اگر سیستم‌پرونده دارای گروه‌های realtime باشد، قالب v2 به‌طور خودکار انتخاب می‌شود.

-v

قالب پرونده metadump تولیدی را تعیین می‌کند. مقادیر معتبر ۱ و ۲ هستند. قالب پیش‌فرض متادامپ ۱ است.

-w

هشدارهای مربوط به فراداده‌های ناسازگار مشاهده‌شده را در stderr چاپ می‌کند. فراداده‌های آسیب‌دیده همچنان کپی می‌شوند.

-V

شماره نگارش را چاپ کرده و خارج می‌شود.

عیب‌یابی (DIAGNOSTICS)

دستور xfs_metadump در صورت کپی موفقیت‌آمیز تمام فراداده‌های خواندنی کد خروج ۰ را بازمی‌گرداند؛ و در صورت بروز خطای نوشتن، یا وقوع خطای خواندن در صورت استفاده از گزینه -e، کد خروج ۱ را برمی‌گرداند.

نکات (NOTES)

از آنجا که xfs_metadump تنها فراداده‌ها را کپی می‌کند، تفاوتی نمی‌کند که سیستم‌پرونده source دارای بخش بی‌درنگ (realtime) باشد یا خیر. اگر سیستم‌پرونده دارای لاگ خارجی باشد، کپی نمی‌شود. لاگ‌های داخلی کپی می‌شوند و هر تراکنش انجام‌نشده لاگ اگر حاوی نام‌ها باشد، مبهم‌سازی نمی‌شود.

دستور xfs_metadump یک پوسته واسط پیرامون دستور metadump از ابزار xfs_db(8) است.

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

xfs_repair(8), xfs_mdrestore(8), xfs_freeze(8), xfs_db(8), xfs_copy(8), xfs(5)

گزارش اشکالات (BUGS)

گزارش اشکالات را به نشانی linux-xfs@vger.kernel.org ارسال کنید.