نام (NAME)

btrfs-heatmap - مصورسازی چیدمان داده‌ها روی سیستم‌فایل btrfs شما

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

btrfs-heatmap [args] mountpoint

توضیحات (DESCRIPTION)

اسکریپت btrfs-heatmap نحوه استفاده یک سیستم‌فایل btrfs از فضای دیسک زیرین در دستگاه‌های بلوکی متصل به آن را به تصویر می‌کشد.

تصویر PNG حاصل، فضای تخصیص‌نیافته دیسک را به صورت پیکسل‌های سیاه نشان می‌دهد. فضای خام دیسک که برای داده‌ها (سفید)، فراداده‌ها (آبی) یا سیستم (قرمز) تخصیص یافته است، با بالاتر رفتن ضریب پر شدن گروه‌های بلوکی روشن‌تر می‌شود.

از آنجا که اطلاعات لازم با استفاده از API هسته btrfs به دست می‌آید، اجرای آن باید با دسترسی ریشه (root) انجام شود.

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

درباره ترتیب داده‌ها در تصویر

به طور پیش‌فرض، ترتیب داده‌ها درون تصویر بر اساس منحنی هیلبرت (Hilbert Curve) است. پایین‌ترین نشانی فیزیکی دستگاه‌های بلوکی در گوشه پایین سمت چپ قرار دارد. از آنجا منحنی به سمت بالا، راست و دوباره به سمت پایین حرکت می‌کند.

به زبان اصطلاحات فنی btrfs...

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

همچنین این امکان وجود دارد که تصویر بر اساس فضای نشانی مجازی btrfs مرتب شود، یا با استفاده از گزینه --blockgroup تصاویری از محتویات گروه‌های بلوکی در سطح extent تولید کرد.

گزینه‌ها (OPTIONS)

-h, --help: نمایش پیام راهنمای توکار و خروج.
--order order: مرتبه منحنی هیلبرت (پیش‌فرض: انتخاب خودکار)
--size size: اندازه تصویر (پیش‌فرض: 10). ارتفاع/عرض برابر است با 2^size
--sort {physical|virtual}: نمایش فضای مصرفی دیسک بر اساس dev_extent (فیزیکی، پیش‌فرض) یا بر اساس chunk/stripe (مجازی).
--blockgroup vaddr: به جای نمای کلی سیستم‌فایل، extentها را در گروه بلوکی که از نشانی مجازی vaddr شروع می‌شود نشان بده.
--curve {hilbert|linear|snake}: نوع منحنی پرکننده فضا یا جایگزین آن. پیش‌فرض hilbert است.
-v, --verbose: افزایش پرگویی خروجی خطایابی. می‌تواند چندین بار برای افزایش بیشتر پرگویی مشخص شود (-v، -vv، -vvv و غیره).
-o, --output {filename|directory|-}: نام فایل یا دایرکتوری PNG خروجی (پیش‌فرض: انتخاب خودکار نام فایل). هنگام استفاده از مقدار ویژه '-' به عنوان فایل، داده‌های png به جای ذخیره در فایلی روی دیسک، در خروجی استاندارد نوشته می‌شوند تا بتوان مستقیماً آن را با یک نمایشگر تصویر (مثلاً با catimg) مشاهده کرد.

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

منبع و مستندات در گیت‌هاب: https://github.com/knorrie/btrfs-heatmap